Appareils audio

Google Cast pour appareils audio n'est compatible qu'avec la lecture audio. Ce guide décrit comment optimiser les applications Cast pour les appareils audio uniquement la réduction de la demande d'utilisation de la mémoire, du processeur et de la bande passante réseau.

Une application compatible avec Google Cast pour l'audio doit respecter les exigences suivantes : à prendre en compte:

  • Google Cast pour appareils audio n'affiche pas les vidéos ni les images. Toutefois, De nombreux appareils audio sont dotés d'un écran permettant d'afficher les métadonnées, comme la lecture l'état (en cours de lecture ou en pause) et la progression. Votre application ne doit pas afficher ces informations utilisateur critiques uniquement sur le récepteur ; des informations critiques, et la majeure partie de l'interface utilisateur, doivent être affichées sur l'expéditeur.
  • Pour exécuter correctement les applications Web Receiver, Google Cast pour les appareils audio doivent quand même effectuer le rendu des graphismes, même s'ils ne sont pas affichés. Depuis peuvent ne pas prendre en charge les opérations graphiques avec accélération matérielle, les applications réceptrices doivent éviter d'utiliser des opérations graphiques lourdes. comme les dégradés de couleurs, la rotation, le mélange alpha et le redessin des objets tels que les barres de progression plus d'une fois par seconde.
  • Google Cast pour les appareils audio n'est compatible qu'avec Widevine for Digital Rights du contenu protégé par la gestion des droits numériques (DRM).
  • Pour la plupart des appareils Google Cast pour audio, l'application émettrice contrôle à toute la plage de volume de l'appareil (par exemple, un haut-parleur), et pas seulement le volume de l'entrée de la source audio sur le téléviseur, comme sur un Chromecast.
  • En plus de contrôler la lecture avec l'appareil émetteur (un téléphone, pour par exemple), il se peut que l'application doive permettre de contrôler la lecture avec des manettes de votre appareil, comme une télécommande, des boutons sur l'appareil ou une application distante externe.
  • Un appareil Google Cast pour audio peut être compatible avec l'affichage de métadonnées de contenu avec un petit écran LCD et une sortie HDMI (pour les barres de son ou ou une application distante externe, selon le type de l'appareil.

Développement

La première étape du développement d'une application Cast compatible avec Google Cast pour l'audio est de développer une application Cast pour l'audio/vidéo et de s'assurer qu'elle s'exécute sur un Chromecast. Dans ce document, nous partons du principe que vous avez développé et testé une telle application.

Une application peut être compatible avec les appareils audio-vidéo et audio uniquement. Il doit savoir en cas de diffusion vers l'un plutôt que vers l'autre, et prenez des mesures pour garantir la meilleure expérience l’expérience utilisateur dans le scénario donné.

Par exemple, des applications doubles vidéo et audio (comme la lecture de fichiers locaux/NAS). applications) doivent permettre de caster des contenus sur des appareils audio uniquement lit des fichiers audio, mais l'application ne doit pas permettre à l'utilisateur d'envoyer des fichiers vidéo à l'appareil audio uniquement. L'application peut utiliser API de fonctionnalités de l'appareil pour les expéditeurs décrites ci-dessous afin de déterminer le contenu approprié pour l'appareil.

Pour que votre application soit compatible avec Google Cast pour l'audio, elle doit remplir les conditions suivantes:

  • Prise en charge de l'audio uniquement: streaming de musique et de fichiers audio, radio, etc. Le contenu multimédia diffusées vers l'application Web Receiver ne doit pas être un flux vidéo. En outre, évitez Streaming de graphismes et d'images pour améliorer le temps de lancement de l'application et l'utilisation de la mémoire. Consultez la section Consignes concernant l'utilisation de la mémoire ci-dessous.

  • Fonctionne comme prévu sur un appareil Cast pour audio et sur un Chromecast standard.

Fonctionnalités de l'appareil

Votre application peut savoir si elle s'exécute sur un appareil audio uniquement API de fonctionnalités de l'appareil, disponibles sur l'appareil lui-même ou via l'émetteur ou de récepteur.

