Registrierung

Du musst deine Anwendung registrieren, wenn du den Styled Media Receiver verwendest oder einen Custom Receiver erstellst. Nachdem du deine Anwendung registriert hast, erhältst du eine Anwendungs-ID, die von deiner Sender-Anwendung verwendet wird, um API-Aufrufe auszuführen, z. B. um eine Web-Receiver-Anwendung zu starten.

Wenn du den Default Media Receiver verwendest, musst du deine Anwendung nicht registrieren. Beim Standard-Media-Receiver können Sie die Benutzeroberfläche des Mediaplayers nicht gestalten. Als Anwendungs-ID wird eine bereitgestellte Konstante verwendet.

Außerdem musst du dein Google Cast-Gerät registrieren, damit es auf deine Web-Receiver-Anwendung zugreifen kann, bevor du sie veröffentlichst. Sobald du deine Empfänger-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 Anwendung 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 Sender-App verwendet wird.

So registrierst du deine Cast-Anwendung:

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

  3. Wähle den Typ der Web-Empfänger-App aus, die du verwenden möchtest:

    • Benutzerdefinierter Empfänger

      Wähle diese Option aus, wenn deine App Komponenten der Benutzeroberfläche oder Interaktionsmuster erfordert, die nicht vom Styled Media Receiver bereitgestellt werden. Die Auswahl eines benutzerdefinierten Empfängers kann auch erforderlich sein, wenn dein Inhaltstyp nicht als einer der unterstützten Medientypen des Styled Media Receivers aufgeführt ist.

      Beachte, dass du für diese Option eine vollständige Web-App für die Web-Empfänger-App erstellen musst.

      Weitere Informationen findest du unter Custom Receiver Application.

    • Styled Media Receiver

      Wähle diese Option aus, wenn deine App Video- oder Audioinhalte mit einem der unterstützten Medientypen streamt und du eine Benutzeroberfläche auf dem Fernseher bereitstellen möchtest, die entweder die Standard-Mediaplayer-Benutzeroberfläche oder eine Reihe von benutzerdefinierten Stilen zusätzlich zur Standard-Mediaplayer-Benutzeroberfläche verwendet.

      Mit den benutzerdefinierten Stilen, die du bereitstellen kannst, kannst du das Aussehen verschiedener Elemente der Player-UI (z. B. Splash Screen und Fortschrittsanzeige) einfach durch Bereitstellen einer CSS-Datei definieren. Du musst keine Empfänger-App erstellen.

      Weitere Informationen findest du unter Styled Media Receiver.

  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 inaktiven Zustand befindet, wenn du den Styled Media Receiver verwendest. Wenn du einen benutzerdefinierten Empfänger verwendest, ist der Wert dieses Felds der Standardwert für den Anwendungsstatus, sofern er nicht mit der Methode setApplicationState festgelegt wurde.

    2. Lege das Erscheinungsbild der Web-Empfänger-App fest:

      • Geben Sie bei einem 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 für eine HTML-Seite oder einen anderen Dateityp sein, auf den über einen Webbrowser zugegriffen werden kann. Der Web-Empfänger kann eine interne (NAT-registrierte) IP-Adresse haben, aber nicht localhost, da dies selten eine Top-Level-Domain ist. Die Web-Empfänger-App muss bei der Veröffentlichung über SSL (HTTPS) bereitgestellt werden. Die in der Web-Empfänger-App geladenen Inhalte können jedoch über HTTP bereitgestellt werden.

      • Gib für einen Styled 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.

      • Setzen Sie ein Häkchen bei Unterstützt Relay-Casting oder lassen Sie das Kästchen leer.

        Mit Relay-Streaming kann dein Web-Receiver das Streaming von Sendern unterstützen, die nicht mit demselben WLAN wie der Receiver verbunden sind. Wenn Sie das Relay-Streaming für Ihren Empfänger deaktivieren möchten, entfernen Sie das Häkchen aus diesem Kästchen.

      • Setzen Sie ein Häkchen bei Unterstützt das Streamen auf reine Audiogeräte oder lassen Sie das Kästchen leer.

        Setze hier ein Häkchen, damit deine App Google Cast-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 findest du unter Audiogeräte.

  5. 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 bei den Cast API-Aufrufen Ihrer Anwendung angeben müssen.

  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 Informationen aktualisieren, die Sie bei der Registrierung zu Ihrer Anwendung angegeben haben.

