Idioma: HTML | XAML

Transmisión multimedia a dispositivos mediante Reproducir en (HTML)

Reproducir en permite que los usuarios transmitan fácilmente audio, vídeo o imágenes desde sus equipos a dispositivos en red.

Presentación

Puedes usar Reproducir en para permitir que los usuarios transmitan fácilmente audio, vídeo o imágenes desde su equipo a los dispositivos de su red doméstica. Por ejemplo, un usuario que está viendo un vídeo en la aplicación, puede transmitir dicho vídeo a su televisión para que lo vean todos los que estén en la sala.

Reproducir en transmite audio, vídeo o imágenes a un receptor Reproducir en certificado.

Reproducir en es parte del botón de acceso Dispositivos. En las aplicaciones que contienen audio, vídeo o imágenes, el usuario puede presionar el botón de acceso Dispositivos para ver desde su red doméstica los dispositivos a los que puede transmitir el contenido multimedia.

Uso de Reproducir en en la aplicación

Para usar Reproducir en para transmitir el audio o vídeo de la aplicación, así como las imágenes, implementa el contrato de Reproducir en. Para implementar el contrato de Reproducir en en la aplicación, regístrate para el evento sourceRequested. Para registrarte para el evento sourceRequested, obtén una referencia al PlayToManager actual llamando al método getForCurrentView. Después puedes llamar a addEventHandler en PlayToManager para asociar el controlador de eventos con el evento sourceRequested. En el controlador de eventos, pasa el elemento multimedia de la aplicación al método setSource del objeto PlayToSourceRequestedEventArgs que se pasó al controlador de eventos, como se aprecia en el siguiente ejemplo.


// 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/>";
    }
}


Cuando un usuario selecciona un destino para Reproducir en del botón de acceso Dispositivos, Reproducir en genera el evento sourceRequested. Después, Reproducir en transmite el elemento multimedia que se pasó al método setSource al dispositivo de destino que seleccionó el usuario.

Si Reproducir en está transmitiendo recursos multimedia desde la aplicación a un dispositivo de destino, continuará haciéndolo, incluso si tu aplicación se mueve a un segundo plano mientras otra aplicación está activa. Si quieres obtener más información, consulta el tema sobre Inicio, reanudación y multitarea.

Comportamiento predeterminado de Reproducir en

De manera predeterminada, Reproducir en está habilitado para todos los elementos de audio y vídeo de una página de aplicación. Puedes deshabilitar este comportamiento predeterminado en la aplicación o identificar los elementos de audio o vídeo que no estarán disponibles para dicho comportamiento de Reproducir en.

Para deshabilitar el comportamiento predeterminado de Reproducir en en la aplicación, establece la propiedad defaultSourceSelection del objeto PlayToManager en false.


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


Para deshabilitar el comportamiento predeterminado de Reproducir en para un elemento de audio o vídeo, incluye la propiedad x-ms-playToDisabled en el marcado del elemento.


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

También puedes deshabilitar el comportamiento predeterminado de Reproducir en para un elemento en JavaScript al establecer la propiedad msPlayToDisabled en true.

Si tienes más de un elemento de audio o vídeo en una página y deseas identificar uno de ellos como el primero que debe transmitir Reproducir en, puedes incluir la propiedad x-ms-playToPrimary en el marcado del elemento.


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

También puedes identificar el primer elemento que deseas que Reproducir en reproduzca en JavaScript si estableces la propiedad msPlayToPrimary en true.

Directrices para el uso de Reproducir en en una aplicación

Si la aplicación permite a los usuarios ver vídeo o imágenes, o escuchar audio, asegúrate de incluir la funcionalidad de Reproducir en para permitir también que los usuarios transmitan los recursos multimedia a un dispositivo remoto.

Asegúrate de habilitar el botón de acceso Dispositivos en la aplicación si tienes contenido de audio, vídeo o imagen disponible para el usuario.

Asegúrate de que los usuarios puedan continuar navegando a través de la aplicación una vez que hayan comenzado a transmitir recursos multimedia a un dispositivo remoto mediante Reproducir en. Para continuar transmitiendo los recursos multimedia, debes asegurarte de que el elemento multimedia de la aplicación permanezca dentro del ámbito.

Debido a que Reproducir en es parte de la interfaz de usuario de Windows, no debes pedir a los usuarios que naveguen a una página o pantalla específica de la aplicación para poder usar Reproducir en.

Temas relacionados

Inicio rápido: usar Reproducir en en aplicaciones
Inicio rápido: transmitir una presentación mediante Reproducir en
Muestras
Ejemplo de Reproducir en
Muestra de PlayToReceiver
Ejemplo de servidor multimedia

 

 

Mostrar:
© 2015 Microsoft