En-tête HTTP de l'appareil

En-tête HTTP CAST-DEVICE-CAPABILITIES fourni par l'appareil Cast lors de la le lancement de l'application décrit les fonctionnalités de l'appareil. L'appareil envoie une requête avec cet en-tête au serveur hébergeant l'application Web Receiver. L'en-tête d'une appareil audio uniquement décrit ses fonctionnalités avec CAST-DEVICE-CAPABILITIES: {"display_supported":false}

Lorsque votre serveur reçoit la requête de l'appareil, vous pouvez utiliser la méthode informations dans cet en-tête pour rediriger la requête vers l'application Web Receiver qui est optimisé pour les appareils audio.

API Web Receiver

Vous pouvez obtenir le même objet de fonctionnalités de l'appareil en appelant CastReceiverManager.getDeviceCapabilities() lors du chargement de l'application Web Receiver.

Pour en savoir plus, consultez Fonctionnalités de l'appareil. des informations.

API Sender

Chacune des API émettrices Cast contient également des informations sur les fonctionnalités de l'appareil. Celles-ci permettent à l'application émettrice de déterminer le type de contenu multimédia à envoyer au destinataire. Si votre application prend en charge à la fois l'audio et la vidéo, elle peut éviter d'envoyer du contenu vidéo à appareils audio uniquement. De plus, votre application peut contrôler le volume à l'aide de la méthode adaptée à l'appareil, comme décrit dans la checklist de conception. Consultez les API de fonctionnalités de l'appareil suivantes pour les expéditeurs:

Consignes concernant l'utilisation de la mémoire

Les applications Web Receiver exécutées sur des appareils audio doivent gérer l'utilisation de la mémoire comme suit:

  • Évitez de télécharger ou d'utiliser des images ou des éléments graphiques afin de réduire la mémoire. et raccourcir le délai avant le début de la lecture.
  • Lorsque vous utilisez Media Source Extensions (MSE), les applications doivent limiter le flux à 2 Mo. Si vous utilisez la bibliothèque MPL (Media Player Library), le service la taille de la mémoire tampon du flux est déjà définie par MPL.
  • Lorsque vous utilisez HTMLMediaElement, la taille de la mémoire tampon du flux de l'application est définie par Chrome en fonction du débit de streaming. Limite le débit audio à 2 mégabits par qui est compatible avec tous les codecs décrits Contenus multimédias compatibles (jusqu'à 48 kHz/16 bits).

Réglage du volume

Pour la plupart des appareils Google Cast pour audio, l'application émettrice contrôle de l'appareil, pas seulement le volume d'entrée de la source audio, comme Chromecast. Cela signifie que les incréments de changement de volume doivent être plus petits pour des applications audio uniquement. Consultez les documents suivants pour savoir comment fournir pour régler le volume dans votre application:

Commandes des appareils

Google Cast pour les appareils audio peut disposer de ses propres commandes de lecture (comme boutons, télécommandes, etc.). Ceux-ci utilisent les messages de lecture multimédia définis pour Espace de noms urn:x-cast:com.google.cast.media, comme décrit dans Messages de lecture des contenus multimédias, pour contrôler la lecture sur l'application réceptrice. L'application réceptrice doit prendre en charge ces messages de lecture multimédia pour prendre en charge les commandes de lecture de l'appareil.

Elle doit également être compatible avec les messages du destinataire à l'expéditeur. Ainsi, si l'utilisateur modifie l'état du contenu multimédia à l'aide des commandes de contrôle des appareils, L'application émettrice peut recevoir un message d'état du destinataire et mettre à jour l'UI en conséquence.

Écran de l'appareil

