Objeto Media

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O objeto Media fornece uma maneira de especificar ou recuperar propriedades de um item de mídia, usando as propriedades e métodos a seguir.

O objeto Media dá suporte às propriedades a seguir.

Propriedade	Descrição
Attributecount	Recupera o número de atributos que podem ser consultados e/ou definidos para o item de mídia.
duration	Recupera a duração em segundos do item de mídia atual.
durationString	Recupera um valor String que indica a duração do item de mídia atual no formato HH:MM:SS.
error	Recupera um objeto ErrorItem se o item de mídia tiver uma condição de erro.
imageSourceHeight	Recupera a altura do item de mídia atual em pixels.
imageSourceWidth	Recupera a largura do item de mídia atual em pixels.
Markercount	Recupera o número de marcadores no item de mídia.
name	Especifica ou recupera o nome do item de mídia.
sourceURL	Recupera a URL do item de mídia.

 

O objeto Media dá suporte aos métodos a seguir.

Método	Descrição
getAttributeCountByType	Recupera o número de atributos associados ao nome e ao idioma do atributo especificados.
getAttributeName	Recupera o nome do atributo correspondente ao índice especificado.
getItemInfo	Recupera o valor do atributo especificado para o item de mídia.
getItemInfoByAtom	Recupera o valor do atributo com o número de índice especificado.
getItemInfoByType	Recupera o valor do atributo correspondente ao nome do atributo, ao idioma e ao índice especificados.
getMarkerName	Recupera o nome do marcador no índice especificado.
getMarkerTime	Recupera a hora do marcador no índice especificado.
isIdentical	Recupera um valor que indica se o objeto fornecido é o mesmo que o atual.
isMemberOf	Recupera um valor que indica se o item de mídia especificado é um membro da playlist especificada.
isReadOnlyItem	Recupera um valor que indica se os atributos do item de mídia especificado podem ser editados.
setItemInfo	Define o valor do atributo especificado para o item de mídia.

 

O objeto Media é acessado por meio das propriedades e métodos a seguir.

Objeto	Propriedade ou método
Controles	Currentitem
Jogador	currentMedia, newMedia
Playlist	item

 

Porque é o meio mais comum de acesso, jogador. currentMedia é usado para fins de ilustração nas seções de sintaxe de referência.

Confira também

Referência de modelo de objeto para scripts