Établir le routage entre appareils

Lorsque les utilisateurs connectent leurs téléviseurs, leurs systèmes home cinéma et leurs lecteurs de musique à l'aide de technologies sans fil, ils souhaitent pouvoir lire du contenu à partir d'applications Android sur ces appareils plus grands et plus puissants. En activant ce type de lecture, vous pouvez faire de votre application mono-appareil une expérience partagée qui ravira et inspire plusieurs utilisateurs.

Les API des routeurs multimédias Android sont conçues pour permettre l'affichage et la lecture de contenus multimédias sur des récepteurs distants à l'aide d'une interface utilisateur courante. Les développeurs d'applications qui implémentent une interface MediaRouter peuvent ensuite se connecter au framework et lire du contenu sur les appareils qui participent au framework du routeur multimédia. Les fabricants d'appareils de lecture de contenus multimédias peuvent participer au framework en publiant un MediaRouteProvider qui permet à d'autres applications de se connecter aux appareils récepteurs et de les lire. La figure 1 illustre comment une application se connecte à un appareil récepteur via le framework de routeur multimédia.

Figure 1 : Présentation de la manière dont les classes de fournisseur de routages multimédias fournissent la communication entre une application multimédia et un appareil récepteur.

Remarque:Si vous souhaitez que votre application soit compatible avec les appareils Google Cast, vous devez utiliser le SDK Cast et compiler votre application en tant qu'expéditeur Cast. Suivez les instructions de la documentation Cast au lieu d'utiliser directement le framework MediaRouter.

Bibliothèque Support MediaRouter

Les API MediaRouter sont définies dans la bibliothèque AndroidX MediaRouter. Cette bibliothèque est compatible avec les appareils équipés d'Android 2.3 (niveau d'API 9) ou version ultérieure et garantit une expérience cohérente sur tous ces appareils. Pour en savoir plus sur les API MediaRouter, consultez le package androidx.mediarouter.media dans la documentation de référence de l'API.

API MediaRouter
Une application multimédia utilise l'API MediaRouter pour détecter les appareils de lecture à distance disponibles et leur acheminer les contenus audio et vidéo.
API MediaRouteProvider
L'API MediaRouteProvider définit les fonctionnalités d'un appareil de lecture à distance et les rend visibles pour les applications qui utilisent un MediaRouter pour rechercher d'autres chemins d'accès multimédias.

Sélecteur de sortie

À partir d'Android 11, les options de routage de votre application s'affichent également dans le lecteur multimédia du système. Cela permet d'offrir à l'utilisateur un parcours fluide lorsqu'il passe d'un appareil à l'autre, car il change de contexte de visionnage et d'écoute (par exemple, pour regarder une vidéo dans la cuisine ou sur un téléphone, ou pour écouter du contenu audio à la maison ou en voiture).

Lorsque vous appuyez sur le bouton de sélection de route dans une notification multimédia, le sélecteur de sortie s'affiche avec les options suivantes par défaut:

  • Haut-parleur de l'appareil actuel
  • Tous les appareils audio Bluetooth connectés

D'autres options peuvent être disponibles pour les applications en fonction de leurs fonctionnalités, par exemple Cast.

Les applications peuvent utiliser l'API MediaRouter pour personnaliser les choix de routage. Vous pouvez exclure les appareils que vous ne prenez pas en charge (par exemple, en filtrant le Chromecast pour l'audio uniquement si vous regardez une smart TV Netflix) ou inclure d'autres appareils spéciaux reconnus par votre application.