Wenn du den Styled Media Receiver verwendest oder einen benutzerdefinierten Empfänger erstellst, musst du deine Anwendung registrieren. Nachdem Sie Ihre Anwendung registriert haben, erhalten Sie eine Anwendungs-ID, die von Ihrer Absenderanwendung für API-Aufrufe wie den Start einer Web Receiver-Anwendung verwendet wird.
Wenn Sie den Standardmedienempfänger verwenden, müssen Sie Ihre Anwendung nicht registrieren. Der Standard-Medienempfänger ermöglicht es nicht, Stile für die Benutzeroberfläche des Mediaplayers anzugeben, und verwendet eine bereitgestellte Konstante als Anwendungs-ID.
Außerdem müssen Sie Ihr Google Cast-Gerät so registrieren, dass es vor der Veröffentlichung auf Ihre Anwendung „Webempfänger“ zugreifen kann. Sobald Sie Ihre Empfängeranwendung veröffentlicht haben, ist sie auf allen Google Cast-Geräten verfügbar.
Anwendungen
Wenn Sie Ihre Anwendung registrieren, können Sie sie vor der Veröffentlichung auf Ihrem registrierten Cast-Gerät testen. Wenn Sie die Anwendung veröffentlichen, steht sie für alle Cast-Geräte zur Verfügung.
Anwendung registrieren
Sie müssen einen Empfänger mit benutzerdefinierten Stilen oder einen benutzerdefinierten Empfänger registrieren, um eine Anwendungs-ID zu erhalten, die für API-Aufrufe von der Absenderanwendung verwendet wird.
So registrieren Sie die Cast-Anwendung:
- Melden Sie sich in der Google Cast SDK Developer Console an.
- Klicken Sie auf der Seite Übersicht oder auf der Seite Anwendungen auf Neue Anwendung hinzufügen.
Wählen Sie den Typ der Web Receiver-App aus:
Benutzerdefinierter Empfänger
Wählen Sie diese Option aus, wenn für Ihre App Komponenten der Benutzeroberfläche oder Interaktionsmuster erforderlich sind, die nicht vom Styled Media Receiver bereitgestellt werden. Die Auswahl eines benutzerdefinierten Empfängers kann auch erforderlich sein, wenn dein Inhaltstyp nicht zu den unterstützten Medientypen von Styled Media Receiver gehört.
Für diese Option muss eine vollständige Webanwendung für die Anwendung „Webempfänger“ erstellt werden.
Weitere Informationen finden Sie unter Benutzerdefinierte Empfängeranwendung.
Receiver mit benutzerdefinierten Stilen
Wählen Sie diese Option aus, wenn Ihre App Video- oder Audioinhalte mithilfe eines der unterstützten Medientypen streamt und Sie eine Benutzeroberfläche auf dem Fernseher bereitstellen möchten, die entweder die Standardmedien-Benutzeroberfläche oder eine Reihe benutzerdefinierter Stile verwendet.
Mit benutzerdefinierten Stilen kannst du das Aussehen verschiedener Elemente der Player-UI (z. B. des Startbildschirms und der Fortschrittsanzeige) ganz einfach definieren, indem du eine CSS-Datei angibst. Du musst keine Empfänger-App erstellen.
Machen Sie die erforderlichen Angaben für die Web Receiver App:
Geben Sie in das Feld Name den Namen Ihrer App ein.
Dies ist der Anwendungsname, wie er beim Laden des Webempfängers angezeigt wird. Falls Sie den Styled Media Receiver verwenden, ist er inaktiv. Wenn Sie einen benutzerdefinierten Empfänger verwenden, ist der Wert dieses Feldes der Standardwert für den Anwendungsstatus, sofern er nicht mit der Methode
setApplicationState
festgelegt wurde.Darstellung der Web Receiver App festlegen:
Geben Sie bei Benutzerdefinierter Empfänger im Feld URL die App-URL an.
Geben Sie eine URL ein, die vom Google Cast-Gerät beim Laden der Web Receiver App angefordert werden soll. Während der Entwicklung kann die URL HTTP verwenden, aber bei der Veröffentlichung der App muss HTTPS verwendet werden. Die URL kann für eine HTML-Seite oder einen anderen Dateityp gelten, auf den über einen Webbrowser zugegriffen werden kann. Es ist in Ordnung, wenn sich Ihr Webempfänger an einer internen (NAT-registrierten) IP-Adresse befindet, aber nicht auf localhost, da es sich nur selten um eine Top-Level-Domain handelt. Die Web Receiver App muss bei der Veröffentlichung zwar über SSL (HTTPS) bereitgestellt werden, der in der Web Receiver App geladene Inhalt kann jedoch über HTTP bereitgestellt werden.
Geben Sie für einen Empfänger von Stilmedien im Feld Skin-URL die URL für das Stylesheet an.
Geben Sie eine HTTPS-URL an, die auf Ihre CSS-Datei auf Ihrer eigenen Website verweist. Wenn Sie die Standardstile verwenden möchten, lassen Sie das Feld leer. Sie können diese Option später jederzeit bearbeiten, wenn Sie Ihre benutzerdefinierten Stile angeben oder aktualisieren möchten.
Aktivieren oder deaktivieren Sie das Kästchen Unterstützt das Relay-Streaming.
Mit dem Relay-Streaming kann Ihr Webempfänger das Streamen von Absendern unterstützen, die nicht mit demselben WLAN wie der Empfänger verbunden sind. Wenn Sie das Relay-Streaming für den Empfänger deaktivieren möchten, entfernen Sie das Häkchen aus diesem Kästchen.
Klicken Sie auf das Kästchen Unterstützt das Streamen auf reine Audiogeräte oder entfernen Sie das Häkchen für dieses Kästchen.
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 aus diesem Kästchen. Weitere Informationen finden Sie unter Audiogeräte.
Klicken Sie auf Speichern.
Ihre Registrierungsdetails, einschließlich Anwendungs-ID, Name, Typ und Status, werden angezeigt. Notieren Sie sich die Anwendungs-ID, da Sie sie für die Cast API-Aufrufe Ihrer Anwendung angeben.
Klicken Sie auf Fertig, um zur Seite „Anwendungen“ zurückzukehren.
Anwendungsinformationen bearbeiten
Bevor Sie Ihre Anwendung veröffentlichen können, müssen Sie zusätzliche Informationen angeben. Sie können auch die Informationen aktualisieren, die Sie bei der Registrierung zu Ihrem Antrag angegeben haben.
So bearbeiten Sie Anwendungsinformationen:
- Klicken Sie in der Google Cast SDK Developer Console auf der Seite Übersicht oder Anwendungen auf die Anwendungs-ID oder für die zu bearbeitende Anwendung auf Bearbeiten.
- Aktualisieren Sie im Feld Name den Namen, den Sie bei der Registrierung der Anwendung angegeben haben.
- Aktualisieren Sie bei Anwendungen des benutzerdefinierten Empfängers im Feld URL den Speicherort der registrierten Web Receiver App.
- Aktualisieren Sie bei Styled Receiver-Anwendungen im Feld Skin URL den Speicherort des Stylesheets.
Aktivieren oder deaktivieren Sie das Kästchen Unterstützt das Relay-Streaming.
Mit dem Relay-Streaming kann Ihr Webempfänger das Streamen 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, entferne das Häkchen.
Klicke das Kästchen Streaming auf Geräten mit Audio unterstützen an oder entferne das Häkchen.
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 aus diesem Kästchen. Weitere Informationen finden Sie unter Audiogeräte.
Geben Sie im Abschnitt Absenderdetails für jede Plattform, die Ihre Anwendung unterstützt, Folgendes an:
Android:
- Der voll qualifizierte Name Ihres Anwendungspakets
iOS:
- die von Apple erforderlichen iTunes-IDs und Bundle-IDs.
- Den App-Start-URI mit dem URI, den die Google Home App zum Starten Ihrer App verwendet. Weitere Informationen zum erforderlichen URI-Format finden Sie unter URL-Schemas für die Kommunikation mit Apps verwenden.
Web:
- die Website-URL für Ihre App.
Wähle im Abschnitt Details zum Eintrag aus, ob deine Anwendung in Google-Produkten wie chromecast.com/apps aufgelistet werden soll.
Wählen Sie im Drop-down-Menü Kategorie die Kategorie aus, die Ihre Anwendung am besten beschreibt.
Hinweis:Ihre App muss die hier beschriebenen Medientypen sowie die in anderen Einstellungen angegebenen Medientypen unterstützen. Wenn Ihre App beispielsweise Google Cast für Audio unterstützt und Sie hier „TV & Filme“ auswählen, muss Ihre App sowohl Geräte unterstützen, die ausschließlich Audio verwenden, als auch die Bestimmungen für die Videowiedergabe.
Wählen Sie entweder die Option Alle Länder oder Nur in ausgewählten Ländern aus, um die Länder zu beschreiben, in denen Ihre Anwendung verfügbar ist. Klicken Sie gegebenenfalls die Kästchen für diese Länder in der Liste an.
Geben Sie im Feld Titel einen aussagekräftigen Titel für die Anwendung ein.
Verwende nicht mehr als 50 Zeichen. Beispiel: „YouTube“.
Geben Sie in das Feld Beschreibung eine Beschreibung für die Anwendung ein.
Maximal 80 Zeichen Beispiel: „Ihre Lieblings-YouTube-Kanäle auf dem besten Bildschirm zu Hause ansehen.“
Klicken Sie im Abschnitt Grafiken auf das Pluszeichen, um das Symbolbild für Ihre Anwendung hochzuladen.
Das Bild muss 512 × 512 Pixel groß sein und 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 hochladen, das für diese Übersetzung spezifisch ist.
Wenn Sie alle Informationen für Ihre App aktualisiert haben, klicken Sie auf Speichern.
Anwendung veröffentlichen
Wenn Sie Ihre Anwendung veröffentlichen, ist sie für alle Cast-Geräte weltweit verfügbar. Außerdem wird ein Eintrag für Ihre App in Google-Produkten wie der chromecast.com/apps-Eintragswebsite erstellt. Dort können Nutzer Ihre App finden und herunterladen. Wenn Sie Ihre App beim Bearbeiten der Anwendungsinformationen in Schritt 6 oben aufgelistet 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 in der Seite Anwendungen für die Anwendung, die Sie veröffentlichen möchten, auf Veröffentlichen.
Wenn Ihre Anwendungsinformationen vollständig sind, wird ein Vorschaubildschirm mit den Anwendungsinformationen angezeigt, die Sie unter Anwendungsinformationen bearbeiten eingegeben haben. Andernfalls wird eine Nachricht mit den Informationen angezeigt, die Sie angeben müssen.
Klicken Sie auf Bearbeiten, um zurückgehen und alle Informationen zu ändern.
Wenn Sie bereit sind, Ihre Anwendung zu veröffentlichen, klicken Sie auf Veröffentlichen.
Statistiken
Die Google Cast SDK Developer Console verfolgt die Leistung Ihrer Anwendung. Für jede veröffentlichte Anwendung auf der Seite „Anwendungen“ oder „Übersicht“ können Sie Leistungsdaten abrufen. Klicken Sie dazu in der Spalte Statistiken auf Anzeigen.
Die folgenden Informationen werden präsentiert:
- Anzahl der Cast-Empfänger, die die Anwendung gestartet haben
- Anzahl der gestarteten Sitzungen
- Durchschnittliche Medienwiedergabezeit (in Minuten) pro Sitzung
Wenn in den Statistiken eine Andere-Plattform angezeigt wird, hat der Absender die Plattform nicht angegeben. Dies kann beispielsweise der Fall sein, wenn ein älterer iOS-Absender nicht aktualisiert wurde.
Geräte
Google Cast-Geräte wie Chromecast oder Android TV-Geräte sind standardmäßig nicht für die Entwicklung und für Tests aktiviert. Wenn Sie Ihr Gerät in ein Entwicklungsgerät umwandeln und während der Entwicklung auf Ihre nicht veröffentlichte Web Receiver-App zugreifen möchten, müssen Sie das Gerät in Ihrer App registrieren. Durch die Registrierung kann der Empfänger auch zur Fehlerbehebung über ein Remote-Browserfenster aufgerufen werden (siehe Fehlerbehebung).
So registrieren Sie Ihr Google Cast-Gerät:
Richten Sie Ihr Google Cast-Gerät ein und verbinden Sie es mit demselben WLAN wie Ihren Computer.
Weitere Informationen finden Sie unter Cast-Geräteeinrichtung.
Öffnen Sie auf Ihrem Computer einen von Google Cast unterstützten Webbrowser.
Melden Sie sich in der Google Cast SDK Developer Console an.
Suchen Sie die Seriennummer des Geräts, das Sie registrieren möchten.
Klicken Sie auf der Übersichtsseite oder auf der Seite „Geräte“ 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 dein Gerät. Er muss nicht mit dem Namen übereinstimmen, den du dem Gerät bei der Einrichtung des Geräts gegeben hast.
Warten Sie fünfzehn Minuten, bevor Sie fortfahren.
Wenn die Registrierung abgeschlossen ist, lautet der Status des Geräts „Bereit zum Testen“.
Starte das Cast-Gerät neu: Trenne das Strom- oder USB-Kabel vom Gerät und verbinde es dann wieder.
Seriennummer des Geräts ermitteln
Wenn Sie die Seriennummer eines Geräts ermitteln möchten, können Sie die Cast Developer Console-Seite auf das Gerät streamen:
Klicken Sie auf das Cast-Symbol, so als ob Sie diese Seite streamen würden.
Die Eingabeaufforderung zeigt den Tab „Streamen“ und eine Liste der verfügbaren Geräte an.
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 zur Unterscheidung zwischen 0 und 0 ausgesprochen.
- Bei Audiogeräten wird die Seriennummer auf dem Lautsprecher, auf den gestreamt wird, vorgelesen.
Seriennummer der Android TV-Software
Mit Android TV (ATV)-Geräten sind mehrere Seriennummern verknüpft. Sie können die Seriennummer der Software (Cast) abrufen, indem Sie die Seite der Cast Developer Console wie oben beschrieben auf das ATV-Gerät streamen oder indem Sie das ATV-Gerät in den Entwicklermodus versetzen und in den Streamingeinstellungen für die Seriennummer der Software suchen.
Wenn Sie Ihr ATV-Gerät in den Entwicklermodus versetzen möchten, gehen Sie zu Einstellungen > System > Info > Android TV OS-Build und klicken Sie mehrmals auf den Build, bis Sie vom Gerät darüber informiert werden. Die Seriennummer finden Sie im Entwicklermodus unter Einstellungen > Geräteeinstellungen > Integrierte Chromecast-Technologie oder Einstellungen > System > Cast. Je nach ATV-Modell wird die Seriennummer dann angezeigt.
Hinweis: Wenn ein ATV-Gerät auf die Werkseinstellungen zurückgesetzt wird, ändert sich die Seriennummer der Software. Führen Sie nach dem Zurücksetzen auf die Werkseinstellungen die oben genannten Schritte aus, um die Seriennummer der Software zu ermitteln, und registrieren Sie die neue Seriennummer des Geräts noch einmal für die Cast Developer Console.
Kontoprobleme
Ich möchte meine Registrierung für die Google Cast Developer Console kündigen.
Die Registrierungsgebühr in Höhe von 5 $kann nicht erstattet werden.
Ich kann nicht mehr auf die Google Cast Developer Console zugreifen
Falls Sie von uns zuvor eine E-Mail erhalten haben, in der Sie darüber informiert werden, dass Ihr Entwicklerkonto wegen wiederholter Verstöße gegen unsere Nutzungsbedingungen oder Inhaltsrichtlinien gesperrt wurde, antworten Sie bitte auf diese E-Mail.
Meine App wurde aus Google Cast entfernt
Entfernte Apps werden als Verwarnungen gegen dein Entwicklerkonto angesehen. Bei mehreren oder schwerwiegenden Richtlinienverstößen kann Ihr Entwicklerkonto gekündigt werden.
Das Entfernen bedeutet, dass Nutzer die entfernte Anwendung nicht mehr aufrufen oder darauf zugreifen können. Wenn deine Entwickler-Anmeldedaten bei Google Cast einwandfrei sind und die Art deiner App dies zulässt, kannst du Korrekturen vornehmen und eine neue, konforme Instanz der Anwendung veröffentlichen.
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 die Verwendung einer Team-E-Mail-Adresse, um Zugriffsprobleme in Zukunft zu vermeiden.
Ich habe ein anderes Problem.
Weitere Informationen finden Sie auf der Supportseite für das Cast SDK.