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 des contenus à partir d'applications Android sur ces appareils plus grands et plus puissants. En activant ce type de lecture, vous pouvez transformer votre application à un seul appareil et à un seul utilisateur en une expérience partagée qui ravit et inspire plusieurs utilisateurs.
Les API du routeur multimédia Android sont conçues pour permettre l'affichage et la lecture de contenus multimédias sur
des appareils 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 multimédia
peuvent participer au framework en publiant un MediaRouteProvider qui permet à d'autres applications de se connecter et de
lire des contenus multimédias sur les appareils récepteurs. La figure 1 montre comment une application se connecte à un appareil récepteur
via le framework du routeur multimédia.
Figure 1. Présentation de la façon dont les classes de fournisseur de routes multimédias permettent 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 créer votre application en tant qu'émetteur 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 exécutant 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
MediaRouterpour découvrir les appareils de lecture à distance disponibles et y acheminer l'audio et la vidéo. - API MediaRouteProvider
- L'API
MediaRouteProviderdéfinit les fonctionnalités d'un appareil de lecture à distance et le rend visible pour les applications qui utilisent unMediaRouterafin de rechercher d'autres chemins 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 à l'utilisateur de passer facilement d'un appareil à l'autre lorsqu'il change de contexte de visionnage et d'écoute, par exemple lorsqu'il regarde une vidéo dans la cuisine au lieu de sur un téléphone, ou lorsqu'il écoute de l'audio à la maison ou en voiture.
Lorsque vous appuyez sur le bouton de sélection de la route dans une notification multimédia, le sélecteur de sortie s'affiche par défaut avec les choix suivants :
- Le haut-parleur de l'appareil actuel
- Tous les appareils audio Bluetooth connectés
Les applications peuvent également proposer d'autres options en fonction de leurs fonctionnalités, comme Cast.
Les applications peuvent utiliser l'MediaRouter
API pour personnaliser
les choix de routage. Vous pouvez exclure les appareils que vous ne prenez pas en charge (par exemple, en filtrant Chromecast audio uniquement si vous regardez une smart TV Netflix) ou inclure d'autres appareils spéciaux que votre application reconnaît.