Verstehen von Ereignissen mit dem Native SDK für Android

Einleitung

Das Native SDK für Android verwendet ein ereignisgesteuertes Modell, das auf Benutzeraktionen mit dem Videoplayer wartet.

Ereignisgesteuertes Modell

In traditionellen Programmiermodellen ist der Fluss statisch und vom Programmierer vordefiniert. In einem ereignisgesteuerten Modell gibt es keinen voreingestellten Ablauf. Stattdessen wird der Fluss durch Ereignisse wie Benutzeraktionen bestimmt. Normalerweise gibt es eine Hauptschleife, die auf Ereignisse lauscht und Rückruffunktionen auslöst.

Veranstaltungen

Wenn Sie das Brightcove Player SDK für Android verwenden, können Sie vordefinierte Ereignisse nutzen, um die Funktionen in Ihrer App zu steuern. Da Ereignisse nur Zeichenfolgenliterale sind, können Sie ganz einfach Ihre eigenen Ereignisse erstellen und verwenden.

Ereignisse im Brightcove Player SDK für Android stellen einen Zustand oder eine Aktion dar, die über eine Kette von Listenern weitergegeben werden kann. Allen Ereignissen sind ein Typ und eine Zuordnung von Eigenschaften zugeordnet. Ereignisse können daran gehindert werden, sich entlang der Listenerkette auszubreiten, oder sie können angewiesen werden, ihre Standard-Listener in den Videowiedergabeklassen zu verhindern.

Ereignisse können einen Zustand oder eine auftretende Aktion darstellen. Zum Beispiel der Ereignistyp DID_SEEK_TO repräsentiert den Zustand der Aktion SEEK_TO .

Um eine vollständige Liste der vordefinierten Ereignisse zu erhalten, wählen Sie das folgende Bild aus:

EventEmitter

Die Brightcove BaseVideoView ist als Drop-In-Ersatz für Androids native Videoansicht. Diese Klasse beginnt auch die EventEmitter die alle SDK-Komponenten miteinander verbindet. Wenn ein Benutzer mit der Videoansicht interagiert, wird die EventEmitter gibt ein Ereignis aus, z. B. Wiedergabe, Pause usw. Komponenten, die an jedem Ereignis interessiert sind, können darauf hören und darauf reagieren.

Es können Plugins hinzugefügt werden, die Ereignisse abhören und ausgeben, wenn das SDK bestimmte Dinge tun soll.

Das Native SDK bietet vordefinierte Ereignisse zur Steuerung Ihrer App, Sie können jedoch problemlos eigene Ereignisse erstellen und verwenden.

Es ist auch möglich, einen eigenen Event-Emitter zu erstellen und den BrightcoveExoPlayerVideoView um es zu benutzen. Dies ist nützlich, wenn Sie eine Kette von Listenern steuern möchten.

Komponenten und Ereignisse

Für jede Komponente im Brightcove SDK für Android können Sie alle damit verbundenen Ereignisse finden. Gehen Sie dazu folgendermaßen vor:

1. Navigieren Sie zum Brightcove Player-SDK für Android Hinweis.
2. Wählen Sie im Menü auf der linken Seite eine Komponente aus.
3. Im Abschnitt Details zur Komponentenklasse finden Sie eine Liste der Ereignisse, die von dieser Komponente ausgegeben und auf sie gewartet wird.

   

Häufige Wiedergabeereignisse

Diese Diagramme zeigen einige der gängigen Wiedergabeereignisse und ihre Interaktion mit den Komponenten im Brightcove Player SDK für Android.

add()/set() Methodenereignisse

Dieses Diagramm zeigt Ereignisse im Zusammenhang mit dem add(Video) , addAll(Collection) , setVideoPath() , und setVideoURI() Methoden.

start()-Methodenereignisse

Dieses Diagramm zeigt Ereignisse im Zusammenhang mit dem start() Methode.

seekTo()-Methodenereignisse

Dieses Diagramm zeigt Ereignisse im Zusammenhang mit dem seekTo() Methode.

pause()-Methodenereignisse

Dieses Diagramm zeigt Ereignisse im Zusammenhang mit dem pause() Methode.

stopPlayback()-Methodenereignisse

Dieses Diagramm zeigt Ereignisse im Zusammenhang mit dem stopPlayback() Methode.

Häufige Anzeigenereignisse

In Ihrer App können Sie eine Reihe von Werbeereignissen aus dem Brightcove Player SDK für Android anhören und darauf reagieren.

IMA-Anzeigenereignisse

Dieses Diagramm zeigt die Anzeigenereignisse für das Google IMA-Werbe-Plug-in. Diese Anzeigenereignisse werden im Exoplayer-Beispiel überwacht: AdRulesIMASampleApp.

Häufige Anzeigenereignisse

Hier ist eine Liste der häufigsten Werbeereignisse aus dem Brightcove Player SDK für Android, die Sie anhören und auf die Sie reagieren können:

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

Codebeispiel

Wenn eine Werbeunterbrechung beginnt, wird die EventType.AD_BREAK_STARTED Ereignis ausgegeben wird. Wenn eine Werbeunterbrechung endet, wird die EventType.AD_BREAK_COMPLETED emittiert wird.

Sie können Ereignisse wie hier gezeigt anhören und darauf reagieren:

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
	}
});

Sie können Ereignisse wie folgt ausgeben:

eventEmitter.emit(EventType.STOP);