Diffusion multimédia en continu sur des périphériques à l’aide de la fonctionnalité Lire sur (HTML)
[ Cet article est destiné aux développeurs Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]
La fonctionnalité Lire sur permet aux utilisateurs de diffuser facilement du contenu audio, des vidéos ou des images depuis leur ordinateur vers des périphériques en réseau.
Introduction
Vous pouvez utiliser la fonctionnalité Lire sur pour permettre aux utilisateurs de diffuser facilement du contenu audio, des vidéos ou des images depuis leur ordinateur vers les périphériques de leur réseau domestique. Par exemple, un utilisateur qui visionne une vidéo dans votre application peut la diffuser sur une télévision afin qu’elle puisse être regardée simultanément par d’autres personnes.
La fonctionnalité Lire sur permet de diffuser du contenu audio, des vidéos ou des images sur un récepteur Lire sur certifié.
Lire sur fait partie de l’icône Périphériques. Pour les applications qui contiennent du contenu audio, des vidéos ou des images, l’utilisateur ouvre l’icône Périphériques. L’utilisateur se voit alors présenter la liste des périphériques de son réseau domestique vers lesquels ils peut diffuser le contenu multimédia.
Utilisation de la fonctionnalité Lire sur dans votre application
Vous pouvez utiliser la fonctionnalité Lire sur pour diffuser du contenu audio ou vidéo, ainsi que des images, dans votre application en implémentant le contrat Lire sur. Pour implémenter le contrat Lire sur dans votre application, inscrivez-vous à l’événement sourceRequested. Pour vous inscrire à l’événement sourceRequested, obtenez une référence à l’objet PlayToManager actuel en appelant la méthode getForCurrentView. Vous pouvez ensuite appeler addEventHandler sur l’objet PlayToManager pour associer votre gestionnaire d’événements à l’événement sourceRequested. Dans votre gestionnaire des événements, passez l’élément multimédia de votre application à la méthode setSource de l’objet PlayToSourceRequestedEventArgs passé au gestionnaire des événements, comme indiqué dans l’exemple suivant.
// Play To Contract
private Windows.Media.PlayTo.PlayToManager ptm =
Windows.Media.PlayTo.PlayToManager.GetForCurrentView();
protected override void OnNavigatedTo(NavigationEventArgs e)
{
ptm.SourceRequested += sourceRequestHandler;
}
private void sourceRequestHandler(
Windows.Media.PlayTo.PlayToManager sender,
Windows.Media.PlayTo.PlayToSourceRequestedEventArgs e)
{
try
{
e.SourceRequest.SetSource(mediaElement.PlayToSource);
}
catch (Exception ex)
{
messageBlock.Text += "Exception encountered: " + ex.Message + "\n";
}
}
// 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/>";
}
}
' Play To Contract
Private ptm As Windows.Media.PlayTo.PlayToManager =
Windows.Media.PlayTo.PlayToManager.GetForCurrentView()
Protected Overrides Sub OnNavigatedTo(e As Navigation.NavigationEventArgs)
AddHandler ptm.SourceRequested, AddressOf sourceRequestHandler
End Sub
Private Sub sourceRequestHandler(
sender As Windows.Media.PlayTo.PlayToManager,
e As Windows.Media.PlayTo.PlayToSourceRequestedEventArgs)
Try
e.SourceRequest.SetSource(mediaElement.PlayToSource)
Catch ex As Exception
messageBlock.Text &= "Exception encountered: " & ex.Message & vbCrLf
End Try
End Sub
Lorsqu’un utilisateur sélectionne une cible Lire sur à partir de l’icône Périphériques, la fonctionnalité Lire sur déclenche l’événement sourceRequested. La fonctionnalité Lire sur diffuse ensuite l’élément multimédia passé à la méthode setSource vers le périphérique cible sélectionné par l’utilisateur.
Si la fonctionnalité Lire sur diffuse du contenu multimédia depuis votre application vers un périphérique cible, la fonctionnalité Lire sur continue de diffuser le contenu multimédia vers un périphérique cible même si votre application est déplacée à l’arrière-plan lorsqu’une autre application est active. Pour plus d’informations, voir Lancement, reprise et gestion multitâche.
Comportement par défaut de la fonctionnalité Lire sur
Par défaut, la fonctionnalité Lire sur est activée pour tous les éléments audio et vidéo sur une page d’application. Vous pouvez désactiver ce comportement par défaut dans votre application ou vous pouvez identifier les éléments audio ou vidéo qui ne sont pas disponibles dans le comportement par défaut de la fonctionnalité Lire sur.
Pour désactiver le comportement par défaut de la fonctionnalité Lire sur dans votre application, attribuez à la propriété defaultSourceSelection de l’objet PlayToManager la valeur False.
var ptm = Windows.Media.PlayTo.PlayToManager.getForCurrentView();
ptm.defaultSourceSelection = false;
Pour désactiver le comportement par défaut de la fonctionnalité Lire sur pour un élément audio ou vidéo spécifique, incluez la propriété x-ms-playToDisabled dans le balisage de l’élément.
<video src="http://sample.microsoft.com/video.mp4" x-ms-playToDisabled />
Vous pouvez également désactiver le comportement par défaut de la fonctionnalité Lire sur pour un élément en JavaScript en attribuant à la propriété msPlayToDisabled la valeur True.
Si vous avez plusieurs éléments audio ou vidéo sur une page et que vous voulez identifier le premier élément devant être diffusé par la fonctionnalité Lire sur, vous pouvez inclure la propriété x-ms-playToPrimary dans le balisage de l’élément.
<video src="http://sample.microsoft.com/showvideo.mp4" x-ms-playToPrimary />
Vous pouvez également identifier le premier élément devant être diffusé par la fonctionnalité Lire sur en JavaScript en attribuant à la propriété msPlayToPrimary la valeur True.
Recommandations pour l’utilisation de la fonctionnalité Lire sur dans une application
Si votre application offre aux utilisateurs la possibilité de visionner des vidéos, d’afficher des images ou d’écouter du contenu audio, assurez-vous d’ajouter la fonctionnalité Lire sur dans l’application afin de leur permettre aussi de diffuser leur contenu multimédia sur un périphérique distant.
Veillez à activer l’icône Périphériques dans chaque partie de votre application où l’utilisateur a accès à du contenu audio, des vidéos ou des images.
Assurez-vous que les utilisateurs peuvent continuer à naviguer dans toute votre application après avoir commencé à utiliser la fonctionnalité Lire sur pour diffuser du contenu multimédia sur un périphérique distant. Pour garantir la diffusion multimédia en continu, vous devez vous assurer que le contenu multimédia stocké dans votre application reste dans l’étendue.
Comme la fonctionnalité Lire sur fait partie de l’interface utilisateur Windows, faites en sorte que les utilisateurs n’aient pas besoin d’accéder à une page ou un écran spécifique de votre application pour pouvoir l’utiliser.
Rubriques associées
Démarrage rapide : utilisation de la fonctionnalité Lire sur dans les applications
Démarrage rapide : diffusion d’un diaporama à l’aide de la fonctionnalité Lire sur
Exemples