So bearbeiten Sie die Informationen zur Anwendung:

  1. Klicke in der Google Cast SDK Developer Console entweder auf der Seite Übersicht oder auf der Seite Anwendungen auf die Anwendungs-ID oder klicke für die Anwendung, die du bearbeiten möchtest, auf Bearbeiten.
  2. Aktualisieren Sie im Feld Name den Namen, den Sie bei der Registrierung der Anwendung angegeben haben.
  3. Aktualisiere bei benutzerdefinierten Empfänger-Apps im Feld URL den Speicherort der registrierten Web-Empfänger-App.
  4. Aktualisiere bei Styled Receiver-Anwendungen im Feld Skin-URL den Speicherort des Stylesheets deiner Anwendung.

  5. Setzen Sie ein Häkchen bei Unterstützt Relay-Casting oder lassen Sie das Kästchen leer.

    Mit Relay-Streaming kann dein Web-Empfänger das Streaming von Sendern unterstützen, die nicht mit demselben WLAN wie der Empfänger verbunden sind. Wenn Sie das Relay-Streaming für Ihren Empfänger deaktivieren möchten, entfernen Sie das Häkchen aus diesem Kästchen.

  6. Setze oder entferne das Häkchen bei Unterstützt das Streamen auf Nur-Audio-Geräte.

    Setzen Sie hier ein Häkchen, 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 findest du unter Audiogeräte.

  7. Geben Sie im Abschnitt Sender Details (Absenderdetails) für jede Plattform, die Ihre App unterstützt, Folgendes an:

    • Android:

      • den vollständig qualifizierten Namen Ihres Anwendungspakets.

    • iOS:

      • die von Apple erforderliche iTunes-ID und Paket-ID.
      • den App-Start-URI, wobei der URI verwendet wird, den die Google Home App zum Starten deiner App verwendet. 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.

  8. Wählen Sie im Abschnitt Eintragsdetails aus, ob Ihre Anwendung auf Google-Produkten wie chromecast.com/apps aufgeführt werden soll.

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

    Hinweis: Deine App muss die hier beschriebenen Medientypen sowie 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 Audiogeräte wie unter Audiogeräte beschrieben sowie die Bestimmungen für die Videowiedergabe unterstützen.

  10. Wähle entweder das Optionsfeld Alle Länder oder Nur in ausgewählten Ländern aus, um die Länder anzugeben, in denen deine App verfügbar ist. Wenn du Länder angibst, klicke 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 Anwendung ein.

    Verwenden Sie maximal 50 Zeichen. Beispiel: „YouTube“.

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

    Verwenden Sie maximal 80 Zeichen. Beispiel: „Genieße deine Lieblings-YouTube-Kanäle auf dem besten Bildschirm im Haus.“

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

  14. Wenn Sie unter Eigene Übersetzungen hinzufügen Übersetzungen für die Felder Titel und Beschreibung bereitstellen 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.

  15. Wenn Sie die Informationen zu Ihrer App aktualisiert haben, klicken Sie auf Speichern.

Veröffentlichen Sie die Anwendung

Wenn du deine Anwendung veröffentlichst, ist sie auf allen Cast-Geräten weltweit verfügbar. Außerdem wird ein Eintrag für deine Anwendung in Google-Produkten wie der Website chromecast.com/apps erstellt, auf der Nutzer deine App finden und herunterladen können. Wenn du deine App beim Bearbeiten der Anwendungsinformationen in Schritt 6 oben in die Liste aufgenommen hast, wird sie nach der Veröffentlichung unter chromecast.com/apps angezeigt.

So veröffentlichen Sie Ihre Anwendung:

  1. Klicke in der Google Cast SDK Developer Console entweder auf der Seite Übersicht oder auf der Seite Anwendungen für die Anwendung, die du veröffentlichen möchtest, auf Veröffentlichen.

    Wenn die Informationen zu Ihrer Anwendung vollständig sind, wird ein Vorschaubildschirm mit den Informationen angezeigt, die Sie unter Anwendungsinformationen bearbeiten eingegeben haben. Andernfalls wird eine Meldung mit den erforderlichen Informationen angezeigt.

  2. Sie können auf Bearbeiten klicken, um zurückzugehen und Informationen zu aktualisieren.

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

Statistiken

In der Google Cast SDK Developer Console wird die Leistung deiner Anwendung erfasst. 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 Cast-Empfänger, die die Anwendung gestartet haben
  • Anzahl der gestarteten Sitzungen
  • Durchschnittliche Medienwiedergabezeit (in Minuten) pro Sitzung

Wenn in den Statistiken die Plattform Sonstige angezeigt wird, bedeutet das, dass der Sender seine Plattform nicht angegeben hat, z. B. wenn ein älterer iOS-Sender nicht aktualisiert wurde.

Geräte

