Audiogeräte

Google Cast für Audiogeräte unterstützt nur die Audiowiedergabe. In diesem Leitfaden wird Folgendes beschrieben: wie Sie Cast-Apps für reine Audiogeräte optimieren und die reduzierte Belastung der Speicher-, CPU- und Netzwerkbandbreitenauslastung.

Eine App, die Google Cast für Audio unterstützt, muss folgende Anforderungen erfüllen, Kaufbereitschaft:

  • Google Cast für Audiogeräte zeigen keine Videos oder Grafiken an. Sie können jedoch haben viele Audiogeräte ein Display zum Anzeigen von Metadaten, wie z. B. „Wiedergabe“ oder „Pausiert“ und den Fortschritt. In Ihrer App dürfen keine solche wichtigen Nutzerdaten nur auf dem Empfänger zu übermitteln; wichtige Informationen, und der Großteil der Benutzeroberfläche müssen auf dem Absender angezeigt werden.
  • Damit Web Receiver-Apps ordnungsgemäß ausgeführt werden, muss Google Cast für Audiogeräte müssen Grafiken rendern, auch wenn sie nicht angezeigt werden. Seit unterstützen Geräte möglicherweise keine hardwarebeschleunigte Grafikbearbeitung, In Empfangsanwendungen sollten grafikintensive Vorgänge vermieden werden. wie Farbverläufe, Drehung, Überführung in Alpha-Phasen und Objekte wie Fortschrittsbalken mehr als einmal pro Sekunde.
  • Google Cast für Audiogeräte unterstützt nur Widevine for Digital Rights Verwaltung (DRM-geschützte) Inhalte
  • Bei den meisten Google Cast für Audiogeräte steuert die Absender-App den gesamten Lautstärkebereich des Geräts (z. B. einen Lautsprecher) zu übertragen, nicht nur Lautstärke der Audioquelle, die am Fernseher angeschlossen wird, wie bei Chromecast.
  • Neben der Wiedergabe mit dem Sendergerät (ein Telefon, für kann die App eine Steuerung der Wiedergabe über die Funktion geräteeigenen Controllern, z. B. eine Fernbedienung, Tasten auf dem Gerät oder einer externen Remote-App.
  • Ein Google Cast für Audio-Gerät kann möglicherweise die Anzeige von Inhaltsmetadaten unterstützen. mit kleinem LCD-Bildschirm, HDMI-Ausgang (für Soundbars oder Audio-/Videogeräte) Empfänger) oder eine externe Remote-App verwenden, je nachdem, auf der Benutzeroberfläche des Geräts.

Entwicklung

Der erste Schritt zur Entwicklung einer Cast-App zur Unterstützung von Google Cast für Audio ist die Entwicklung einer Cast-App für Audio/Video. Chromecast In diesem Dokument wird davon ausgegangen, dass Sie eine solche App entwickelt und getestet haben.

Eine App kann sowohl Audio-Video- als auch Audiogeräte unterstützen. Er muss wissen, beim Streamen über einen anderen Bildschirm und es werden Maßnahmen ergriffen, User Experience im jeweiligen Szenario.

Zum Beispiel Apps mit Dual-Video- und Audiofunktion (wie lokale/NAS-Dateiwiedergabe) Apps) sollte das Streamen auf reine Audiogeräte aktivieren, damit Wiedergabe von Audiodateien, aber die App sollte dem Nutzer nicht erlauben, Videodateien zu senden auf das Audiogerät übertragen. Die App kann die APIs für Gerätefunktionen für Absender wie unten beschrieben, um die für das Gerät geeigneten Inhalte zu ermitteln.

Damit Google Cast für Audio unterstützt wird, muss Ihre App die folgenden Anforderungen erfüllen:

  • Nur Audio: Streamen von Musik und Audiodateien, Radio usw. Die Medien die an die Web Receiver App gestreamt werden, darf kein Videostream sein. Vermeiden Sie außerdem Streaming von Grafiken und Bildern, um die Startzeit der App zu verkürzen und Arbeitsspeichernutzung. Weitere Informationen finden Sie unten im Abschnitt Richtlinien zur Arbeitsspeichernutzung.

  • Funktioniert wie erwartet auf einem Cast für Audiogerät und einem normalen Chromecast.

Gerätefunktionen

Anhand der APIs für Gerätefunktionen, die auf dem Gerät selbst oder über den Absender verfügbar sind oder Empfänger-APIs.

