Du musst deine Anwendung registrieren, wenn du den Styled Media Receiver verwendest oder einen benutzerdefinierten Receiver erstellst. Nachdem Sie Ihre Anwendung registriert haben, erhalten Sie eine Anwendungs-ID, die von Ihrer Senderanwendung zum Ausführen von API-Aufrufen verwendet wird, z. B. zum Starten einer Web-Empfängeranwendung.
Wenn du den Standard-Medien-Empfänger verwendest, musst du deine Anwendung nicht registrieren. Mit dem Standard-Medien-Empfänger kannst du die Benutzeroberfläche des Mediaplayers nicht stylen. Außerdem wird eine bereitgestellte Konstante als Anwendungs-ID verwendet.
Außerdem müssen Sie Ihr Google Cast-Gerät registrieren, damit es vor der Veröffentlichung auf Ihre Web-Empfängeranwendung zugreifen kann. Sobald Sie Ihre Empfänger-App 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 mit Ihrem registrierten Cast-Gerät testen. Wenn Sie die Anwendung veröffentlichen, wird sie für alle Cast-Geräte verfügbar.
Anwendung registrieren
Du musst einen Styled Media Receiver oder einen Custom Receiver registrieren, um eine Anwendungs-ID zu erhalten, die für API-Aufrufe von der Senderanwendung verwendet wird.
So registrieren Sie Ihre Cast-Anwendung:
- Melden Sie sich in der Google Cast SDK Developer Console an.
- Klicken Sie auf der Seite Übersicht oder Anwendungen auf Neue Anwendung hinzufügen.
Wählen Sie die Art der Web-Empfänger-App aus, die Sie verwenden möchten:
Benutzerdefinierter Empfänger
Wählen Sie diese Option aus, wenn Ihre App Benutzeroberflächenkomponenten oder Interaktionsmuster erfordert, die vom Styled Media Receiver nicht bereitgestellt werden. Die Auswahl von „Benutzerdefinierter Empfänger“ kann auch erforderlich sein, wenn dein Inhaltstyp nicht als einer der unterstützten Medientypen des Styled Media-Empfängers aufgeführt ist.
Beachte, dass du für diese Option eine vollständige Webanwendung für die Web-Empfänger-App erstellen musst.
Weitere Informationen finden Sie unter Benutzerdefinierte Empfängeranwendung.
Stilvoller Medienempfänger
Wählen Sie diese Option aus, wenn Ihre App Video- oder Audioinhalte mit einem der unterstützten Medientypen streamt und Sie auf dem Fernseher eine Benutzeroberfläche bereitstellen möchten, die entweder die Standardoberfläche des Mediaplayers oder eine Reihe benutzerdefinierter Stile über der Standardoberfläche des Mediaplayers verwendet.
Mit den benutzerdefinierten Stilen, die du zur Verfügung stellst, kannst du das Erscheinungsbild verschiedener Elemente der Player-Benutzeroberfläche (z. B. des Startbildschirms und der Fortschrittsanzeige) einfach durch Angabe einer CSS-Datei definieren – du musst keine Receiver-App erstellen.
Weitere Informationen finden Sie im Hilfeartikel Styled Media Receiver.
Gib die Details für deine Web-Empfänger-App ein:
Geben Sie im Feld Name den Namen Ihrer App ein.
Dies ist der Name der Anwendung, der beim Laden des Webempfängers oder im Inaktivitätsstatus angezeigt wird, wenn du den Styled Media Receiver verwendest. Wenn Sie einen benutzerdefinierten Empfänger verwenden, ist der Wert dieses Felds der Standardwert für den Anwendungsstatus, sofern er nicht mit der Methode
setApplicationStatefestgelegt wurde.Legen Sie das Erscheinungsbild der Web-Empfänger-App fest:
Geben Sie für einen benutzerdefinierten Empfänger im Feld URL die App-URL an.
Geben Sie eine URL ein, die das Google Cast-Gerät beim Laden Ihrer Web-Empfänger-App anfordern soll. Während der Entwicklung kann die URL HTTP verwenden, aber nach der Veröffentlichung der App muss HTTPS verwendet werden. Die URL kann für eine HTML-Seite oder einen anderen Dateityp sein, auf den über einen Webbrowser zugegriffen werden kann. Der Webreceiver kann sich an einer internen (NAT-registrierten) IP-Adresse befinden, aber nicht auf dem Localhost, da dies selten eine Top-Level-Domain ist. Die Web Receiver App muss zwar bei der Veröffentlichung über SSL (HTTPS) bereitgestellt werden, die in der Web Receiver App geladenen Inhalte können aber auch über HTTP bereitgestellt werden.
Gib für einen stilisierten Media-Receiver 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 dies später jederzeit bearbeiten, wenn Sie benutzerdefinierte Stile bereitstellen oder aktualisieren möchten.
Klicken Sie das Kästchen Unterstützt Relay-Streaming an oder entfernen Sie das Häkchen.
Mit der Weiterleitungsübertragung kann dein Web-Receiver Streams von Sendern unterstützen, die nicht mit demselben WLAN wie der Receiver verbunden sind. Wenn du die Weiterleitungsübertragung für deinen Empfänger deaktivieren möchtest, entferne das Häkchen aus diesem Kästchen.
Setzen oder entfernen Sie das Häkchen bei Unterstützt Streaming auf Geräte ohne Videowiedergabe.
Wenn Ihre App Google Cast für Audiogeräte erkennen soll, setzen Sie ein Häkchen in dieses Kästchen. Wenn Sie die Unterstützung für Geräte ohne Video 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 der Anwendungs-ID, des Namens, des Typs und des Status, werden angezeigt. Notieren Sie sich die App-ID, da Sie sie in den Cast API-Aufrufen Ihrer Anwendung angeben müssen.
Klicken Sie auf Fertig, um zur Seite „Anwendungen“ zurückzukehren.
Informationen zur Anwendung bearbeiten
Bevor Sie Ihre Anwendung veröffentlichen können, müssen Sie einige zusätzliche Informationen angeben. Sie können auch die Informationen aktualisieren, die Sie bei der Registrierung zu Ihrer App angegeben haben.
So bearbeiten Sie die Informationen zur Anwendung:
- Klicken Sie in der Google Cast SDK Developer Console auf der Seite Übersicht oder Anwendungen auf die Anwendungs-ID oder auf Bearbeiten für die Anwendung, die Sie bearbeiten möchten.
- Aktualisieren Sie im Feld Name den Namen, den Sie bei der Registrierung der Anwendung angegeben haben.
- Aktualisieren Sie bei benutzerdefinierten Empfängeranwendungen im Feld URL den Speicherort der von Ihnen registrierten Web-Empfängeranwendung.
- Aktualisieren Sie bei Styled Receiver-Anwendungen im Feld Skin-URL den Speicherort des Stylesheets Ihrer Anwendung.
Klicken Sie das Kästchen Unterstützt Relay-Streaming an oder entfernen Sie das Häkchen.
Mit der Weiterleitungsübertragung kann dein Webempfänger die Übertragung von Sendern unterstützen, die nicht mit demselben WLAN wie der Empfänger verbunden sind. Wenn Sie die Weiterleitungsübertragung für Ihren Empfänger deaktivieren möchten, entfernen Sie das Häkchen aus diesem Kästchen.
Klicken Sie das Kästchen Unterstützt Streaming auf Nur-Audio-Geräte an oder entfernen Sie das Häkchen.
Wenn Ihre App Google Cast für Audiogeräte erkennen soll, setzen Sie ein Häkchen in dieses Kästchen. Wenn Sie die Unterstützung für geräte, die nur Audio unterstützen, 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 von Ihrer App unterstützt wird, Folgendes an:
Android:
- den voll qualifizierten Namen Ihres Anwendungspakets.
iOS:
- die von Apple erforderliche iTunes-ID und Bundle-ID.
- die App-Start-URI mit dem URI, über den die Google Home App Ihre App startet. Weitere Informationen zum erforderlichen URI-Format finden Sie unter Mit URL-Schemas mit Apps kommunizieren.
Web:
- die Website-URL Ihrer Anwendung.
Wählen Sie im Abschnitt Eintragsdetails aus, ob Ihre App in Google-Produkten wie chromecast.com/apps aufgeführt werden soll.
Wählen Sie im Drop-down-Menü Kategorie die Kategorie aus, die am ehesten auf Ihre App zutrifft.
Hinweis:Ihre App muss die hier beschriebenen Medientypen sowie die durch andere Einstellungen implizierten Medientypen unterstützen. Wenn Ihre App beispielsweise Google Cast für Audio unterstützt und Sie hier „Fernsehen und Filme“ auswählen, muss Ihre App Audiogeräte wie unter Audiogeräte beschrieben sowie die Bestimmungen für die Videowiedergabe unterstützen.
Wählen Sie entweder das Optionsfeld Alle Länder oder Nur in ausgewählten Ländern aus, um die Länder anzugeben, in denen Ihre App verfügbar ist. Wenn Sie Länder angeben möchten, klicken Sie in der angezeigten Liste die Kästchen für die entsprechenden Länder an.
Geben Sie im Feld Titel einen aussagekräftigen Titel für Ihre Anwendung ein.
Die Eingabe darf maximal 50 Zeichen lang sein. Beispiel: „YouTube“.
Geben Sie im Feld Beschreibung eine Beschreibung für Ihre Anwendung ein.
Maximal 80 Zeichen verwenden Beispiel: „Sehen Sie sich Ihre Lieblings-YouTube-Kanäle auf dem größten Bildschirm im Haus an.“
Klicken Sie im Bereich Grafiken auf das Pluszeichen, um das Symbolbild für Ihre Anwendung hochzuladen.
Das Bild muss 512 × 512 Pixel groß sein und darf einen transparenten Hintergrund haben.
Wenn du unter Eigene Übersetzungen hinzufügen Übersetzungen für die Felder Titel und Beschreibung angeben möchtest, wähle die Sprache aus dem Drop-down-Menü aus, klicke auf Hinzufügen und gib den übersetzten Text in das angezeigte Dialogfeld ein. Du kannst auch ein Bild für das Symbol für diese Übersetzung hochladen.
Klicken Sie auf Speichern, wenn Sie die Informationen zu Ihrer App aktualisiert haben.
Veröffentlichen Sie die Anwendung
Wenn Sie Ihre App 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 Eintragsseite chromecast.com/apps erstellt, über die Nutzer Ihre App finden und herunterladen können. Wenn Sie bei der Bearbeitung der App-Informationen in Schritt 6 oben die Option „App auflisten“ ausgewählt 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 Ihre Anwendungsinformationen vollständig sind, wird ein Vorschaubildschirm mit den Anwendungsinformationen angezeigt, die Sie unter Anwendungsinformationen bearbeiten eingegeben haben. Andernfalls wird eine Meldung mit den erforderlichen Informationen angezeigt.
Sie können auf Bearbeiten klicken, um zurückzugehen und Informationen zu aktualisieren.
Wenn Sie Ihre App veröffentlichen möchten, klicken Sie auf Veröffentlichen.
Statistiken
In der Google Cast SDK Developer Console wird die Leistung Ihrer Anwendung erfasst. Auf der Seite „Apps“ oder „Übersicht“ können Sie für jede veröffentlichte Anwendung Leistungsdaten aufrufen, indem Sie in der Spalte Statistiken auf Anzeigen klicken.
Folgende Informationen werden angezeigt:
- Anzahl der Cast-Empfänger, über die die Anwendung gestartet wurde
- Anzahl der gestarteten Sitzungen
- Durchschnittliche Medienwiedergabezeit (in Minuten) pro Sitzung
Wenn in den Statistiken die Plattform Sonstiges angezeigt wird, hat der Absender seine Plattform nicht angegeben. Das kann beispielsweise der Fall sein, wenn ein älterer iOS-Absender nicht aktualisiert wurde.
Geräte
Google Cast-Geräte wie Chromecast oder Android TV sind standardmäßig nicht für die Entwicklung und Tests aktiviert. Wenn du dein Gerät in ein Entwicklungsgerät umwandeln und während der Entwicklung auf deine unveröffentlichte Web-Empfänger-App zugreifen möchtest, musst du das Gerät bei deiner App registrieren. Durch die Registrierung kann der Empfänger auch über ein Remote-Browserfenster für die Fehlerbehebung 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 Ihr Computer.
Weitere Informationen finden Sie in der Einrichtungsanleitung für Streaminggeräte.
Öffnen Sie auf Ihrem Computer einen Webbrowser, der von Google Cast unterstützt wird.
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 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 Ihr Gerät. Er muss nicht mit dem Namen übereinstimmen, den Sie dem Gerät bei der Nutzereinrichtung gegeben haben.
Warten Sie 15 Minuten, bevor Sie fortfahren.
Nach Abschluss der Registrierung lautet der Status des Geräts „Zum Testen bereit“.
Starte dein Streaminggerät neu: Trenne das Strom- oder USB-Kabel vom Gerät und schließe es wieder an.
Seriennummer des Geräts ermitteln
Wenn Sie die Seriennummer eines Geräts ermitteln möchten, können Sie die Seite der Cast Developer Console auf das Gerät streamen:
Klicken Sie auf die Schaltfläche „Streamen“, als würden Sie diese Seite streamen.
Im Prompt wird der Tab „Übertragen“ angezeigt und die verfügbaren Geräte werden aufgelistet.
Wählen Sie im Drop-down-Menü das Gerät aus, für das Sie die Seriennummer abrufen möchten.
- Bei Geräten mit Display wird die Seriennummer auf dem Fernsehbildschirm angezeigt und über die Lautsprecher des Fernsehers vorgelesen, um Nullen und Nullen zu unterscheiden.
- Bei Audiogeräten wird die Seriennummer auf dem Lautsprecher vorgelesen, auf den gestreamt wird.
Seriennummer der Android TV-Software
Android TV-Geräte (ATV) haben mehrere Seriennummern. Die Seriennummer der Software (Cast) kannst du entweder erhalten, indem du die Seite der Cast Developer Console wie oben beschrieben auf das ATV streamst, oder indem du das ATV in den Entwicklermodus versetzt und in den Cast-Einstellungen nach der Seriennummer der Software suchst.
Wenn du deinen Android TV-Stick in den Entwicklermodus versetzen möchtest, gehe zu Einstellungen > System > Über > Android TV-Betriebssystem-Build und klicke mehrmals auf den Build, bis du auf dem Gerät eine Benachrichtigung erhältst, dass du dich im Entwicklermodus befindest. Wenn Sie die Seriennummer im Entwicklermodus aufrufen möchten, gehen Sie je nach ATV-Modell zu Einstellungen > Geräteeinstellungen > Eingebauter Chromecast oder Einstellungen > System > Streamen.
Hinweis: Wenn ein ATV auf die Werkseinstellungen zurückgesetzt wird, ändert sich die Software-Seriennummer. Führe nach dem Zurücksetzen auf die Werkseinstellungen die oben beschriebenen Schritte aus, um die Software-Seriennummer zu finden und die neue Software-Seriennummer des Geräts in der Cast Developer Console neu zu registrieren.
Kontoprobleme
Ich möchte meine Registrierung in der Google Cast Developer Console kündigen
Die Registrierungsgebühr für Entwicklerkonten in Höhe von 5 $ist nicht erstattungsfähig.
Ich kann nicht mehr auf die Google Cast Developer Console zugreifen
Wenn Sie zuvor eine E-Mail von uns erhalten haben, in der steht, dass Ihr Entwicklerkonto aufgrund mehrerer Verstöße gegen unsere Nutzungsbedingungen oder Inhaltsrichtlinien gesperrt wurde, antworten Sie auf diese E-Mail, wenn Sie weitere Erläuterungen benötigen.
Meine App wurde aus Google Cast entfernt
Entfernte Apps werden als Verwarnungen gegen Ihr Entwicklerkonto angesehen, sodass es nicht mehr als einwandfrei gilt. Bei mehreren oder schwerwiegenden Richtlinienverstößen kann Ihr Entwicklerkonto gekündigt werden.
Wenn eine App entfernt wird, können Nutzer sie nicht mehr aufrufen oder darauf zugreifen. Wenn Ihr Entwicklerkonto bei Google Cast noch einwandfrei ist und Ihre Anwendung das zulässt, können Sie Korrekturen vornehmen und eine neue, richtlinienkonforme Instanz der Anwendung veröffentlichen.
Veröffentlichen Sie eine entfernte App 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 E-Mail-Adresse, die mit Ihrem Google Cast-Entwicklerkonto verknüpft ist, nicht ändern. Wenn Sie für eine Organisation arbeiten, empfehlen wir Ihnen, eine Team-E-Mail-Adresse zu verwenden, um Zugriffsprobleme in Zukunft zu vermeiden.
Ich habe ein anderes Problem.
Weitere Informationen finden Sie auf der Supportseite für das Cast SDK.