book_path: /distribute/other-docs/_book.yaml project_path: /distribute/other-docs/_project.yaml
Ce guide explique comment commencer à utiliser les intégrations du SDK Engage pour la TV. Une fois que vous aurez effectué les tâches préparatoires sur cette page, vous pourrez intégrer une ou plusieurs des fonctionnalités TV :
- Publier les données "Continuer à regarder"
- Publier des droits d'accès aux appareils
- Publier des recommandations
Travail préalable
Avant de commencer, procédez comme suit :
Faites-nous part de votre intérêt pour le développement de l'API Video Discovery afin de vous inscrire au programme, si vous êtes éligible.
Vérifiez que votre application cible Android 4.4 (niveau d'API 19) ou version ultérieure pour cette intégration.
Ajoutez la bibliothèque
com.google.android.engageà votre application :Il existe des SDK distincts à utiliser pour l'intégration : un pour les applications mobiles et un pour les applications TV.
Mobile
dependencies { implementation 'com.google.android.engage:engage-core:1.5.11' }TV
dependencies { implementation 'com.google.android.engage:engage-tv:1.0.5' }Ajouter l'autorisation pour l'APK
WRITE_EPG_DATApour téléviseur<uses-permission android:name="com.android.providers.tv.permission.WRITE_EPG_DATA" />Vérifiez la publication de contenu fiable à l'aide d'un service en arrière-plan, tel que
androidx.work, pour la planification.Testez votre implémentation à l'aide de l'application de validation, comme indiqué dans la section sur les tests.
Dans votre application de production, définissez l'environnement de service Engage sur "production" dans le fichier
AndroidManifest.xml.<meta-data android:name="com.google.android.engage.service.ENV" android:value="PRODUCTION" />
Procédure d'intégration courante
Initialiser le client
Utilisez AppEngagePublishClient pour interagir avec le service. Vérifiez toujours si le service est disponible avant de publier.
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
}
}
Créer un profil de compte
AccountProfile identifie l'utilisateur. Vous pouvez spécifier un ID de compte, et éventuellement un ID de profil et un code de langue.
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()
Tests
Pour tester votre intégration, téléchargez l'application de validation :
Télécharger l'application de validation
L'application de validation est une application Android qui vous permet de tester votre intégration. Il vous permet de vérifier l'exactitude des données et le bon fonctionnement en validant les données publiées et les intents de diffusion avant le lancement.
- Installez et ouvrez l'application Engage Verification.
- Si la valeur de
isServiceAvailableestfalsedans l'application de validation, cliquez sur le bouton Toggle (Activer/Désactiver) dans l'application de validation pour la définir surtrue. - Saisissez le nom du package de votre application. Les données publiées s'affichent automatiquement.
- Exécutez votre application et effectuez des actions de publication, comme vous connecter ou regarder une vidéo.
- Vérifiez que les données s'affichent dans l'application de validation.
Télécharger
Avant de procéder au téléchargement, vous devez accepter les conditions d'utilisation suivantes.