CustomRenderersFactory.java

This code is part of an Android project using ExoPlayer, a library for media playback. It defines a CustomRenderersFactory class that customizes how ExoPlayer creates video renderers.

Code Explanation

1. Definition and Role of the Class

The CustomRenderersFactory class inherits from DefaultRenderersFactory, which is responsible for creating various types of renderers (audio, video, text) for ExoPlayer.

Its role is to replace the default video renderer management to use only CustomMediaCodecVideoRenderer, a custom video renderer.

2. Constructor

public CustomRenderersFactory(final Context context) {
    super(context);
}
  • It simply calls the parent class constructor DefaultRenderersFactory.
  • context is the Android context required to fetch resources.

3. Overriding buildVideoRenderers

@Override
protected void buildVideoRenderers(final Context context,
                                   @ExtensionRendererMode final int extensionRendererMode,
                                   final MediaCodecSelector mediaCodecSelector,
                                   final boolean enableDecoderFallback,
                                   final Handler eventHandler,
                                   final VideoRendererEventListener eventListener,
                                   final long allowedVideoJoiningTimeMs,
                                   final ArrayList<Renderer> out)

This method is overridden to modify the list of video renderers.

Important Parameters:
  • context: Android context.
  • extensionRendererMode: ExoPlayer extension rendering mode.
  • mediaCodecSelector: selects hardware/software codecs to use.
  • enableDecoderFallback: allows fallback to alternative decoders if the primary one fails.
  • eventHandler: handles events related to video rendering.
  • eventListener: listens and handles these events (e.g., errors, lost frames).
  • allowedVideoJoiningTimeMs: allowed delay before video playback begins.
  • out: list of Renderer objects to use for video rendering.
Adding the Custom Renderer
out.add(new CustomMediaCodecVideoRenderer(
    context,
    getCodecAdapterFactory(),
    mediaCodecSelector,
    allowedVideoJoiningTimeMs,
    enableDecoderFallback,
    eventHandler,
    eventListener,
    MAX_DROPPED_VIDEO_FRAME_COUNT_TO_NOTIFY
));
  • CustomMediaCodecVideoRenderer is a custom video renderer that replaces ExoPlayer’s default renderers.
  • getCodecAdapterFactory() is used to obtain a factory for managing codecs.
  • All other parameters are passed to ensure the renderer functions properly.

Why This Customization?

  1. Performance Optimization: Only the necessary codecs are loaded, avoiding unnecessary reflection mechanisms.
  2. Simplified Complexity: ExoPlayer supports extensions (AV1, VP9...), but here only one type of video renderer is kept.
  3. Better Control: Using CustomMediaCodecVideoRenderer, we can customize the behavior of video rendering (e.g., advanced error handling, specific decoders...).

Conclusion

This code replaces ExoPlayer's default video renderer by enforcing the use of a custom video renderer (CustomMediaCodecVideoRenderer). This helps improve performance and eliminate unnecessary code related to video extensions.

Ce code fait partie d'un projet Android utilisant ExoPlayer, une bibliothèque pour la lecture de médias. Il définit une classe CustomRenderersFactory qui personnalise la manière dont ExoPlayer crée les rendus vidéo.

Explication du code

1. Définition et rôle de la classe

La classe CustomRenderersFactory hérite de DefaultRenderersFactory, qui est responsable de la création des différents types de rendu (audio, vidéo, texte) pour ExoPlayer.

Son rôle est de remplacer la gestion par défaut des rendus vidéo pour n'utiliser que CustomMediaCodecVideoRenderer, un rendu vidéo personnalisé.

2. Constructeur

public CustomRenderersFactory(final Context context) {
    super(context);
}
  • Il appelle simplement le constructeur de la classe parente DefaultRenderersFactory.
  • context est l’environnement Android nécessaire pour récupérer des ressources.

3. Redéfinition de buildVideoRenderers

@Override
protected void buildVideoRenderers(final Context context,
                                   @ExtensionRendererMode final int extensionRendererMode,
                                   final MediaCodecSelector mediaCodecSelector,
                                   final boolean enableDecoderFallback,
                                   final Handler eventHandler,
                                   final VideoRendererEventListener eventListener,
                                   final long allowedVideoJoiningTimeMs,
                                   final ArrayList<Renderer> out)

Cette méthode est surchargée pour modifier la liste des rendus vidéo.

Paramètres importants :
  • context : contexte Android.
  • extensionRendererMode : mode de rendu des extensions ExoPlayer.
  • mediaCodecSelector : sélectionne les codecs matériels/logiciels à utiliser.
  • enableDecoderFallback : autorise la rétrocompatibilité avec des décodeurs alternatifs si le principal échoue.
  • eventHandler : gère les événements liés au rendu vidéo.
  • eventListener : écoute et gère ces événements (ex. erreurs, frames perdues).
  • allowedVideoJoiningTimeMs : délai autorisé avant la lecture de la vidéo.
  • out : liste des Renderer vidéo à utiliser.
Ajout du rendu personnalisé
out.add(new CustomMediaCodecVideoRenderer(
    context,
    getCodecAdapterFactory(),
    mediaCodecSelector,
    allowedVideoJoiningTimeMs,
    enableDecoderFallback,
    eventHandler,
    eventListener,
    MAX_DROPPED_VIDEO_FRAME_COUNT_TO_NOTIFY
));
  • CustomMediaCodecVideoRenderer est un rendu vidéo personnalisé qui remplace ceux d’ExoPlayer.
  • getCodecAdapterFactory() permet d’obtenir une fabrique pour la gestion des codecs.
  • Tous les autres paramètres sont passés pour s’assurer que le rendu fonctionne correctement.

Pourquoi cette personnalisation ?

  1. Optimisation des performances : Seuls les codecs nécessaires sont chargés, évitant ainsi les mécanismes de réflexion (reflection) inutiles.
  2. Réduction de la complexité : ExoPlayer supporte des extensions (AV1, VP9...), mais ici on ne garde qu’un seul type de rendu vidéo.
  3. Meilleur contrôle : En utilisant CustomMediaCodecVideoRenderer, on peut personnaliser le comportement du rendu vidéo (ex. gestion avancée des erreurs, décodeurs spécifiques...).

Conclusion

Ce code remplace le rendu vidéo par défaut d’ExoPlayer en forçant l’utilisation d’un rendu vidéo personnalisé (CustomMediaCodecVideoRenderer). Cela permet d’améliorer les performances et de supprimer le code inutile lié aux extensions vidéo.