Standardmäßig sind Google Cast-Geräte (z. B. Chromecast oder Android TV-Geräte) nicht für die Entwicklung und das Testen aktiviert. Wenn du dein Gerät in ein Entwicklungsgerät umwandeln und während der Entwicklung Zugriff auf deine unveröffentlichte Web-Empfänger-App erhalten möchtest, musst du das Gerät bei deiner App registrieren. Durch die Registrierung kann der Empfänger auch über ein Remote-Browserfenster zum Debuggen aufgerufen werden (siehe Debugging).

So registrierst du dein Google Cast-Gerät:

  1. Richte dein Google Cast-Gerät ein und verbinde es mit demselben WLAN wie deinen Computer.

    Weitere Informationen findest du in der Anleitung zum Einrichten von Cast-Geräten.

  2. Öffne auf deinem Computer einen von Google Cast unterstützten Webbrowser.

  3. Melde dich in der Google Cast SDK Developer Console an.

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

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

  6. Gib die Seriennummer deines Geräts ein.

  7. Geben Sie eine Beschreibung ein und klicken Sie auf OK.

    Dies ist nur ein nutzerfreundlicher Name für Ihr Gerät. Er muss nicht mit dem Namen übereinstimmen, den Sie dem Gerät bei der Einrichtung gegeben haben.

  8. Warten Sie 15 Minuten, bevor Sie fortfahren.

    Nach Abschluss der Registrierung lautet der Status des Geräts „Bereit zum Testen“.

  9. Starte dein Cast-Gerät neu: Trenne das Strom- oder USB-Kabel vom Gerät und schließe es wieder an.

Seriennummer des Geräts finden

So findest du die Seriennummer eines Geräts: Du kannst die Seite der Cast Developer Console auf das Gerät streamen:

  1. Klicke auf das Cast-Symbol (als ob du diese Seite streamen würdest).

    In der Aufforderung wird Tab streamen angezeigt und die verfügbaren Geräte werden aufgelistet.

  2. 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 Fernsehlautsprecher vorgelesen, um Verwechslungen zwischen Nullen und dem Buchstaben „O“ zu vermeiden.
    • 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 Software-Seriennummer (Cast) kann entweder durch Streamen der Seite der Cast Developer Console auf das ATV-Gerät (wie oben beschrieben) oder durch Versetzen des ATV-Geräts in den Entwicklermodus und Suchen der Software-Seriennummer in den Cast-Einstellungen abgerufen werden.

Wenn du dein ATV-Gerät in den Entwicklermodus versetzen möchtest, rufe Einstellungen > System > Info > Android TV-Betriebssystem-Build auf und klicke mehrmals auf den Build, bis das Gerät dich darüber informiert, dass du dich im Entwicklermodus befindest. Wenn du dich im Entwicklermodus befindest, kannst du die Seriennummer finden, indem du je nach ATV-Modell entweder zu Einstellungen > Geräteeinstellungen > Google Cast oder zu Einstellungen > System > Cast gehst. Dort wird die Seriennummer der Software angezeigt.

Beachte, dass sich die Software-Seriennummer ändert, wenn ein ATV-Gerät auf die Werkseinstellungen zurückgesetzt wird. Nach dem Zurücksetzen auf die Werkseinstellungen musst du die oben genannten Schritte ausführen, um die Software-Seriennummer zu finden und die neue Software-Seriennummer des Geräts in der Cast Developer Console zu registrieren.

Kontoprobleme

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

Die Registrierungsgebühr für Entwicklerkonten in Höhe von 5 $ kann nicht erstattet werden.

Ich kann nicht mehr auf die Google Cast Developer Console zugreifen.

Wenn du bereits eine E-Mail von uns erhalten hast, in der du darüber informiert wurdest, dass dein Entwicklerkonto aufgrund mehrerer Verstöße gegen unsere Nutzungsbedingungen oder Inhaltsrichtlinien gesperrt wurde, antworte auf diese E-Mail, wenn du weitere Informationen benötigst.

Meine App wurde aus Google Cast entfernt

Entfernte Apps werden als Verwarnungen gegen Ihr Entwicklerkonto angesehen, sodass es nicht mehr als einwandfrei gilt. Mehrfache oder schwerwiegende Richtlinienverstöße können zur Kündigung Ihres Entwicklerkontos führen.

Wenn eine Anwendung entfernt wird, können Nutzer sie nicht mehr aufrufen oder darauf zugreifen. Sollte dein Entwicklerkonto bei Google Cast bisher noch einen einwandfreien Status haben und sollte dies in deiner App möglich sein, kannst du Korrekturen vornehmen und eine neue, richtlinienkonforme Version der App 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.

Du kannst die mit deinem 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 künftige Zugriffsprobleme zu vermeiden.

Ich habe ein anderes Problem.

Weitere Informationen findest du auf der Supportseite für das Cast SDK.