Command and Control (CaC)-Tool

Das Command and Control (CaC)-Tool ist ein funktionsfähiger Websender, mit dem Entwickler eine Web Receiver-Anwendung testen und Fehler beheben können.

Entwickler können das CaC-Tool für Folgendes verwenden:

• Starten Sie eine Web Receiver App auf einem für Google Cast optimierten Gerät und senden Sie eine Ladeanfrage, um die Medienwiedergabe zu starten.
• Simulierte Sprachbefehle, die von Google Assistant an den Webempfänger gesendet werden.
• Erfassen Sie Logs aus dem Cast Debug Logger und steuern Sie das Debugging-Overlay von Web Receiver.

Web Receiver App starten

Es gibt zwei Möglichkeiten, den Web Receiver mit dem CaC-Tool zu starten:

1. So starten Sie eine neue Streamingsitzung:

   1. Öffnen Sie das CaC-Tool, geben Sie die App-ID des Webempfängers ein und klicken Sie auf die Schaltfläche APP-ID FESTLEGEN.

   2. Klicken Sie auf das Cast-Symbol und wählen Sie ein Gerät aus, um den Webempfänger auf einem Remote-fähigen Gerät zu starten.

      

2. So nehmen Sie an einer bestehenden Streamingsitzung teil:

   1. Rufen Sie die laufende Cast-Sitzungs-ID mit den folgenden Codes ab:

      Verwenden Sie auf der Seite „Webempfänger“ die folgende Methode, um in der Konsole von Chrome Remote Debugger eine Sitzungs-ID abzurufen:

      cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;
      

      Alternativ können Sie die Sitzungs-ID von einem verbundenen Websender abrufen. Verwenden Sie dazu die folgende Methode:

      cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();
      

   2. Geben Sie die Sitzungs-ID in das CaC-Tool ein und klicken Sie auf die Schaltfläche FORTSETZEN.

      

Wenn das CaC-Tool mit der Web Receiver App verbunden ist, wird das Cast-Symbol mit einem ausgefüllten Frame angezeigt. Die Web Receiver-App-ID und die Sitzungs-ID werden ebenfalls oben im Tool angezeigt.

Medien laden

Laden Sie Medien über die Absender-App oder das CaC-Tool.

Absender-App

Um die Medienwiedergabe auf Ihrem Web Receiver zu starten, streamen Sie die Absender-App auf dasselbe Cast-fähige Gerät und senden Sie eine Ladeanfrage von Ihrer Absender-App an den Web Receiver.

Hinweis: Die Absender-App muss dieselbe Anwendungs-ID für den Webempfänger wie im CaC-Tool verwenden.

CaC-Tool

Das CaC-Tool bietet auch mehrere Möglichkeiten, eine Ladeanfrage an die Web Receiver App zu senden:

Nach Entität laden (Sprachstreaming)

Wenn Nutzer die Medienwiedergabe über Google Assistant starten, verwendet Google Assistant Command-Control-Nachrichten (CaC), um Anmeldedaten und Elemente von Nutzern an Ihren Webempfänger zu senden.

Das CaC-Tool simuliert das Streamen und sendet eine Ladeanfrage mit credentials und entity.

Nach Inhalt laden

Das CaC-Tool kann auch simulieren, dass Ihre Anwendung eine Ladeanfrage mit Content ID oder Content Url sendet.

Hinweis: Wir empfehlen, bei der Implementierung sowohl für die Absender- als auch für die Web-Receiver-Apps entity zu verwenden. Weitere Informationen finden Sie unter Tipp: Medien mithilfe von „contentId“, „contentUrl“ und „entity“ laden.

Wenn eine Medienwiedergabe gestartet wird, empfängt das CaC-Tool Medienstatusmeldungen von Ihrer Web Receiver App und zeigt sie auf dem Tab Medienstatus an.

Benutzerdefinierte Ladeanfrage

Wenn Sie Ihren Empfänger mit Ihren eigenen Load Request-Objekten testen möchten, verwenden Sie das Feld Benutzerdefinierte Ladeanfrage auf dem Tab LAST MEDIA. Wählen Sie zuerst aus den Optionsfeldern unter Select Request Type den Anfragetyp aus und fügen Sie dann ein eigenes JSON-Objekt ein.

