Anmeldung

Sie müssen Ihre Anwendung registrieren, wenn Sie den Styled Media Receiver verwenden oder einen benutzerdefinierten Empfänger erstellen. Nachdem Sie Ihre Anwendung registriert haben, erhalten Sie eine Anwendungs-ID, die von Ihrer Senderanwendung für API-Aufrufe wie z. B. zum Starten einer Web Receiver-Anwendung verwendet wird.

Wenn Sie den Standard-Medienempfänger verwenden, müssen Sie Ihre Anwendung nicht registrieren. Mit dem Standard-Mediaempfänger können Sie keine Stile für die Benutzeroberfläche des Mediaplayers festlegen. Er verwendet eine angegebene Konstante als Anwendungs-ID.

Außerdem müssen Sie Ihr Google Cast-Gerät registrieren, damit es vor der Veröffentlichung auf Ihren Web Receiver zugreifen kann. Nachdem du deine 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 Übertragungsgerät testen. Durch die Veröffentlichung wird die App für alle Übertragungsgeräte verfügbar gemacht.

Anwendung registrieren

Sie müssen einen Styled Media Receiver oder einen benutzerdefinierten Empfänger registrieren, um eine Anwendungs-ID zu erhalten, die mit API-Aufrufen von der Senderanwendung verwendet wird.

So registrieren Sie Ihre Cast App:

  1. Melden Sie sich in der Google Cast SDK Developer Console an.
  2. Klicken Sie auf der Seite Übersicht oder Anwendungen auf Neue Anwendung hinzufügen.

  3. Wählen Sie den Typ der Web Receiver-App aus, den Sie verwenden möchten:

    • Benutzerdefinierter Empfänger

      Wählen Sie diese Option aus, wenn für Ihre App Komponenten der Benutzeroberfläche oder Interaktionsmuster erforderlich sind, die vom Styled Media Receiver nicht bereitgestellt werden. Die Auswahl von „Benutzerdefinierter Empfänger“ kann auch erforderlich sein, wenn Ihr Inhaltstyp nicht als einer der unterstützten Medientypen von Styled Media Receiver aufgeführt ist.

      Beachten Sie, dass Sie für diese Option eine vollständige Webanwendung für die Web Receiver-App erstellen müssen.

      Weitere Informationen

    • Empfänger für benutzerdefinierte Medien

      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 über der Standard-Mediaplayer-UI verwendet.

      Mit den benutzerdefinierten Stilen kannst du das Aussehen verschiedener Elemente der Player-UI (z. B. Ladebildschirm und Fortschrittsanzeige) ganz einfach über eine CSS-Datei definieren. Du musst keine Empfänger-App erstellen.

      Weitere Informationen

  4. Geben Sie die Details für Ihre Web Receiver-App ein:

    1. Geben Sie im Feld Name den Namen Ihrer App ein.

      Dies ist der Name der Anwendung, der angezeigt wird, wenn der Web Receiver geladen wird oder sich im Ruhezustand befindet, wenn Sie Styled Media Receiver verwenden. Wenn Sie einen benutzerdefinierten Empfänger verwenden, ist der Wert dieses Felds der Standardwert für den Anwendungsstatus, falls er nicht mit der Methode setApplicationState festgelegt wurde.

    2. Darstellung der Web Receiver-App festlegen:

      • Geben Sie für einen benutzerdefinierten Empfänger im Feld URL die App-URL ein.

        Gib eine URL ein, die das Google Cast-Gerät beim Laden deiner Web Receiver-App anfordern soll. Während der Entwicklung kann für die URL HTTP verwendet werden, bei der Veröffentlichung der App muss HTTPS jedoch verwendet werden. Die URL kann für eine HTML-Seite oder einen anderen Dateityp führen, auf den über einen Webbrowser zugegriffen werden kann. Ihr Webempfänger muss sich an einer internen (NAT-registrierten) IP-Adresse befinden, 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-Anwendung geladenen Inhalte auch ü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 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 Ihre benutzerdefinierten Stile bereitstellen oder aktualisieren möchten.

      • Aktivieren oder deaktivieren Sie das Kästchen Unterstützt Relay-Streaming.

        Durch das 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 Ihren Empfänger zu deaktivieren.

      • Klicken Sie das Kästchen Unterstützt das Streamen an Nur-Audio-Geräte an oder lassen Sie das Kästchen deaktiviert.

        Klicken Sie dieses Kästchen an, damit Ihre App Google Cast für Audiogeräte erkennen kann. Um die Unterstützung für Nur-Audio-Geräte zu deaktivieren, entfernen Sie das Häkchen. Weitere Informationen finden Sie unter Audiogeräte.

  5. Klicken Sie auf Speichern.

    Ihre Registrierungsdetails, einschließlich Anwendungs-ID, Name, Typ und Status, werden angezeigt. Notieren Sie sich die App-ID. Sie erhalten sie für die Cast API-Aufrufe Ihrer App.

  6. 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. Sie können auch die Angaben aktualisieren, die Sie bei der Registrierung zu Ihrem Antrag gemacht haben.

