Idioma: HTML | XAML

Transmitindo mídia para dispositivos usando Reproduzir em (HTML)

Applies to Windows only

Reproduzir em permite que usuários transfiram áudio, vídeo ou imagens facilmente do seu computador para dispositivos em rede.

Introdução

Você pode usar Reproduzir em para permitir que os usuários transmitam áudio, vídeo ou imagens com facilidade de seus computadores para dispositivos eu suas redes domésticas. Por exemplo, um usuário que está assistindo um vídeo no seu aplicativo pode transferir esse vídeo para a sua TV para que todos que estão na sala assistam também.

Reproduzir em transfere áudio, vídeo ou imagens para um receptor Reproduzir em certificado.

Reproduzir em é parte do símbolo do evento Devices. Para aplicações que contêm áudio, vídeo ou imagens, o usuário abre o símbolo do evento Devices e visualiza os dispositivos da rede doméstica para os quais o conteúdo de mídia pode ser transmitido.

Usando Reproduzir em no seu aplicativo

Você pode usar Reproduzir em para transmitir o áudio ou vídeo do seu aplicativo, assim como imagens, implementando o contrato de Reproduzir em. Para implementar o contrato de Reproduzir em no seu aplicativo, registre o evento sourceRequested. Para registrar o evento sourceRequested, obtenha uma referência do PlayToManager atual chamando o método getForCurrentView. Em seguida, você pode chamar addEventHandler no PlayToManager para associar o seu manipulador de eventos ao evento sourceRequested. No seu manipulador de eventos, passe o elemento de mídia do seu aplicativo para o método setSource do objeto PlayToSourceRequestedEventArgs passado para o manipulador de eventos, conforme mostra o exemplo a seguir.


// Play To Contract

var ptm = Windows.Media.PlayTo.PlayToManager.getForCurrentView();
ptm.addEventListener("sourcerequested", sourceRequestHandler, false);

function sourceRequestHandler(e) {
    try {
        e.sourceRequest.setSource(mediaElement.msPlayToSource);

    } catch (ex) {
        id("messageDiv").innerHTML += "Exception encountered: " + ex.message + "<br/>";
    }
}


Quando o usuário seleciona um destino para Reproduzir em do símbolo do evento Devices, Reproduzir em ergue o evento sourceRequested. Então, Reproduzir em transmite o elemento de mídia passado ao método setSource para o dispositivo de destino selecionado pelo usuário.

Se Reproduzir em estiver transmitindo mídia do seu aplicativo para um dispositivo de destino, Reproduzir em continuará transmitindo a mídia do seu aplicativo para o dispositivo de destino mesmo que o seu aplicativo seja movido para o tela de fundo enquanto outro aplicativo está ativo. Para saber mais, veja Iniciando, retomando e executando multitarefas.

Comportamento padrão de Reproduzir em

Por padrão, Reproduzir em está habilitado para todos os elementos de áudio e vídeo da página de um aplicativo. Você pode desabilitar esse comportamento padrão no seu aplicativo, ou você pode identificar quais elementos de áudio ou vídeo não estão disponíveis para o comportamento padrão de Reproduzir em.

Para desabilitar o comportamento padrão de Reproduzir em no seu aplicativo, defina a propriedade defaultSourceSelection do objeto PlayToManager como false.


var ptm = Windows.Media.PlayTo.PlayToManager.getForCurrentView();
ptm.defaultSourceSelection = false;


Para desabilitar o comportamento padrão de Reproduzir em para um elemento específico de áudio ou vídeo, inclua a propriedade x-ms-playToDisabled na marcação do elemento.


<video src="http://sample.microsoft.com/video.mp4" x-ms-playToDisabled />

Você também pode desabilitar o comportamento padrão de Reproduzir em para um elemento em JavaScript definindo a propriedade msPlayToDisabled como true.

Se você possui mais de um elemento de áudio ou vídeo em uma página e quer identificar o primeiro elemento para transmissão via Reproduzir em, você pode incluir a propriedade x-ms-playToPrimary na marcação do elemento.


<video src="http://sample.microsoft.com/showvideo.mp4" x-ms-playToPrimary />

Você também pode identificar o primeiro elemento para transmissão via Reproduzir em JavaScript definindo a propriedade msPlayToPrimary como true.

Diretrizes para o uso de Reproduzir em em um aplicativo

Caso o seu aplicativo permita que os usuários visualizem vídeos ou imagens, ou mesmo que escutem áudio, certifique-se de incluir a funcionalidade de Reproduzir em no seu aplicativo para também permitir que os usuários transmitam a mídia para um dispositivo remoto.

Certifique-se de habilitar o botão Devices no seu aplicativo sempre que você tiver conteúdo de áudio, vídeo ou imagens disponível para o usuário.

Certifique-se de que os usuários podem continuar navegando no seu aplicativo uma vez iniciada a transmissão de mídia para um dispositivo remoto usando Reproduzir em. Para manter a transmissão de mídia, primeiro, você precisa se certificar de que o elemento de mídia do seu aplicativo permanece no escopo.

Como Reproduzir em faz parte da interface do usuário do Windows, não exija que os usuários naveguem até uma parte específica do seu aplicativo para usar Reproduzir em.

Tópicos relacionados

Guia de início rápido: usando Reproduzir em em aplicações
Guia de início rápido: transmitir uma apresentação de slides usando Executar em
Amostras
Amostra Reproduzir em
Amostra Reproduzir em receptor
Amostra do Servidor de mídia

 

 

Mostrar:
© 2014 Microsoft