HTTP-Header des Geräts

Der HTTP-Header CAST-DEVICE-CAPABILITIES, der während des Vorgangs vom Übertragungsgerät bereitgestellt wird App-Einführung die Gerätefunktionen beschreibt. Das Gerät sendet eine Anfrage mit diesem Header an den Server, auf dem die Web Receiver-App gehostet wird. Die Überschrift für ein beschreibt die Gerätefunktionen mit CAST-DEVICE-CAPABILITIES: {"display_supported":false}

Wenn Ihr Server eine Anfrage vom Gerät empfängt, können Sie die Methode Informationen in diesem Header, um die Anfrage an die Web Receiver-App weiterzuleiten, die ist für Audiogeräte optimiert.

Web Receiver-API

Sie können das gleiche Gerätefunktionsobjekt abrufen, indem Sie CastReceiverManager.getDeviceCapabilities() aufrufen. wenn die Web Receiver-App geladen wird.

Weitere Informationen findest du unter Gerätefunktionen. Informationen.

Sender-APIs

Jede der Cast Sender APIs enthält auch Informationen zur Gerätefunktion. Damit kann die Absender-App bestimmen, welche Art von Medien an den Empfänger gesendet werden soll. Wenn deine App sowohl Audio- als auch Videofunktionen unterstützt, werden Videoinhalte möglicherweise nicht an Audiogeräte. Ihre App kann die Lautstärke mit der am häufigsten verwendeten Methode für das Gerät, wie in der Design-Checkliste beschrieben. Sehen Sie sich die folgenden APIs für Gerätefunktionen für Absender an:

Richtlinien zur Arbeitsspeichernutzung

Web Receiver-Apps, die auf Audiogeräten ausgeführt werden, müssen die Arbeitsspeichernutzung so verwalten:

  • Vermeiden Sie es, Bild- oder Grafikinhalte herunterzuladen oder zu verwenden, um den Arbeitsspeicher zu reduzieren und die Zeit bis zum Start der Wiedergabe zu verkürzen.
  • Bei der Verwendung von Media Source Extensions (MSE) müssen Anwendungen den Stream begrenzen 2 MB groß ist. Wenn Sie die Media Player Library (MPL) verwenden, ist das Stream-Puffergröße ist bereits durch MPL definiert.
  • Bei Verwendung von HTMLMediaElement ist die Puffergröße des Streams der Anwendung definiert. von Chrome basierend auf der Stream-Rate. Begrenzen Sie die Audio-Bitrate auf 2 Megabit pro die alle Codecs unterstützt, die in den Unterstützte Medien (bis zu 48 kHz/16 Bit).

Lautstärkeregelung

Bei den meisten Google Cast für Audiogeräte steuert die Absender-App und nicht nur die Eingangslautstärke der Audioquelle, wie bei einem Chromecast. Das bedeutet, dass die Schritte zur Lautstärkeänderung Audioanwendungen. In den folgenden Dokumenten finden Sie Richtlinien für die Bereitstellung Lautstärkeregelung in der App:

Gerätesteuerung

Google Cast für Audiogeräte kann eigene Wiedergabesteuerungen haben, wie Tasten oder Fernbedienungen. Sie verwenden die Nachrichten, die für die urn:x-cast:com.google.cast.media-Namespace, wie in Nachrichten zur Medienwiedergabe, um die Wiedergabe zu steuern in der Empfängeranwendung. Ihre Empfängeranwendung muss um die Wiedergabesteuerung des Geräts zu unterstützen.

Außerdem sollte Ihre Absender-App die Nachrichten vom Empfänger zum Absender unterstützen. Wenn der Nutzer den Medienstatus über die Gerätesteuerung ändert, Absender-App eine Statusnachricht vom Empfänger empfangen und die Benutzeroberfläche aktualisieren kann entsprechend anpassen.

Gerätedisplay

Ein Google Cast für Audio-Gerät hat möglicherweise einen LCD-Bildschirm auf dem Gerät oder gerätespezifische Steueranwendung, die Medienmetadaten anzeigt. Dein Empfänger Die App muss diese Metadaten für alle Audiotracks bereitstellen und dafür sorgen, dass sie synchron sind mit dem aktuell wiedergegebenen Inhalt, um sicherzustellen, dass die Metadaten richtig auf dem Display angezeigt. Verwendet die Anwendung benutzerdefinierte Metadaten, Außerdem müssen die standardmäßigen Audio-Metadaten (Titelname, Künstlername, Album) Titel usw.), wie unten für die jeweilige Plattform beschrieben.

