네이티브 SDK로 썸네일 찾기

이 항목에서는 Brightcove Native SDK를 사용한 썸네일 검색에 대해 알아봅니다.

개요

썸네일 검색을 통해 사용자는 타임라인을 따라 재생 헤드를 드래그하고 연결된 콘텐츠의 미리보기로 썸네일을 볼 수 있습니다. 이를 통해 사용자는 비디오 파일을 빠르게 탐색하고 관심있는 콘텐츠를 찾을 수 있습니다.

썸네일 찾기
이미지는 언제 생성됩니까?

Brightcove는 요청시 동적으로 이미지를 생성합니다. Dynamic Delivery로 수집 된 모든 비디오에는 첫 번째 요청에서 생성 된 이미지가 있습니다. 이렇게하면 사용하지 않는 비디오에 대해 이미지가 생성되지 않습니다. 생성 된 이미지는 다른 이미지와 마찬가지로 반복보기를 위해 로컬 및 CDN에 캐시됩니다.

비디오의 이미지 주파수는 무엇입니까?

콘텐츠가 1시간 이상인 경우 5초마다 이미지가 생성되고 < 1시간 이상인 콘텐츠의 경우 10초마다 이미지가 생성됩니다.

요구 사항

다음 요구 사항은 Brightcove Native SDK를 사용한 썸네일 검색에 필요합니다.

이 기능을 사용하려면 재생 API v2를 사용해야 합니다.

디바이스 OS 버전

  • 안드로이드 6.0+
  • iOS 11.0 이상

브라이트코브 네이티브 SDK 버전

  • 안드로이드 6.12.0+용 네이티브 SDK
  • iOS 6.7.4+를 위한 네이티브 SDK

시작하기

이 기능은 브라이트코브 비디오 클라우드 계정을 가진 모든 사용자가 사용할 수 있습니다.

동영상이 동적 전송을 위해 수집되었는지 확인합니다.

안드로이드 구현

Android용 Native SDK에서 썸네일 검색을 사용하려면 다음 단계를 따르세요.

  1. build.gradle파일에 다음과 같은 Gradle 종속 항목을 추가합니다. 

    implementation "com.brightcove.player:android-thumbnail-plugin:6.13.0"

  2. MainActivity.java파일에서 의 인스턴스를 생성합니다ThumbnailComponent . 

    ThumbnailComponent thumbnailComponent = new ThumbnailComponent(brightcoveVideoView);

  3. 미리보기 미디어 컨트롤러를 설정합니다. 

    thumbnailComponent.setupPreviewThumbnailController();
  4. 전체 코드 예제는썸네일 스크러버 샘플 앱을 참조하십시오.

SSAI를위한 추가 단계

SSAI (Server-Side Ad Insertion)를 사용하는 경우 추가 단계가 있습니다.

SSAI 플러그인과 함께 썸네일 플러그인을 사용하려면 콘텐츠에서 스티칭 된 광고로 인해 발생하는 오프셋을 고려해야합니다.

  1. MainActivity.java파일로 돌아가십시오.
  2. SSAIEventType.AD_DATA_READY이벤트를 들어보세요.
  3. SSAI 비디오의 타임 라인 개체를 검색합니다.

  4. 다음 파라미터를SSAIThumbnailDocumentCreatorWrapper사용하여 의 인스턴스를 생성합니다.

    • A ThumbnailDocumentCreator . 를 사용할 수 있습니다DefaultThumbnailDocumentCreator .
    • SSAI 비디오의 타임 라인 개체입니다.
    • 를ThumbnailDocumentCreator로 설정합니다ThumbnailPlugin .

  5. 다음은 코드 예제입니다. 

    eventEmitter.once(AD_DATA_READY, event -> {
  Timeline timeline = event.getProperty(SSAIEvent.VMAP_TIMELINE, Timeline.class);
  ThumbnailDocumentCreator creator = new SSAIThumbnailDocumentCreatorWrapper(new   DefaultThumbnailDocumentCreator(), timeline);
  thumbnailComponent.setThumbnailDocumentCreator(creator);
});

iOS 구현

iOS용 Native SDK에서 썸네일 검색을 사용하려면 다음 단계를 따르세요.

  1. 재생 컨트롤러에 대한 썸네일 검색을 활성화하거나 비활성화하는 새BCOVPlaybackController속성이 있습니다. 자세한 내용은 iOS용네이티브 SDK 레퍼런스를 참조하십시오 .

  2. 기본값은 입니다YES . 썸네일 검색을 비활성화하려면 값을 로 설정합니다NO .

    /**
 * Enables or disables thumbnail seeking for this playback controller.
 *
 * Default value is YES
 */
@property (nonatomic, readwrite, assign) BOOL thumbnailScrubbingEnabled;

제한 사항

Native SDK에서 썸네일 검색을 사용할 때 몇 가지 제한 사항이 있습니다.

  • 오프라인 재생에서는 썸네일 검색이 지원되지 않습니다.
  • Android용 Native SDK를 사용하는 경우 원격 자산 비디오에 대해 썸네일 검색을 사용할 수 없습니다.