Objeto Player
[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 Player é o objeto raiz do controle Reprodutor Multimídia do Windows. Ele dá suporte às propriedades, métodos e eventos listados nas tabelas a seguir.
O objeto Player dá suporte às propriedades a seguir. As propriedades marcadas com um asterisco (*) não são acessíveis às peles.
Propriedade | Descrição |
---|---|
cdromCollection | Recupera o objeto CdromCollection . |
closedCaption | Recupera o objeto ClosedCaption . |
Controles | Recupera o objeto Controls . |
currentMedia | Especifica ou recupera o objeto Media atual. |
currentPlaylist | Especifica ou recupera o objeto Playlist atual. |
Dvd | Recupera o objeto DVD . |
enableContextMenu * | Especifica ou recupera um valor que indica se o menu de contexto deve ser habilitado, que aparece quando o botão direito do mouse é clicado. |
Habilitado * | Especifica ou recupera um valor que indica se o controle Reprodutor Multimídia do Windows está habilitado. |
error | Recupera o objeto Error . |
Fullscreen * | Especifica ou recupera um valor que indica se o conteúdo do vídeo é reproduzido no modo de tela inteira. |
Isonline | Recupera um valor que indica se o usuário está conectado a uma rede. |
isRemote * | Recupera um valor que indica se o controle Reprodutor Multimídia do Windows está em execução no modo remoto. |
mediaCollection | Recupera o objeto MediaCollection . |
network | Recupera o objeto Network . |
openState | Recupera um valor que indica o estado da fonte de conteúdo. |
playerApplication * | Recupera o objeto PlayerApplication quando um controle de Reprodutor Multimídia do Windows remoto está em execução. |
playlistCollection | Recupera o objeto PlaylistCollection . |
playState | Recupera um valor que indica o estado da operação de Reprodutor Multimídia do Windows. |
configurações | Recupera o objeto Settings . |
status | Recupera um valor que indica o status atual de Reprodutor Multimídia do Windows. |
stretchToFit * | Especifica ou recupera um valor que indica se o vídeo será estendido para ajustar o tamanho da exibição de vídeo de controle Reprodutor Multimídia do Windows. |
uiMode * | Especifica ou recupera um valor que indica quais controles são mostrados na interface do usuário quando Reprodutor Multimídia do Windows é inserido em uma página da Web. |
URL | Especifica ou recupera o nome do clipe a ser reproduzido. |
Versioninfo | Recupera um valor String que especifica a versão do Reprodutor Multimídia do Windows. |
windowlessVideo * | Especifica ou recupera um valor que indica se o controle Reprodutor Multimídia do Windows renderiza o vídeo no modo sem janelas. |
* Não acessível para peles.
O objeto Player dá suporte aos métodos a seguir.
Método | Descrição |
---|---|
close | Versões Reprodutor Multimídia do Windows recursos. |
launchURL | Envia uma URL para o navegador padrão do usuário a ser renderizado. |
newMedia | Cria um novo objeto Media . |
newPlaylist | Cria um novo objeto Playlist . |
openPlayer | Abre Reprodutor Multimídia do Windows usando a URL especificada. |
O objeto Player dá suporte aos eventos a seguir. Eventos marcados com um asterisco (*) não podem ser acessados por skins. Para obter informações sobre como lidar com eventos de mouse e teclado em skins, consulte Eventos Externos.
Evento | Descrição |
---|---|
AudioLanguageChange | Ocorre quando a linguagem de áudio atual é alterada. |
de resposta | Ocorre quando o controle Reprodutor Multimídia do Windows começa ou termina o buffer. |
CdromMediaChange | Ocorre quando um CD ou DVD é inserido ou ejetado de uma unidade de CD ou DVD. |
Clique * | Ocorre quando o usuário clica em um botão do mouse. |
CurrentItemChange | Ocorre quando os controles. alterações currentItem . |
CurrentMediaItemAvailable | Ocorre quando um item de metadados gráficos no item de mídia atual fica disponível. |
CurrentPlaylistChange | Ocorre quando algo muda dentro da playlist atual. |
CurrentPlaylistItemAvailable | Ocorre quando o item de playlist atual fica disponível. |
Desconectar | Reservado para uso futuro. |
DomainChange | Ocorre quando o domínio de DVD é alterado. |
Doubleclick * | Ocorre quando o usuário clica duas vezes em um botão do mouse. |
DurationUnitChange | Reservado para uso futuro. |
EndOfStream | Reservado para uso futuro. |
Erro | Ocorre quando o controle Reprodutor Multimídia do Windows tem uma condição de erro. |
Keydown * | Ocorre quando uma tecla é pressionada. |
Keypress * | Ocorre quando uma tecla é pressionada e liberada. |
Keyup * | Ocorre quando uma tecla é liberada. |
MarkerHit | Ocorre quando um marcador é atingido. |
MediaChange | Ocorre quando um item de mídia é alterado. |
MediaCollectionAttributeStringAdded | Ocorre quando um valor de atributo é adicionado à biblioteca. |
MediaCollectionAttributeStringChanged | Ocorre quando um valor de atributo na biblioteca é alterado. |
MediaCollectionAttributeStringRemoved | Ocorre quando um valor de atributo é removido da biblioteca. |
MediaCollectionChange | Ocorre quando a coleção de mídia é alterada. |
MediaCollectionMediaAdded | Ocorre quando um item de mídia é adicionado à biblioteca local. |
MediaCollectionMediaRemoved | Ocorre quando um item de mídia é removido da biblioteca local. |
MediaError | Ocorre quando o objeto Media tem uma condição de erro. |
ModeChange | Ocorre quando um modo de Reprodutor Multimídia do Windows é alterado. |
Mousedown * | Ocorre quando um botão do mouse é pressionado. |
Mousemove * | Ocorre quando o ponteiro do mouse é movido. |
Mouseup * | Ocorre quando um botão do mouse é liberado. |
NewStream | Reservado para uso futuro. |
OpenPlaylistSwitch | Ocorre quando um título em um DVD começa a ser reproduzido. |
OpenStateChange | Ocorre quando o controle Reprodutor Multimídia do Windows altera o estado. |
PlaylistChange | Ocorre quando uma playlist é alterada. |
PlaylistCollectionChange | Ocorre quando algo é alterado na coleção de playlists. |
PlaylistCollectionPlaylistAdded | Ocorre quando uma playlist é adicionada à coleção de playlists. |
PlaylistCollectionPlaylistRemoved | Ocorre quando uma playlist é removida da coleção de playlists. |
PlaylistCollectionPlaylistSetAsDeleted | Reservado para uso futuro. |
PlayStateChange | Ocorre quando o estado de reprodução do controle Reprodutor Multimídia do Windows é alterado. |
PositionChange | Ocorre quando a posição atual do item de mídia foi alterada. |
ScriptCommand | Ocorre quando um comando ou URL sincronizado é recebido. |
StatusChange | Ocorre quando a propriedade status altera o valor. |
StringCollectionChange | Ocorre quando uma coleção de cadeias de caracteres é alterada. |
Aviso | Reservado para uso futuro. |
* Não acessível a peles. Para obter informações sobre como manipular eventos de mouse e teclado em capas, consulte Manipuladores de eventos ambientes.
Quando inserido em uma página da Web, o objeto Player pode ser acessado usando o valor de ID especificado na marca OBJECT. Em um arquivo de definição de capa, ele é acessado usando o atributo global do player . Para fins de ilustração, o player será usado como a ID do objeto nas seções de sintaxe de referência.
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de