So bearbeiten Sie die Anwendungsinformationen:

  1. Klicken Sie in der Google Cast SDK-Entwicklerkonsole auf der Seite Übersicht oder Anwendungen auf die Anwendungs-ID oder auf Bearbeiten für die App, die Sie bearbeiten möchten.
  2. Aktualisieren Sie im Feld Name den Namen, den Sie bei der Registrierung der Anwendung angegeben haben.
  3. Aktualisieren Sie bei Anwendungen für benutzerdefinierte Empfänger im Feld URL den Speicherort der registrierten Web-Empfänger-Anwendung.
  4. Aktualisieren Sie für Styled Receiver-Anwendungen im Feld Skin URL (Skin-URL) den Speicherort des Stylesheets der Anwendung.

  5. Aktivieren oder deaktivieren Sie das Kästchen Unterstützt Relay-Streaming.

    Durch das 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 Ihren Empfänger zu deaktivieren, entfernen Sie das Häkchen aus diesem Kästchen.

  6. Aktivieren oder deaktivieren Sie das Kästchen Unterstützt das Streamen an Nur-Audio-Geräte.

    Klicken Sie dieses Kästchen an, damit Ihre App Google Cast für Audiogeräte erkennt. Entfernen Sie das Häkchen, um die Unterstützung für Audiogeräte zu deaktivieren. Weitere Informationen finden Sie unter Audiogeräte.

  7. Geben Sie im Abschnitt Absenderdetails für jede Plattform, die von Ihrer Anwendung unterstützt wird, folgende Daten an:

    • Android:

      • den voll qualifizierten Namen Ihres Anwendungspakets enthält.

    • iOS:

    • Web:

      • die Website-URL für Ihre Anwendung.

  8. Wählen Sie im Abschnitt Liste der Details aus, ob Ihre Anwendung in Google-Produkten wie chromecast.com/apps. angezeigt werden soll.

  9. Wählen Sie im Drop-down-Menü Kategorie die Kategorie aus, die Ihre Anwendung am besten beschreibt.

    Hinweis:Ihre Anwendung muss die hier beschriebenen und durch andere Einstellungen implizierten Medientypen unterstützen. Wenn Ihre App beispielsweise Google Cast für Audio unterstützt und Sie hier „TV & Filme“ auswählen, muss Ihre App wie unter Audiogeräte beschrieben auch Nur-Audio-Geräte sowie die Bestimmungen für die Videowiedergabe unterstützen.

  10. Wählen Sie zum Beschreiben der Länder, in denen Ihre App verfügbar ist, das Optionsfeld Alle Länder oder Nur in ausgewählten Ländern aus. Wenn Sie Länder angeben möchten, klicken Sie die Kästchen für diese Länder in der angezeigten Liste an.

  11. Geben Sie im Feld Titel einen aussagekräftigen Titel für Ihre Bewerbung ein.

    Maximal 50 Zeichen möglich. Beispiel: „YouTube“.

  12. Geben Sie im Feld Beschreibung eine Beschreibung für Ihre Anwendung ein.

    Maximal 80 Zeichen möglich. Beispiel: „Genieße deine Lieblings-YouTube-Kanäle auf dem besten Bildschirm zu Hause.“

  13. 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 darf einen transparenten Hintergrund haben.

  14. 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.

  15. Nachdem Sie die Informationen aktualisiert haben, klicken Sie auf Speichern.

Anwendung veröffentlichen

Durch die Veröffentlichung wird Ihre App für alle Übertragungsgeräte weltweit verfügbar. Außerdem wird ein Eintrag für Ihre Anwendung in Google-Produkten wie der Eintragswebsite chromecast.com/apps erstellt. Wenn Sie Ihre App beim Bearbeiten der App-Informationen oben in Schritt 6 aufgeführt haben, wird sie nach der Veröffentlichung unter chromecast.com/apps angezeigt.

So veröffentlichen Sie Ihre App:

  1. Klicken Sie in der Google Cast SDK-Entwicklerkonsole auf der Seite Übersicht oder Anwendungen für die zu veröffentlichende App auf Veröffentlichen.

    Wenn die Anwendungsdaten vollständig sind, wird ein Vorschaubildschirm mit den Anwendungsdaten angezeigt, die Sie unter App-Informationen bearbeiten eingegeben haben. Andernfalls wird eine Meldung mit den erforderlichen Informationen angezeigt.

  2. Klicken Sie auf Bearbeiten, um zurückzugehen und Informationen zu aktualisieren.

  3. Wenn Sie bereit sind, Ihre App zu veröffentlichen, klicken Sie auf Veröffentlichen.