Der Empfänger erhält die Metadaten vom Sender, wenn er die Medien lädt. In Sender-App mit dem Befehl zum Laden der Medien auf den Empfänger, müssen Sie die unten beschriebenen Felder angeben, damit die Metadaten auf der Google Cast für Audiogerät. Verwenden Sie die folgenden APIs:

Wenn die Cast App eine Medienwarteschlange auf dem Empfänger oder in der Cloud verwaltet, Web Receiver muss sämtliche Medienstatus-Updates mithilfe der urn:x-cast:com.google.cast.media-Namespace, sodass alle Absender synchronisiert.

Anmeldung

Du musst dein Google Cast für Audiogerät zum Testen und Registrieren registrieren Ihre App, um Google Cast für Audiogeräte zu unterstützen. Verwenden Sie dazu die Google Cast SDK-Entwicklerkonsole

  • Weitere Informationen finden Sie unter Geräte. zur Registrierung von Geräten.
  • Sie müssen das Kästchen Unterstützt Streaming auf Nur-Audio-Geräte anklicken, wenn Ihre App registrieren, damit sie Google Cast für Audiogeräte. Siehe Anwendung registrieren.

Für nicht veröffentlichte Apps, z. B. Apps, die zu Testzwecken verwendet werden, müssen Sie auch die Option Option zur Unterstützung von reinen Audiogeräten, damit die App Audiogeräte.

Google Cast für Audio 2.0

Google Cast for Audio (GC4A) 2.0 ist die Cast Audio-Plattform der nächsten Generation. die auf Geräte mit geringem Arbeitsspeicher ausgerichtet sind, um das Ökosystem der Geräte zu erweitern, Ihre Inhalte streamen können. Da GC4A 2.0 auf Audioplattformen ausgerichtet ist, auf die Angleichung an Geräte ohne Display reduziert. GC4A 2.0 wird für neue und vorhandenen Lautsprechern, die Streaming unterstützen.

Testen und Fehler beheben

Da alle unterstützten Lautsprecher auf GC4A 2.0 umgestellt werden, ist es wichtig, Entwickler von Audio-Apps testen ihre Apps auf GC4A 2.0. Du kannst deine Cast App für GC4A 2.0 auf einem Bose-Produktions-WLAN-Lautsprecher, JBL Charge 5 WLAN, JBL Authentics, Cambridge Audio, Teuful Motiv Home, LG-Soundbar 2024.

Chrome Remote Debugger wird von GC4A 2.0 nicht unterstützt. Wenn Sie Fehler in Ihrem App, empfiehlt Google die Verwendung des Cast-Debugging-Protokolls.

Es wird empfohlen, alle App-Funktionen auf GC4A 2.0 zu testen. Achten Sie darauf, das Abspielen aller Medientypen (Podcasts, Streams usw.), das Pausieren, das Scrubbing, zum Überspringen, zum Wechseln der Wiedergabelisten, zum Anhalten und zum erneuten Verbinden von Cast.

Unterstützte APIs

GC4A 2.0 unterstützt folgende APIs:

  • HTML
  • JavaScript ECMA 6
  • DOMParser
  • XMLSerializer
  • Dokument und abgeleitete Klassen
  • DocumentFragment
  • HTMLMediaElement und HTMLAudioElement
  • HTMLVideoElement (nur Audiowiedergabe)
  • HTMLScriptElement
  • HTMLBaseElement
  • HTMLTemplateElement
  • Benutzerdefinierte Elemente
  • Schatten-DOM
  • Skriptmodule / asynchron / verzögert
  • Fetch / XHR
  • WebSocket
  • MessagePort
  • Kekse
  • MSE (Media Source Extensions)
  • EME (Encrypted Media Extensions)
  • Lokaler Speicher / Sitzungsspeicher

In GC4A 2.0 wird Folgendes nicht unterstützt:

  • Import dynamischer Module (wird 2024 hinzugefügt)
  • CSS
  • IFrame
  • TextTracks

Kontakt

Bitte wenden Sie sich an gc4a-support-external@google.com wenn Sie Hilfe bei der Einrichtung für Tests benötigen oder einen Bose-Lautsprecher nicht verwenden können.