Applications multimédias qui interagissent par commande vocale avec l'Assistant Google sur les téléphones Android les voitures, les téléviseurs et les casques sont équipés d'API Android Media Session et utilisent des actions multimédias. Le cycle de vie des actions multimédias peut être difficile à suivre. Vous pouvez même jouer avec la recherche comporte de nombreuses étapes intermédiaires au cours desquelles un problème peut survenir, comme illustré dans le calendrier simplifié:
Media Controller Test (MCT) vous permet de tester les subtilités de la lecture multimédia sur Android et vous aide et vérifiez la mise en œuvre de votre session multimédia.
Le MCT affiche des informations sur le MediaController
de votre application, comme
PlaybackState
et les métadonnées. Vous pouvez les utiliser pour tester les commandes multimédias interapplis.
Le MCT inclut également un test de validation
de référence qui
vous permet d'automatiser le contrôle qualité.
Pour utiliser le MCT, votre application doit disposer d'un service de navigateur multimédia et vous devez autoriser le MCT à s'y connecter. Voir Créer un service de navigateur multimédia pour en savoir plus.
Démarrer le MCT
![Page de lancement de MCT](https://developer.android.com/static/media/images/MCT/MCT-Launch-Screen.png?authuser=19&hl=fr)
Lorsque vous lancez MCT, deux listes s'affichent:
- Active MediaSessions : cette liste est initialement vide lorsque vous lancez le MCT. Le message suivant s'affiche : "Aucune application multimédia trouvée. Notification L'autorisation "Écouteur" est requise pour rechercher les sessions multimédias actives." Cliquez sur Paramètres pour accédez à l'écran des autorisations et activez l'autorisation pour le MCT.
- Implémentations de MediaBrowserService : cette liste présente les applications qui ont mis en œuvre un service de navigateur multimédia. Si vous avez implémenté un service de navigateur multimédia, votre application apparaît dans cette liste, Toutefois, vous ne pouvez utiliser le MCT que si vous avez configuré votre application pour qu'elle accepte ou ajouté le MCT à la liste d'autorisation. Consultez la page Contrôler les connexions client avec onGetRoot() pour en savoir plus.
Tester manuellement une application pour téléphone
Si vous avez autorisé le MCT à se connecter au service de navigateur multimédia de votre application, votre application figure dans la liste des implémentations de la liste des services de navigateur multimédia. Retrouvez-le sur cette page puis cliquez sur Ctrl pour lancer votre application en arrière-plan.
Sinon, vous devez d'abord démarrer votre application en arrière-plan, puis cliquer sur Contrôle lorsqu'il apparaît dans la liste des sessions multimédias actives.
Test : préparez-vous et jouez
Lorsque le MCT commence à contrôler votre application, il affiche la session actuelle de l'application Métadonnées: le contenu multimédia actuellement sélectionné et les actions de la session à gérer.
![Page de contrôle](https://developer.android.com/static/media/images/MCT/audio-focus.png?authuser=19&hl=fr)
Dans le menu déroulant situé en haut de la page "Commandes MCT", sélectionnez Search, URI, Media ID ou None (Aucun), ainsi qu'un champ de texte pour spécifier les données d'entrée associées à la recherche, à l'URI ou à l'ID média si vous sélectionnez l'une de ces options.
Les boutons Prepare (Préparer) et Play (Lecture) juste en dessous du champ de texte permettent
les appels appropriés (onPrepare()
, onPrepareFromSearch()
, onPrepareFromUri()
,
onPrepareFromMediaId()
, onPlay()
, onPlayFromSearch()
, onPlayFromUri()
onPlayFromMediaId()
) en fonction de l'action que vous avez sélectionnée.
Tester la priorité audio
Une application multimédia performante doit pouvoir gérer l'audio sélection. Vous pouvez tester la priorité audio en exécutant une autre application audio en parallèle de votre application. La page des contrôles du MCT inclut qui demande et libère la priorité audio.
Pour tester la priorité audio, procédez comme suit:
- Utilisez le menu déroulant Focus audio pour sélectionner l'une des trois indications de durée.
AUDIOFOCUS_GAIN
,AUDIOFOCUS_GAIN_TRANSIENT
ouAUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
. - Appuyez sur le bouton pour demander la sélection.
- Appuyez de nouveau sur le bouton pour libérer la sélection.
Tester les commandes de transport
![Tester Transport Controls](https://developer.android.com/static/media/images/MCT/MCT-Controller-Screen.png?authuser=19&hl=fr)
Balayez l'écran vers la gauche pour afficher la vue de l'interface utilisateur du MCT. Cette vue dispose des boutons de transport standards du contrôleur multimédia et affiche l'état l'image et les données du programme. Les boutons de transport désactivés sont entourés d'un cercle. orange. Tous les autres sont actifs.
Testez votre lecteur à l'aide des boutons de transport. État des boutons de transport doit changer comme prévu. Par exemple, lorsque vous appuyez sur le bouton LECTURE, doivent être désactivées, et les boutons PAUSE et ARRÊT sont activés.
Balayez à nouveau l'écran vers la gauche pour afficher les actions facultatives. Chaque action dispose d'une commande qui indique s'il est actif ou non. S'il est actif, vous pouvez effectuer l'action en cliquant dessus.
Si vous vous êtes connecté à partir de la liste des applications disposant d'un service de navigateur multimédia, vous pouvez balayez deux fois de suite l'écran vers la gauche pour accéder aux vues qui vous permettent de parcourir le contenu de votre application. ou effectuer une recherche dans l'arborescence de contenu.
Tester manuellement une application vidéo
Utilisez le mode Écran partagé pour tester les commandes des applications vidéo. Ouvrez votre application vidéo dans une fenêtre, puis ouvrir le MCT en mode Écran partagé.
Exécuter des tests de validation
Le framework de tests de validation propose des tests en un clic que vous pouvez exécuter pour vous assurer que votre application multimédia répond correctement à une requête de lecture.
Tester une application pour téléphone
![Bouton "Tester"](https://developer.android.com/static/media/images/MCT/MCT-Test-Button.png?authuser=19&hl=fr)
Pour accéder aux tests de validation, cliquez sur le bouton Test à côté de votre contenu multimédia. l'application.
État du MCT
![État de la commande multimédia](https://developer.android.com/static/media/images/MCT/MCT-Testing-Info-Screen.png?authuser=19&hl=fr)
La vue suivante affiche des informations détaillées sur les MediaController
du MCT,
par exemple PlaybackState
, les métadonnées et la file d'attente. Il y a deux
boutons sur
en haut à droite
de la barre d'outils. Le bouton de gauche permet d'activer ou de désactiver l'analyse.
et des journaux formatés. Le bouton de droite actualise la vue pour afficher
les informations les plus récentes.
Sélectionner un test
![Page de sélection des tests](https://developer.android.com/static/media/images/MCT/MCT-Testing-Verification-Screen.png?authuser=19&hl=fr)
En balayant l'écran vers la gauche, vous accédez à la vue des tests de validation, une liste déroulante des tests disponibles s'affiche. Si un test utilise une requête, par exemple à partir du test de recherche illustré à la figure 7, un champ de texte pour saisir la chaîne de requête.
Le MCT inclut des tests pour les actions multimédias suivantes, et d'autres tests sont continuellement ajouté au projet:
- Lire
- Lire à partir de la recherche
- Lire à partir de l'ID média
- Lire à partir de l'URI
- Mettre en pause
- Arrêter
- Passer au suivant
- Passer au précédent
- Passer à l'élément de la file d'attente
- Aller à
Résultats des tests
![Résultat du test réussi](https://developer.android.com/static/media/images/MCT/MCT-Testing-Success-Screen.png?authuser=19&hl=fr)
Au bas de l'écran, la zone des résultats est initialement vide. Elle affiche lorsque vous exécutez un test. Par exemple, pour exécuter le test de lecture de recherche, saisissez une requête de recherche dans le champ de texte, puis cliquez sur Run Test (Exécuter le test). Les éléments suivants : la capture d'écran montre que le test a réussi.
Tester une application Android TV
Lorsque vous lancez le MCT sur Android TV, la liste des applications multimédias installées s'affiche. Notez qu'une application n'apparaît dans cette liste que si elle intègre un navigateur multimédia. Google Cloud.
La sélection d'une application vous redirige vers l'écran de test, qui affiche une liste de tests de vérification sur la droite.
Lorsque vous exécutez un test, la partie gauche de l'écran affiche des informations sur le MediaController sélectionné. Pour en savoir plus, consultez les journaux MCT dans Logcat.
Les tests qui nécessitent une requête sont signalés par une icône de clavier. En cliquant sur l'une des ces tests ouvre un champ de saisie pour la requête. Cliquez sur Entrée pour exécuter le test.
Pour faciliter la saisie de texte, vous pouvez également utiliser une commande adb
:
adb shell input text your-query
Vous pouvez utiliser "%s" pour ajouter un espace entre les mots. Par exemple : ajoute le texte "hello world" dans le champ de saisie.
adb shell input text hello%sworld
Créer un test
Vous pouvez envoyer une demande d'extraction avec d'autres tests que vous jugez utiles. Pour savoir comment créer des tests, consultez le Wiki GitHub de MCT et consultez les test de validation instructions.
Veuillez consulter les instructions concernant les contributions.
Ressources supplémentaires
Le MCT est destiné à être utilisé avec les applications qui implémentent des API multimédias. Consultez le Lecteur de musique universel Android pour obtenir un exemple d'application.
La correction de bugs et les améliorations sont toujours les bienvenues. Consultez les instructions pour la contribution.