Statistiken

Die Google Cast SDK-Entwicklerkonsole erfasst die Leistung Ihrer App. Für jede veröffentlichte Anwendung auf der Seite „Anwendungen“ oder „Übersicht“ können Sie Leistungsdaten aufrufen, indem Sie in der Spalte Statistiken auf Anzeigen klicken.

Folgende Informationen werden angezeigt:

  • Anzahl der Streamingempfänger, über die die App gestartet wurde
  • Anzahl der gestarteten Sitzungen
  • Durchschnittliche Medienwiedergabezeit (in Minuten) pro Sitzung

Wenn in der Statistik eine andere Plattform 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 Android TV sind standardmäßig nicht für 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 kann der Empfänger zur Fehlerbehebung über ein Remote-Browserfenster aufgerufen werden (siehe Fehlerbehebung).

So registrieren Sie Ihr Google Cast-Gerät:

  1. Richten Sie Ihr Google Cast-Gerät ein und verbinden Sie es mit demselben WLAN wie Ihren Computer.

    Weitere Informationen finden Sie unter Übertragungsgerät einrichten.

  2. Öffnen Sie auf Ihrem Computer einen für Google Cast unterstützten Webbrowser.

  3. Melden Sie sich in der Google Cast SDK Developer Console an.

  4. Suchen Sie die Seriennummer des Geräts, das Sie registrieren möchten.

  5. Klicken Sie entweder auf der Übersichtsseite oder auf der Seite „Geräte“ auf Neues Gerät hinzufügen.

  6. Geben Sie die Seriennummer Ihres Geräts ein.

  7. 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 Nutzereinrichtung gegeben hast.

  8. Warten Sie 15 Minuten, bevor Sie fortfahren.

    Sobald die Registrierung abgeschlossen ist, lautet der Status des Geräts "Bereit zum Testen".

  9. Starte das Übertragungsgerät neu: Trenne es von der Stromversorgung oder vom USB-Kabel und schließe es dann wieder an.

Seriennummer des Geräts ermitteln

Um die Seriennummer eines Geräts zu ermitteln, streamen Sie die Cast Developer Console-Seite auf das Gerät:

  1. Klicken Sie auf das Cast-Symbol (als würden Sie diese Seite streamen).

    Die Aufforderung zeigt Tab streamen und die verfügbaren Geräte an.

  2. 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 Lautsprechern des Fernsehers vorgelesen, um Nullen und O zu unterscheiden.
    • Bei Audiogeräten wird die Seriennummer auf dem Lautsprecher vorgelesen, auf den gestreamt wird.

Seriennummer der Android TV-Software

Android TV-Geräten haben mehrere Seriennummern. Die Seriennummer der Software (Cast) erhalten Sie, indem Sie entweder die Seite der Cast Developer Console auf das ATV-Gerät übertragen (siehe oben) oder das ATV-Gerät in den Entwicklermodus versetzen und in den Cast-Einstellungen nach der Software-Seriennummer suchen.

Wenn du dein ATV-Gerät in den Entwicklermodus versetzen möchtest, rufe Einstellungen > System > Info > Android TV-Build auf und klicke mehrmals auf den Build, bis du vom Gerät benachrichtigt wirst, dass du dich im Entwicklermodus befindest. Die Seriennummer finden Sie im Entwicklermodus unter Einstellungen > Geräteeinstellungen > Integrierte Chromecast-Technologie oder Einstellungen > System > Streamen. Die Seriennummer wird je nach ATV-Modell 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 finden, und registrieren Sie die neue Seriennummer des Geräts noch einmal in der Cast-Entwicklerkonsole.

Kontoprobleme

Ich möchte meine Registrierung für die Google Cast Developer Console abbrechen.

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.

Wenn Sie bereits eine E-Mail von uns 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, falls Sie weitere Informationen 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.

Das Entfernen bedeutet, dass Nutzer die entfernte Anwendung nicht mehr sehen oder aufrufen können. Wenn Ihre Entwickleranmeldedaten einwandfrei sind und die Art Ihrer App dies zulässt, können Sie Korrekturen vornehmen und eine neue konforme Instanz der App 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 E-Mail-Adresse, die mit Ihrem Google Cast-Entwicklerkonto verknüpft ist, nicht ändern. Wenn Sie für eine Organisation arbeiten, empfehlen wir, eine Team-E-Mail-Adresse zu verwenden, um zukünftige Zugriffsprobleme zu vermeiden.

Ich habe ein anderes Problem.

Weitere Informationen finden Sie auf der Supportseite für das Cast SDK.