Hinweis: Der Editor unterstützt die Verwendung der Taste Tab zum Einrücken und Formatieren.

Sprachbefehle testen

Das CaC-Tool simuliert auch Sprachbefehle, die von Google Assistant an Ihre Web Receiver App gesendet werden. Sie können testen, ob die von Ihrer App unterstützten Medienbefehle ordnungsgemäß funktionieren. Nicht unterstützte Medienbefehle müssen mit den entsprechenden Fehlertypen und Fehlerursachen behandelt werden.

Cast Debug-Protokollierung prüfen und steuern

Wenn Ihre Web Receiver App Cast Debug Logger aktiviert, erfasst das CaC-Tool die Lognachrichten und steuert das Web Receiver Debug-Overlay.

Mit den folgenden Schaltflächen können Sie den Webempfänger steuern und Meldungen protokollieren:

• Web Receiver App-ID
  • Cache leeren und Webempfänger beenden – Laden Sie die Web Receiver App neu und beenden Sie das Streamen.
• Debug-Overlay für Webempfänger
  • Anzeigen: Einblenden des Debug-Overlays auf dem Web Receiver
  • Löschen: Protokollmeldungen im Debug-Overlay des Webempfängers löschen
• Steuerelemente für Lognachrichten
  • Nachricht einfügen: Hier werden Kommentare oder Trennlinien in den Protokollbereich eingefügt.
  • Protokoll herunterladen: Protokollmeldungen speichern
  • Clear Log (Protokoll löschen): Protokolleinträge im Logbereich löschen
• Meldungen protokollieren
  • Benutzerdefinierte Tags: Klicken Sie das Kästchen an, um Protokollmeldungen zu filtern.

Folgende Tags können unter Benutzerdefinierte Tags erscheinen. Diese werden vom Caa Tool hinzugefügt, um wichtige Logs oder Nachrichten zur Fehlerbehebungssitzung anzuzeigen und zu filtern:

• MEDIA: Nachrichten, die über den Media-Namespace gesendet wurden
• MEDIA-ERROR: Beim Senden oder als Antwort auf Nachrichten, die über den Media-Namespace gesendet wurden, ist ein Fehler aufgetreten.
• CAC: Nachrichten, die über den CAC-Namespace gesendet wurden
• CAC-ERROR: Beim Senden oder als Antwort auf Nachrichten, die über den CAC-Namespace gesendet wurden, ist ein Fehler aufgetreten
• PLAYING: Protokoll, in dem das Ergebnis angezeigt wird, wenn im CaC-Tool auf die Schaltfläche Was läuft? geklickt wird.
• USER – Log, das die vom Nutzer eingegebene benutzerdefinierte Nachricht mit der Schaltfläche Nachricht einfügen im CaC-Tool anzeigt

Cast Connect testen

Führen Sie vor dem Einrichten einer Sitzung die folgenden Schritte aus, um Cast Connect zu testen:

1. Geben Sie die Empfänger-App-ID ein, die Ihrem für Cast Connect aktivierten Empfänger zugeordnet ist, und klicken Sie auf App-ID festlegen.
2. Klicke auf die Schaltfläche Android TV-Optionen anzeigen.
3. Klicken Sie das Kästchen androidReceivercompatible an. Wenn für Ihren Empfänger Launch Credentials nicht festgelegt werden muss oder Sie testen möchten, was passiert, wenn es nicht festgelegt ist, können Sie hier aufhören und mit Schritt 5 fortfahren.
4. Optional: Geben Sie den Launch Credentials ein und klicken Sie auf die Schaltfläche Anmeldedaten für den Start festlegen, um die Anmeldedaten für die Cast Connect-Sitzung festzulegen.
5. Starten Sie eine Streamingsitzung. Klicken Sie dazu in der Kopfzeile auf das Cast-Symbol oder im Chrome-Browser auf das Cast-Menü.

Ihre Android TV App sollte jetzt auf Ihrem Gerät gestartet werden.

Hinweis: CaC Tool kann keine Protokolle von Ihrem Android TV-Gerät abrufen. Wenn Sie Fehler in Ihrer Android TV-App beheben und relevante Logs ansehen möchten, verwenden Sie adb über Ihr Terminal oder Android Studio, wie Sie es normalerweise tun, um auf die Logs zuzugreifen und Fehler in der App zu beheben.