Une vidéo d'aperçu est un excellent moyen d'encourager les utilisateurs à accéder à votre appli TV via un lien profond. Les aperçus peuvent aller de courts extraits à des bandes-annonces de films complets.
Lorsque vous créez un aperçu, tenez compte des consignes suivantes :
- Ne pas afficher d'annonces dans un aperçu. Si vous assemblez des annonces côté client, ne les assemblez pas dans les vidéos d'aperçu. Si vous insérez des annonces côté serveur, fournissez une vidéo sans publicité pour les aperçus.
- Pour une qualité optimale, les vidéos d'aperçu doivent être au format 16:9 ou 4:3. Consultez Attributs des programmes vidéo pour connaître les tailles recommandées pour les vidéos d'aperçu.
- Lorsque l'aperçu vidéo et l'affiche ont des formats différents, l'écran d'accueil redimensionne la vue de l'affiche au format de la vidéo avant de lire l'aperçu. La vidéo n'est pas au format letterbox. Par exemple, si le ratio de l'affiche est
ASPECT_RATIO_MOVIE_POSTER(1:1,441), mais que le ratio de la vidéo est de 16:9, la vue de l'affiche se transforme en une région 16:9. - Lorsque vous créez un aperçu, son contenu peut être accessible au public ou protégé par DRM. Des procédures différentes s'appliquent dans chaque cas. Cette page décrit les deux.
Lire l'aperçu sur l'écran d'accueil
Si vous créez un aperçu à l'aide de l'un des types de vidéos compatibles avec ExoPlayer et que l'aperçu est accessible au public, vous pouvez le lire directement sur l'écran d'accueil.
Lorsque vous créez un PreviewProgram, utilisez setPreviewVideoUri() avec une URL HTTPS accessible au public, comme illustré dans l'exemple suivant. L'aperçu peut être au format vidéo ou audio.
val previewVideoUrl = Uri.parse("https://www.example.com/preview.mp4") val builder = PreviewProgram.Builder() builder.setChannelId(channelId) // ... .setPreviewVideoUri(previewVideoUrl)
Afficher l'aperçu sur une surface
Si votre vidéo est protégée par DRM ou si elle est dans un type de média non compatible avec ExoPlayer, utilisez un TvInputService. L'écran d'accueil d'Android TV transmet un Surface à votre service en appelant onSetSurface(). Votre application dessine la vidéo directement sur cette surface à partir de onTune().
Le rendu direct de la surface permet à votre application de contrôler ce qui est affiché et comment. Vous pouvez superposer des métadonnées telles que l'attribution des canaux.
Déclarer votre TvInputService dans le fichier manifeste
Votre application doit fournir une implémentation de TvInputService pour que l'écran d'accueil puisse afficher votre aperçu.
Dans votre déclaration de service, incluez un filtre d'intent qui spécifie TvInputService comme action à effectuer avec l'intent. Déclarez également les métadonnées du service en tant que ressource XML distincte. La déclaration de service, le filtre d'intent et la déclaration de métadonnées de service sont présentés dans l'exemple suivant :
<service android:name=".rich.PreviewInputService" android:permission="android.permission.BIND_TV_INPUT"> <!-- Required filter used by the system to launch our account service. --> <intent-filter> <action android:name="android.media.tv.TvInputService" /> </intent-filter> <!-- An XML file which describes this input. --> <meta-data android:name="android.media.tv.input" android:resource="@xml/previewinputservice" /> </service>
Définissez les métadonnées du service dans un fichier XML distinct.
Le fichier de métadonnées du service se trouve dans le répertoire des ressources XML de votre application et doit correspondre au nom de la ressource que vous avez déclarée dans le fichier manifeste. En utilisant les entrées du fichier manifeste de l'exemple précédent, vous créeriez un fichier XML à l'emplacement res/xml/previewinputservice.xml, avec une balise tv-input vide :
<tv-input/>
TV Input Framework doit comporter ce tag. Toutefois, il n'est utilisé que pour configurer les canaux en direct. Comme vous affichez une vidéo, la balise doit être vide.
Créer un URI de vidéo
Pour indiquer que votre vidéo d'aperçu doit être affichée par votre application plutôt que par l'écran d'accueil d'Android TV, vous devez créer un URI vidéo pour un PreviewProgram.
L'URI doit se terminer par l'identifiant que votre application utilise pour le contenu, afin que vous puissiez récupérer le contenu ultérieurement dans le TvInputService.
Si votre identifiant est de type Long, utilisez TvContractCompat.buildPreviewProgramUri() :
val id: Long = 1L // content identifier. val componentName = ComponentName(context, PreviewVideoInputService::class.java) val previewProgramVideoUri = TvContractCompat.buildPreviewProgramUri(id) .buildUpon() .appendQueryParameter("input", TvContractCompat.buildInputId(componentName)) .build()
Si votre identifiant n'est pas de type Long, créez l'URI à l'aide de Uri.withAppendedPath() :
val previewProgramVideoUri = Uri.withAppendedPath(PreviewPrograms.CONTENT_URI, "content-identifier") .buildUpon() .appendQueryParameter("input", TvContractCompat.buildInputId(componentName)) .build()
Votre application appelle onTune(Uri videoUri) pour qu'Android TV lance l'aperçu vidéo.
Créer un service
L'exemple suivant montre comment étendre TvInputService pour créer votre propre PreviewInputService. Notez que le service utilise un MediaPlayer pour la lecture, mais que votre code peut utiliser n'importe quel lecteur vidéo disponible.
// import android.content.Context // import android.media.MediaPlayer // import android.media.tv.TvInputService // import android.net.Uri // import android.util.Log // import android.view.Surface // import java.io.IOException class PreviewVideoInputService : TvInputService() { override fun onCreateSession(inputId: String): TvInputService.Session? { return PreviewSession(this) } private inner class PreviewSession( internal var context: Context ) : TvInputService.Session(context) { internal var mediaPlayer: MediaPlayer? = MediaPlayer() override fun onRelease() { mediaPlayer?.release() mediaPlayer = null } override fun onTune(uri: Uri): Boolean { // Let the TvInputService know that the video is being loaded. notifyVideoUnavailable(VIDEO_UNAVAILABLE_REASON_TUNING) // Fetch the stream url from the TV Provider database // for content://android.media.tv/preview_program/<id>. val id = uri.lastPathSegment // Load your video in the background. retrieveYourVideoPreviewUrl(id) { videoUri -> if (videoUri == null) { Log.d(TAG, "Could not find video $id") notifyVideoUnavailable(TvInputManager.VIDEO_UNAVAILABLE_REASON_UNKNOWN) } try { mediaPlayer?.setDataSource(getApplicationContext(), videoUri) mediaPlayer?.prepare() mediaPlayer?.start() notifyVideoAvailable() } catch (e: IOException) { Log.e(TAG, "Could not prepare media player", e) notifyVideoUnavailable(TvInputManager.VIDEO_UNAVAILABLE_REASON_UNKNOWN) } } return true } override fun onSetSurface(surface: Surface?): Boolean { mediaPlayer?.setSurface(surface) return true } override fun onSetStreamVolume(volume: Float) { // The home screen may fade in and out the video's volume. // Your player should be updated accordingly. mediaPlayer?.setVolume(volume, volume) } override fun onSetCaptionEnabled(b: Boolean) { // enable/disable captions here. } } companion object { private const val TAG = "PreviewInputService" } }