book_path: /distribute/other-docs/_book.yaml project_path: /distribute/other-docs/_project.yaml
In diesem Leitfaden erfahren Sie, wie Sie mit der Integration des Engage SDK für Fernseher beginnen. Nachdem Sie die Vorbereitungen auf dieser Seite abgeschlossen haben, können Sie eine oder mehrere der TV-Funktionen integrieren:
- Daten zu „Weiter ansehen“ veröffentlichen
- Device Entitlements veröffentlichen
- Empfehlungen veröffentlichen
Vorbereitung
Führen Sie zuerst die folgenden Schritte aus:
Bekunden Sie Ihr Interesse an der Entwicklung der Video Discovery API, um sich für das Programm zu registrieren, sofern Sie die Voraussetzungen erfüllen.
Prüfen Sie, ob Ihre App für diese Integration auf Android 4.4 (API‑Level 19) oder höher ausgerichtet ist.
Fügen Sie Ihrer App die
com.google.android.engage-Bibliothek hinzu:Für die Integration gibt es separate SDKs: eines für mobile Apps und eines für TV-Apps.
Mobilgerät
dependencies { implementation 'com.google.android.engage:engage-core:1.5.11' }TV
dependencies { implementation 'com.google.android.engage:engage-tv:1.0.5' }Berechtigung für
WRITE_EPG_DATAfür TV-APK hinzufügen<uses-permission android:name="com.android.providers.tv.permission.WRITE_EPG_DATA" />Verwenden Sie einen Hintergrunddienst wie
androidx.work, um die zuverlässige Veröffentlichung von Inhalten zu planen.Testen Sie Ihre Implementierung mit der Überprüfungs-App, wie im Abschnitt „Testen“ beschrieben.
Legen Sie in der
AndroidManifest.xml-Datei Ihrer Produktions-App die Engage-Dienstumgebung auf „production“ fest.<meta-data android:name="com.google.android.engage.service.ENV" android:value="PRODUCTION" />
Allgemeine Integrationsschritte
Client initialisieren
Verwenden Sie AppEngagePublishClient, um mit dem Dienst zu interagieren. Prüfen Sie vor der Veröffentlichung immer, ob der Dienst verfügbar ist.
val client = AppEngagePublishClient(context)
client.isServiceAvailable().addOnCompleteListener { task ->
if (task.isSuccessful && task.result) {
// Service is available, proceed with publishing
} else {
// Service is not available or call failed
}
}
Kontoprofil erstellen
AccountProfile identifiziert den Nutzer. Sie können eine Konto-ID und optional eine Profil-ID und ein Gebietsschema angeben.
val accountProfile = AccountProfile.Builder()
.setAccountId("your_users_account_id")
.setProfileId("your_users_profile_id") // Optional
.setLocale(Locale.US.toLanguageTag()) // Optional, e.g., "en-US"
.build()
Testen
Laden Sie die Überprüfungs-App herunter, um Ihre Integration zu testen:
App zur Bestätigung des Downloads herunterladen
Die Bestätigungs-App ist eine Android-App, mit der Sie Ihre Integration testen können. Damit können Sie die Datengenauigkeit und die ordnungsgemäße Funktion überprüfen, indem Sie veröffentlichte Daten und Broadcast-Intents vor dem Start prüfen.
- Installieren und öffnen Sie die Engage Verification App.
- Wenn der Wert von
isServiceAvailablein der Bestätigungs-Appfalseist, klicken Sie in der Bestätigungs-App auf die Schaltfläche Umschalten, um ihn auftruezu setzen. - Geben Sie den Paketnamen Ihrer App ein. Die veröffentlichten Daten werden automatisch angezeigt.
- Führen Sie Ihre App aus und führen Sie Veröffentlichungsaktionen aus, z. B. die Anmeldung oder die Wiedergabe eines Videos.
- Prüfen Sie, ob die Daten in der Bestätigungs-App angezeigt werden.
Herunterladen
Bevor Sie herunterladen können, müssen Sie den folgenden Nutzungsbedingungen zustimmen.