Les appareils Google Cast pour audio peuvent être dotés d'un écran LCD ou une application de contrôle spécifique à l'appareil qui affiche les métadonnées multimédias. Votre récepteur L'application doit fournir ces métadonnées pour toutes les pistes audio et s'assurer qu'elles sont synchronisées avec le contenu en cours de lecture pour que les métadonnées s'affichent correctement sur l'écran. Si l'application utilise des métadonnées personnalisées, vous devez également fournir les métadonnées audio standards (nom du titre, nom de l'artiste et album) titre, etc.) comme décrit ci-dessous pour chaque plate-forme.

Le destinataire reçoit les métadonnées de l'expéditeur lorsqu'il charge le contenu multimédia. Dans votre application émettrice, avec la commande permettant de charger le contenu multimédia sur le récepteur, vous devez spécifiez les champs décrits ci-dessous pour que les métadonnées s'affichent sur la Google Cast pour appareil audio Utilisez les API suivantes:

Si l'application Cast gère une file d'attente multimédia sur le récepteur ou dans le cloud, Web Receiver doit diffuser toutes les mises à jour de l'état du média à l'aide des urn:x-cast:com.google.cast.media afin que tous les expéditeurs synchronisé.

Inscription

Vous devez enregistrer votre appareil Google Cast pour audio à des fins de test et d'enregistrement. votre application afin qu'elle soit compatible avec Google Cast pour les appareils audio. Console développeur du SDK Google Cast

  • Pour en savoir plus, consultez la section Appareils. sur l'enregistrement d'appareils.
  • Vous devez cocher la case Compatible avec la diffusion sur des appareils audio uniquement lorsque enregistrement de votre application afin de permettre à celle-ci de découvrir Google Cast pour appareils audio. Consultez la section Enregistrer votre application.

Pour les applications non publiées, telles que celles utilisées à des fins de test, vous devez également sélectionner compatible avec les appareils en mode audio uniquement, afin que l'application détecte appareils audio uniquement.

Google Cast pour audio 2.0

Google Cast for Audio (GC4A) 2.0 est la plate-forme audio Cast nouvelle génération conçue pour cibler les appareils à faible mémoire, étendre l'écosystème d'appareils peuvent diffuser votre contenu en streaming. Étant donné que GC4A 2.0 cible les plates-formes audio, l'API Web est réduite pour s'aligner sur les appareils sans écran. Déploiement de GC4A 2.0 dans les nouvelles et les haut-parleurs existants compatibles avec la diffusion.

Tester et déboguer

Étant donné que toutes les enceintes compatibles passeront à GC4A 2.0, il est important que les développeurs d'applications audio testent leurs applications sur GC4A 2.0. Vous pouvez tester votre application Cast pour GC4A 2.0 sur des enceintes Wi-Fi Bose de production, JBL Charge 5 Wi-Fi, JBL Authentics, Cambridge Audio, Teuful Motiv Home, barres de son LG 2024.

GC4A 2.0 n'est pas compatible avec le débogueur à distance de Chrome. Si vous souhaitez déboguer l'application, Google vous recommande d'utiliser l'outil Cast Debug Logger.

Nous vous recommandons de tester toutes les fonctionnalités de l'application sur GC4A 2.0. Veillez à inclure les tests de lecture de tous les types de contenus multimédias (podcasts, diffusions, etc.), de mise en pause, sauter, changer de playlist, arrêter et reconnecter Cast.

API compatibles

GC4A 2.0 est compatible avec les API suivantes:

  • HTML
  • JavaScript ECMA 6
  • DOMParser
  • XMLSerializer
  • Document et sous-classes
  • DocumentFragment
  • HTMLMediaElement & HTMLAudioElement
  • HTMLVideoElement (lecture du contenu audio uniquement)
  • HTMLScriptElement
  • HTMLBaseElement
  • HTMLTemplateElement
  • Éléments personnalisés
  • Shadow DOM
  • Modules de script / asynchrones / différés
  • Fetch / XHR
  • WebSocket
  • MessagePort
  • Cookies
  • MSE (Media Source Extensions)
  • EME (Encrypted Media Extensions)
  • Stockage local / de session

GC4A 2.0 n'est pas compatible avec les fonctionnalités suivantes:

  • Importation de modules dynamiques (ajoutée en 2024)
  • CSS
  • IFrame
  • TextTracks

Contact

Veuillez contacter gc4a-support-external@google.com si vous avez besoin d'aide pour effectuer un test, ou vous ne parvenez pas à utiliser une enceinte Bose.