Du musst deine Anwendung registrieren, wenn du den Receiver für Medien mit benutzerdefinierten Stilen verwendest oder einen benutzerdefinierten Empfänger erstellst. Nachdem Sie Ihre Anwendung registriert haben, erhalten Sie eine Anwendungs-ID, die von der Absenderanwendung für API-Aufrufe verwendet wird, z. B. um eine Web Receiver-Anwendung zu starten.
Wenn Sie den Standardmedienempfänger verwenden, müssen Sie Ihre Anwendung nicht registrieren. Beim Standardmedienempfänger können Sie keinen Stil für die UI des Mediaplayers bereitstellen. Der Standardmedienempfänger verwendet eine bereitgestellte Konstante als Anwendungs-ID.
Außerdem musst du dein Google Cast-Gerät registrieren, damit es vor der Veröffentlichung auf deine Web Receiver-App zugreifen kann. Sobald du die Receiver-App veröffentlicht hast, ist sie für alle Google Cast-Geräte verfügbar.
Anwendungen
Wenn du deine App registrierst, kannst du sie vor der Veröffentlichung auf deinem registrierten Cast-Gerät testen. Durch die Veröffentlichung der App wird sie für alle Übertragungsgeräte verfügbar gemacht.
Anwendung registrieren
Du musst einen Empfänger mit benutzerdefinierten Stilen oder einen benutzerdefinierten Empfänger registrieren, um eine Anwendungs-ID zu erhalten, die mit API-Aufrufen von der Absenderanwendung verwendet wird.
So registrieren Sie Ihre Cast App:
- Melden Sie sich in der Google Cast SDK-Entwicklerkonsole an.
- Klicken Sie entweder auf der Seite Übersicht oder auf der Seite Anwendungen auf Neue Anwendung hinzufügen.
Wählen Sie aus, welchen Typ von Web Receiver Sie verwenden möchten:
Benutzerdefinierter Receiver
Wählen Sie diese Option aus, wenn für Ihre App Benutzeroberflächenkomponenten oder Interaktionsmuster erforderlich sind, die nicht vom Empfänger mit benutzerdefinierten Stilen bereitgestellt werden. Die Auswahl der Option „Benutzerdefinierter Receiver“ ist möglicherweise auch dann erforderlich, wenn dein Inhaltstyp nicht als einer der unterstützten Medientypen des Receivers mit benutzerdefinierten Stilen aufgeführt ist.
Bei dieser Option müssen Sie eine vollständige Webanwendung für die Web Receiver-App erstellen.
Receiver für Medien mit benutzerdefinierten Stilen
Wählen Sie diese Option aus, wenn Ihre App Video- oder Audioinhalte mit einem der unterstützten Medientypen streamt und Sie eine Benutzeroberfläche auf dem Fernseher bereitstellen möchten, die entweder die Standard-Mediaplayer-UI oder eine Reihe benutzerdefinierter Stile zusätzlich zur Standard-Mediaplayer-UI verwendet.
Mit den benutzerdefinierten Stilen, die du zur Verfügung stellen kannst, kannst du das Aussehen verschiedener Elemente der Player-UI (z. B. des Ladebildschirms und der Fortschrittsanzeige) ganz einfach über eine CSS-Datei definieren. Du musst keine Receiver-App erstellen.
Weitere Informationen finden Sie unter Empfänger mit benutzerdefinierten Stilen.
Geben Sie die Details für die Web Receiver-App ein:
Geben Sie im Feld Name den Namen der App ein.
Dieser Anwendungsname wird angezeigt, wenn Web Receiver geladen wird oder inaktiv ist, wenn du den Receiver mit benutzerdefinierten Stilen verwendest. Wenn Sie einen benutzerdefinierten Empfänger verwenden, ist der Wert dieses Felds der Standardwert für den Anwendungsstatus, wenn er nicht mit der Methode
setApplicationStatefestgelegt wurde.Legen Sie die Darstellung der Web Receiver-App fest:
Geben Sie für einen benutzerdefinierten Empfänger im Feld URL die App-URL an.
Gib eine URL ein, die das Google Cast-Gerät beim Laden deiner Web Receiver-App anfordern soll. Während der Entwicklung kann die URL HTTP verwenden, aber wenn die App veröffentlicht wird, muss sie HTTPS verwenden. Die URL kann zu einer HTML-Seite oder einem anderen Dateityp gehören, auf den über einen Webbrowser zugegriffen werden kann. Es ist in Ordnung, wenn sich Ihr Webempfänger über eine interne (NAT-registrierte) IP-Adresse befindet, aber nicht auf localhost, da es sich selten um eine Top-Level-Domain handelt. Obwohl die Web Receiver-Anwendung bei der Veröffentlichung über SSL (HTTPS) bereitgestellt werden muss, können die in der Web Receiver-App geladenen Inhalte über HTTP bereitgestellt werden.
Geben Sie für einen Empfänger mit benutzerdefinierten Stilen im Feld Skin-URL die URL für das Stylesheet an.
Geben Sie eine HTTPS-URL an, die auf die CSS-Datei auf Ihrer Website verweist. Lassen Sie das Feld leer, um die Standardstile zu verwenden. Sie können diesen später jederzeit bearbeiten, wenn Sie Ihre benutzerdefinierten Stile bereitstellen oder aktualisieren möchten.
Setzen oder entfernen Sie das Häkchen im Kästchen Unterstützt Relay-Streaming.
Mit dem Relay-Streaming kann Ihr Webempfänger die Übertragung von Absendern unterstützen, die nicht mit demselben WLAN wie der Empfänger verbunden sind. Entfernen Sie das Häkchen aus diesem Kästchen, um das Relay-Streaming für den Empfänger zu deaktivieren.
Setzen oder entfernen Sie das Häkchen im Kästchen Unterstützt Streaming auf reine Audiogeräte.
Klicken Sie dieses Kästchen an, damit Ihre App Google Cast für Audiogeräte erkennen kann. Wenn Sie die Unterstützung für reine Audiogeräte deaktivieren möchten, entfernen Sie das Häkchen. Weitere Informationen finden Sie unter Audiogeräte.
Klicke auf Speichern.
Ihre Registrierungsdaten werden angezeigt, einschließlich Anwendungs-ID, Name, Typ und Status. Notieren Sie sich die Anwendungs-ID, da Sie sie in den Cast API-Aufrufen Ihrer App angeben.
Klicken Sie auf Fertig, um zur Seite „Anwendungen“ zurückzukehren.
Anwendungsinformationen bearbeiten
Bevor Sie Ihre Anwendung veröffentlichen können, müssen Sie einige zusätzliche Informationen angeben. Du kannst auch die Informationen aktualisieren, die du bei der Registrierung zu deiner Bewerbung angegeben hast.
So bearbeiten Sie Anwendungsinformationen:
- Klicke in der Google Cast SDK Developer Console auf der Seite Übersicht oder Anwendungen auf die Anwendungs-ID oder auf Bearbeiten für die App, die du bearbeiten möchtest.
- Aktualisieren Sie im Feld Name den Namen, den Sie bei der Registrierung der Anwendung angegeben haben.
- Aktualisieren Sie für Anwendungen mit benutzerdefiniertem Empfänger im Feld URL den Standort der von Ihnen registrierten Web Receiver-Anwendung.
- Aktualisieren Sie bei Anwendungen mit benutzerdefinierten Stilen im Feld Skin-URL den Speicherort des Stylesheets Ihrer Anwendung.
Setzen oder entfernen Sie das Häkchen im Kästchen Unterstützt Relay-Streaming.
Mit dem Relay-Streaming kann Ihr Webempfänger die Übertragung von Absendern unterstützen, die nicht mit demselben WLAN wie der Empfänger verbunden sind. Um das Relay-Streaming für den Empfänger zu deaktivieren, entfernen Sie das Häkchen aus diesem Kästchen.
Setzen oder entfernen Sie das Häkchen im Kästchen Unterstützt Streaming an Nur-Audio-Geräte.
Klicken Sie dieses Kästchen an, damit Ihre App Google Cast für Audiogeräte erkennen kann. Wenn Sie die Unterstützung für reine Audiogeräte deaktivieren möchten, entfernen Sie das Häkchen. Weitere Informationen finden Sie unter Audiogeräte.
Geben Sie im Abschnitt Absenderdetails für jede Plattform, die Ihre Anwendung unterstützt, Folgendes an:
Android:
- vollständig qualifizierter Name Ihres Anwendungspakets.
iOS:
- die von Apple erforderlichen iTunes-ID und Bundle-ID
- Den App-Start-URI unter Verwendung des URI, mit dem die Google Home App deine App startet. Weitere Informationen zum erforderlichen URI-Format findest du unter URL-Schemas für die Kommunikation mit Apps verwenden.
Web:
- die Website-URL für Ihre Anwendung.
Wählen Sie im Abschnitt Eintragsdetails aus, ob die Anwendung in Google-Produkten wie chromecast.com/apps. aufgeführt werden soll.
Wählen Sie im Drop-down-Menü Kategorie die Kategorie aus, die Ihre App am besten beschreibt.
Hinweis:Ihre App muss die hier beschriebenen und die durch andere Einstellungen implizierten Medientypen unterstützen. Wenn deine App beispielsweise Google Cast für Audio unterstützt und du hier „TV & Filme“ auswählst, muss deine App reine Audiogeräte unterstützen, wie unter Audiogeräte beschrieben, sowie die Anforderungen für die Videowiedergabe.
Wählen Sie zum Beschreiben der Länder, in denen Ihre App verfügbar ist, entweder das Optionsfeld Alle Länder oder Nur in ausgewählten Ländern aus. Wenn Sie Länder angeben, klicken Sie in der angezeigten Liste die Kästchen für diese Länder an.
Geben Sie im Feld Titel einen aussagekräftigen Titel für Ihre Anwendung ein.
Maximal 50 Zeichen zulässig. Beispiel: „YouTube“.
Geben Sie in das Feld Beschreibung eine Beschreibung der Anwendung ein.
Maximal 80 Zeichen zulässig. Beispiel: „Genieße deine Lieblingskanäle auf YouTube auf dem besten Bildschirm zu Hause.“
Klicken Sie im Abschnitt Grafiken auf das Pluszeichen, um das Symbolbild für Ihre Anwendung hochzuladen.
Das Bild muss 512 x 512 Pixel groß sein und darf einen transparenten Hintergrund haben.
Wenn Sie unter Eigene Übersetzungen hinzufügen Übersetzungen für die Felder Titel und Beschreibung angeben möchten, wählen Sie die Sprache im Drop-down-Menü aus, klicken Sie auf Hinzufügen und geben Sie den übersetzten Text in das angezeigte Dialogfeld ein. Sie können auch ein Bild für das Symbol für diese Übersetzung hochladen.
Wenn Sie mit der Aktualisierung Ihrer App-Informationen fertig sind, klicken Sie auf Speichern.
Anwendung veröffentlichen
Durch die Veröffentlichung deiner App wird deine App für alle Übertragungsgeräte weltweit verfügbar gemacht. Außerdem wird ein Eintrag für Ihre App in Google-Produkten wie der Listenwebsite chromecast.com/apps erstellt, über die Nutzer Ihre App finden und herunterladen können. Wenn Sie Ihre App beim Bearbeiten der App-Informationen in Schritt 6 oben angegeben haben, wird sie nach der Veröffentlichung unter chromecast.com/apps angezeigt.
So veröffentlichen Sie Ihre Anwendung:
Klicken Sie in der Google Cast SDK Developer Console auf der Seite Übersicht oder Anwendungen für die App, die Sie veröffentlichen möchten, auf Veröffentlichen.
Wenn die Anwendungsinformationen vollständig sind, wird ein Vorschaubildschirm mit den Anwendungsinformationen angezeigt, die Sie unter Anwendungsinformationen bearbeiten eingegeben haben. Andernfalls wird eine Nachricht mit den erforderlichen Informationen angezeigt.
Klicken Sie auf Bearbeiten, um zurückzugehen und Informationen zu aktualisieren.
Wenn Sie bereit sind, Ihre App zu veröffentlichen, klicken Sie auf Veröffentlichen.
Statistiken
In der Google Cast SDK Developer Console wird die Leistung Ihrer App erfasst. Klicken Sie in der Spalte Statistiken auf Anzeigen, um für jede auf der Seite "Anwendungen" oder "Übersicht" veröffentlichte Anwendung Leistungsdaten aufzurufen.
Folgende Informationen werden angezeigt:
- Anzahl der Übertragungsempfänger, über die die App gestartet wurde
- Anzahl der gestarteten Sitzungen
- Durchschnittliche Medienwiedergabezeit (in Minuten) pro Sitzung
Wenn eine Andere Plattform in den Statistiken angezeigt wird, hat der Absender seine Plattform nicht angegeben, z. B. wenn ein älterer iOS-Absender nicht aktualisiert wurde.
Geräte
Google Cast-Geräte wie Chromecast oder ein Android TV-Gerät sind standardmäßig nicht für die Entwicklung und Tests aktiviert. Wenn Sie Ihr Gerät in ein Entwicklungsgerät umwandeln und während der Entwicklung Zugriff auf Ihre unveröffentlichte Web Receiver-App erhalten möchten, müssen Sie das Gerät bei Ihrer App registrieren. Außerdem ist der Empfänger dadurch zur Fehlerbehebung über ein Remote-Browserfenster zugänglich (siehe Fehlerbehebung).
So registrieren Sie Ihr Google Cast-Gerät:
Richte dein Google Cast-Gerät ein und verbinde es mit demselben WLAN wie deinen Computer.
Weitere Informationen finden Sie in der Anleitung zur Einrichtung des Cast-Geräts.
Öffnen Sie auf Ihrem Computer einen von Google Cast optimierten Webbrowser.
Melden Sie sich in der Google Cast SDK-Entwicklerkonsole an.
Suche die Seriennummer des Geräts, das du registrieren möchtest.
Klicken Sie entweder auf der Übersichtsseite oder der Geräteseite auf Neues Gerät hinzufügen.
Geben Sie die Seriennummer Ihres Geräts ein.
Geben Sie eine Beschreibung ein und klicken Sie auf OK.
Dies ist nur ein Anzeigename für Ihr Gerät. Er muss nicht mit dem Namen übereinstimmen, den Sie dem Gerät bei der Einrichtung durch den Nutzer gegeben haben.
Warten Sie 15 Minuten, bevor Sie fortfahren.
Sobald die Registrierung abgeschlossen ist, lautet der Status des Geräts „Bereit zum Testen“.
Starte dein Übertragungsgerät neu: Trenne das Strom- oder USB-Kabel vom Gerät und schließe es wieder an.
Seriennummer des Geräts ermitteln
Um die Seriennummer eines Geräts zu ermitteln, kannst du die Seite der Cast Developer Console auf das Gerät streamen:
Klicken Sie auf das Cast-Symbol, so als ob Sie diese Seite streamen würden.
In der Eingabeaufforderung wird Tab streamen angezeigt und die verfügbaren Geräte werden aufgelistet.
Wählen Sie im Drop-down-Menü das Gerät aus, dessen Seriennummer Sie abrufen möchten.
- Bei Anzeigegeräten wird die Seriennummer auf dem Fernsehbildschirm angezeigt und auf den Fernsehlautsprechern vorgelesen, um Nullen und Os zu unterscheiden.
- Bei Audiogeräten wird die Seriennummer auf dem Lautsprecher vorgelesen, an den gestreamt wird.
Seriennummer der Android TV-Software
Android TV-Geräten (ATV) sind mehrere Seriennummern zugeordnet. Die Seriennummer der Software (Cast) erhalten Sie entweder, indem Sie die Seite der Cast Developer Console wie oben beschrieben auf das ATV-Gerät streamen oder das ATV-Gerät in den Entwicklermodus versetzen und in den Cast-Einstellungen nach der Software-Seriennummer suchen.
Um Ihr ATV-Gerät in den Entwicklermodus zu versetzen, rufen Sie Einstellungen > System > Info > Android TV OS-Build auf und klicken Sie mehrmals auf den Build, bis Sie vom Gerät benachrichtigt werden, dass Sie sich im Entwicklermodus befinden. Sie finden die Seriennummer im Entwicklermodus unter Einstellungen > Geräteeinstellungen > Integrierte Chromecast-Technologie oder Einstellungen > System > Streamen. Die Software-Seriennummer wird angezeigt.
Wenn ein Quad-Gerät auf die Werkseinstellungen zurückgesetzt wird, ändert sich die Software-Seriennummer. Gehe nach dem Zurücksetzen auf die Werkseinstellungen wie oben beschrieben vor, um die Seriennummer des Geräts zu ermitteln und die neue Software-Seriennummer noch einmal in der Cast Developer Console zu registrieren.
Kontoprobleme
Ich möchte meine Registrierung für die Google Cast Developer Console stornieren.
Die Registrierungsgebühr für das Entwicklerkonto in Höhe von 5 $kann nicht erstattet werden.
Ich kann nicht mehr auf die Google Cast Developer Console zugreifen.
Falls Sie von uns bereits eine E-Mail erhalten haben, in der Sie darüber informiert wurden, dass Ihr Entwicklerkonto aufgrund wiederholter Verstöße gegen unsere Nutzungsbedingungen oder Inhaltsrichtlinien gesperrt wurde, antworten Sie auf diese E-Mail, wenn Sie weitere Informationen benötigen.
Meine App wurde aus Google Cast entfernt
Entfernte Apps werden als Verwarnungen gegen dein Entwicklerkonto angesehen, sodass es nicht mehr als einwandfrei gilt. Bei mehreren oder schwerwiegenden Richtlinienverstößen kann Ihr Entwicklerkonto gekündigt werden.
Eine entfernte Anwendung bedeutet, dass Nutzer die entfernte Anwendung nicht mehr aufrufen oder darauf zugreifen können. Wenn deine Entwickleranmeldedaten für Google Cast noch einwandfrei sind und die Art deiner App dies zulässt, kannst du Korrekturen vornehmen und eine neue Instanz der App veröffentlichen, die die Bedingungen erfüllt.
Veröffentlichen Sie eine entfernte Anwendung erst dann wieder, wenn der Richtlinienverstoß behoben wurde.
Ich möchte die mit meinem Konto verknüpfte E-Mail-Adresse ändern.
Sie können die mit Ihrem Google Cast-Entwicklerkonto verknüpfte E-Mail-Adresse nicht ändern. Wenn Sie für eine Organisation arbeiten, empfehlen wir, eine Team-E-Mail-Adresse zu verwenden, um in Zukunft Zugriffsprobleme zu vermeiden.
Ich habe ein anderes Problem.
Weitere Informationen finden Sie auf der Supportseite für das Cast SDK.