안드로이드용 네이티브 SDK로 이벤트 이해

이 항목에서는 Android용 네이티브 SDK에서 트리거하고 수신하는 가장 일반적인 이벤트에 대해 알아봅니다.

서문

Android 용 네이티브 SDK는 비디오 플레이어로 사용자 작업을 수신하는 이벤트 기반 모델을 사용합니다.

이벤트 중심 모델

전통적인 프로그래밍 모델에서 흐름은 정적이며 프로그래머가 미리 정의합니다. 이벤트 기반 모델에는 사전 설정된 흐름이 없습니다. 대신 사용자 작업과 같은 이벤트에 의해 흐름이 결정됩니다. 일반적으로 이벤트를 수신하고 콜백 함수를 트리거하는 메인 루프가 있습니다.

이벤트 기반 흐름도
이벤트 중심 흐름

사내 행사 및 이벤트 소식을 비디오로 제공하십시오.

Android 용 Brightcove Player SDK를 사용하는 동안 사전 정의 된 이벤트를 활용하여 앱의 기능을 제어 할 수 있습니다. 이벤트는 문자열 리터럴 일 뿐이므로 자신 만의 이벤트를 쉽게 만들고 사용할 수 있습니다.

Android 용 Brightcove Player SDK의 이벤트는 리스너 체인을 통해 전달할 수있는 상태 또는 작업을 나타냅니다. 모든 이벤트에는 유형과 관련된 속성 맵이 있습니다. 이벤트가 리스너 체인 아래로 전파되는 것을 중지하거나 비디오 재생 클래스에서 기본 리스너를 방지하도록 지시 할 수 있습니다.

이벤트는 발생하는 상태 또는 작업을 나타낼 수 있습니다. 예를 들어, 이벤트 유형DID_SEEK_TO 액션의 상태를 나타냅니다. SEEK_TO .

사전 정의 된 이벤트의 전체 목록을 보려면 다음 이미지를 선택하십시오.

안드로이드 이벤트 유형
안드로이드 이벤트 유형

EventEmitter

Brightcove BaseVideoView Android의 기본을위한 드롭 인 대체품으로 설계되었습니다. VideoView . 이 수업은 또한 EventEmitter모든 SDK 구성 요소를 함께 연결합니다. 사용자가 동영상보기와 상호 작용하면EventEmitter 재생, 일시 중지 등과 같은 이벤트를 내 보냅니다. 각 이벤트에 관심이있는 구성 요소는이를 수신하고 조치를 취할 수 있습니다.

SDK가 특정 작업을 수행하기를 원할 때 이벤트를 수신하고 내보내는 플러그인을 추가 할 수 있습니다.

Native SDK는 앱을 제어 할 수있는 사전 정의 된 이벤트를 제공하지만 자신 만의 이벤트를 쉽게 만들고 사용할 수 있습니다.

자신 만의 이벤트 이미 터를 만들고 지시 할 수도 있습니다. BrightcoveExoPlayerVideoView그것을 사용합니다. 리스너 체인을 제어하려는 경우 유용합니다.

구성 요소 및 이벤트

Android 용 Brightcove SDK의 각 구성 요소에 대해 관련된 모든 이벤트를 찾을 수 있습니다. 이렇게 하려면 다음과이 같이 하십시오.

  1. 다음으로 이동 Android 용 Brightcove Player SDK참고.
  2. 왼쪽 메뉴에서 구성 요소를 선택합니다.
  3. 구성 요소 클래스 세부 정보 섹션에서이 구성 요소에서 내보내고 수신하는 이벤트 목록을 찾을 수 있습니다.
    구성 요소 및 이벤트
    구성 요소 및 이벤트

일반적인 재생 이벤트

이 다이어그램은 몇 가지 일반적인 재생 이벤트와 이들이 Android 용 Brightcove Player SDK의 구성 요소와 상호 작용하는 방식을 보여줍니다.

추가 () /설정 () 메소드 이벤트

이 다이어그램은add(Video) , addAll(Collection) , setVideoPath() , 및setVideoURI() 행동 양식.

추가 () /설정 () 메소드 이벤트
추가 () /설정 () 메소드 이벤트

start () 메소드 이벤트

이 다이어그램은start() 방법.

start () 메소드 이벤트
start () 메소드 이벤트

seekTO () 메소드 이벤트

이 다이어그램은seekTo() 방법.

seekTO () 메소드 이벤트
seekTO () 메소드 이벤트

일시 중지 () 메소드 이벤트

이 다이어그램은pause() 방법.

일시 중지 () 메소드 이벤트
일시 중지 () 메소드 이벤트

StopPlayback () 메소드 이벤트

이 다이어그램은stopPlayback() 방법.

StopPlayback () 메소드 이벤트
StopPlayback () 메소드 이벤트

일반적인 광고 이벤트

앱에서 Android 용 Brightcove Player SDK의 광고 이벤트 세트를 수신하고 조치를 취할 수 있습니다.

IMA 광고 이벤트

이 다이어그램은 Google IMA 광고 플러그인의 광고 이벤트를 보여줍니다. 이러한 광고 이벤트는 exoplayer 샘플 내에서 수신됩니다. AdRulesIMASampleApp .

IMA 광고 이벤트
IMA 광고 이벤트

일반적인 광고 이벤트

다음은 수신하고 조치를 취할 수있는 Android 용 Brightcove Player SDK의 일반적인 광고 이벤트 목록입니다.

코드 예

광고 시간이 시작되면EventType.AD_BREAK_STARTED이벤트가 발생합니다. 광고 시간이 종료되면EventType.AD_BREAK_COMPLETED방출됩니다.

다음과 같이 이벤트를 수신하고 반응 할 수 있습니다.

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

다음을 수행하여 이벤트를 생성 할 수 있습니다.

eventEmitter.emit(EventType.STOP);
 

이제 Android 용 Brightcove Player SDK에 대한 기본적인 이해를 마쳤습니다. 다음으로 Player SDK를 사용하는 앱을 빌드하는 단계를 살펴볼 수 있습니다.