Comprendre les événements avec le SDK natif pour Android

Introduction

Le SDK natif pour Android utilise un modèle basé sur les événements, qui écoute les actions des utilisateurs avec le lecteur vidéo.

Modèle événementiel

Dans les modèles de programmation traditionnels, le flux est statique et prédéfini par le programmeur. Dans un modèle événementiel, il n'y a pas de flux prédéfini. Au lieu de cela, le flux est déterminé par des événements, tels que les actions de l'utilisateur. Il existe généralement une boucle principale qui écoute les événements et déclenche les fonctions de rappel.

Evénements

Lorsque vous utilisez le Brightcove Player SDK pour Android, vous pouvez profiter d'événements prédéfinis pour contrôler les fonctionnalités de votre application. Étant donné que les événements ne sont que des littéraux de chaîne, vous pouvez facilement créer et utiliser vos propres événements.

Les événements du Brightcove Player SDK pour Android représentent un état ou une action qui peut être transmis via une chaîne d'auditeurs. Tous les événements ont un type et une carte de propriétés qui leur sont associés. Les événements peuvent être empêchés de se propager le long de la chaîne d'auditeurs, ou peuvent être chargés d'empêcher leurs auditeurs par défaut dans les classes de lecture vidéo.

Les événements peuvent représenter un état ou une action en cours. Par exemple, le type d'événement DID_SEEK_TO représente l'état de l'action SEEK_TO .

Pour une liste complète des événements prédéfinis, sélectionnez l'image suivante :

Émetteur d'événement

Le Brightcove BaseVidéoVoir est conçu comme un remplacement instantané pour le natif d'Android VidéoVoir. Cette classe commence également le Émetteur d'événement qui relie tous les composants du SDK entre eux. Lorsqu'un utilisateur interagit avec la vue vidéo, le EventEmitter émet un événement, tel que lecture, pause, etc. Les composants intéressés par chaque événement peuvent les écouter et agir en conséquence.

Des plugins peuvent être ajoutés pour écouter et émettre des événements lorsqu'ils souhaitent que le SDK fasse certaines choses.

Le SDK natif fournit des événements prédéfinis pour contrôler votre application, mais vous pouvez facilement créer et utiliser vos propres événements.

Il est également possible de créer votre propre émetteur d'événement et d'instruire le BrightcoveExoPlayerVidéoVoir pour l'utiliser. Ceci est utile si vous souhaitez contrôler une chaîne d'auditeurs.

Composants et événements

Pour chaque composant du Brightcove SDK pour Android, vous pouvez trouver tous les événements qui lui sont associés. Pour ce faire, procédez comme suit :

1. Naviguez vers le Kit de développement logiciel Brightcove Player pour Android référence.
2. Dans le menu de gauche, sélectionnez un composant.
3. Dans la section des détails de la classe de composant, vous trouverez une liste des événements qui sont émis et écoutés par ce composant.

   

Événements de lecture courants

Ces diagrammes montrent certains des événements de lecture courants et comment ils interagissent avec les composants du Brightcove Player SDK pour Android.

événements de méthode add()/set()

Ce diagramme montre les événements liés à la add(Video) , addAll(Collection) , setVideoPath() , et setVideoURI() méthodes.

événements de la méthode start()

Ce diagramme montre les événements liés à la start() méthode.

événements de méthode seekTo()

Ce diagramme montre les événements liés à la seekTo() méthode.

événements de la méthode pause()

Ce diagramme montre les événements liés à la pause() méthode.

événements de la méthode stopPlayback()

Ce diagramme montre les événements liés à la stopPlayback() méthode.

Événements publicitaires courants

Dans votre application, vous pouvez écouter et agir sur un ensemble d'événements publicitaires du Brightcove Player SDK pour Android.

Événements publicitaires IMA

Ce diagramme montre les événements publicitaires pour le plug-in publicitaire Google IMA. Ces événements publicitaires sont écoutés dans l'exemple exoplayer : AdRulesIMASampleApp.

Événements publicitaires courants

Voici une liste des événements publicitaires courants du Brightcove Player SDK pour Android que vous pouvez écouter et exploiter :

• AD_BREAK_STARTED
• AD_BREAK_COMPLETED
• AD_STARTED
• AD_PAUSED
• AD_RESUMED
• AD_PROGRESS
• AD_COMPLETED
• AD_ERROR

Exemple de code

Lorsqu'une coupure publicitaire démarre, le EventType.AD_BREAK_STARTED événement est émis. Lorsqu'une coupure publicitaire se termine, le EventType.AD_BREAK_COMPLETED est émis.

Vous pouvez écouter et réagir aux événements comme indiqué ici :

eventEmitter.on(EventType.AD_BREAK_STARTED, new EventListener() {
	@Override
	public void processEvent(Event event) {
		// React to the event
	}
});

eventEmitter.on(EventType.AD_BREAK_COMPLETED, new EventListener() {
	@Override
	public void processEvent(Event event) {
		// React to the event
	}
});

Vous pouvez émettre des événements en procédant comme suit :

eventEmitter.emit(EventType.STOP);