ネイティブSDKを使用したサムネイルシーク

このトピックでは、Brightcove NativeSDKを使用したサムネイルシークについて学習します。

概要

サムネイルシークを使用すると、ユーザーはタイムラインに沿って再生ヘッドをドラッグし、関連するコンテンツのプレビューとしてサムネイルを表示できます。これにより、ユーザーはビデオファイルをすばやくナビゲートし、関心のあるコンテンツを見つけることができます。

画像はいつ生成されますか？

Brightcoveは、要求に応じて画像を動的に生成します。Dynamic Deliveryで取り込んだ動画には、最初のリクエストで画像が生成されます。これにより、未使用のビデオの画像が作成されなくなります。生成されると、他の画像と同じように、画像はローカルおよびCDNにキャッシュされ、繰り返し表示されます。

ビデオの画像周波数はどれくらいですか？

画像は、コンテンツが1時間未満の場合は5秒ごとに、コンテンツが1時間以上の場合は10秒ごとに生成されます。

要件

Brightcove Native SDKでサムネイルを検索するには、次の要件が必要です。

この機能を使用するには、再生 API v2 を使用する必要があります。

デバイスOSのバージョン

Android 6.0+
iOS 12.0 以降（Swift Package Manager を使用する場合は iOS 14.0 以降）

Brightcoveのネイティブ SDK バージョン

Android6.12.0以降用のネイティブSDK
iOS 6.7.4以降用のネイティブSDK

入門編

この機能は、Brightcove 動画クラウドアカウントをお持ちの方であれば誰でも利用できます。

動画が動的配信用に取り込まれていることを確認します。

Androidの実装

Android用ネイティブSDKでサムネイルシークを使用するには、次の手順に従います。

build.gradleファイルで、次のGradle依存関係を追加します。
```
implementation "com.brightcove.player:android-thumbnail-plugin:6.13.0"
```
MainActivity.java ファイルで、のインスタンスを作成しますThumbnailComponent。
```
ThumbnailComponent thumbnailComponent = new ThumbnailComponent(brightcoveVideoView);
```
プレビューメディアコントローラを設定します。
```
thumbnailComponent.setupPreviewThumbnailController();
```
完全なコード例については、ThumbnailScrubberSampleAppを参照してください

SSAI の追加手順

サーバーサイド広告挿入 (SSAI) を使用している場合は、追加の手順があります。

SSAI プラグインでサムネイルプラグインを使用するには、コンテンツ内のステッチされた広告によって導入されたオフセットを考慮する必要があります。

MainActivity.java ファイルに戻ります。
SSAIEventType.AD_DATA_READYイベントを聞いて。
SSAI ビデオのタイムラインオブジェクトを取得します。
SSAIThumbnailDocumentCreatorWrapper次のパラメータを使用してのインスタンスを作成します。
- A ThumbnailDocumentCreator .を使用できますDefaultThumbnailDocumentCreator。
- SSAI ビデオのタイムラインオブジェクト。
- ThumbnailDocumentCreatorをに設定しますThumbnailPlugin。

コードの例は次のとおりです。

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用ネイティブSDKでサムネイルシークを使用するには、次の手順に従います

BCOVPlaybackController の thumbnailSeekingEnabled プロパティで、再生コントローラのサムネイルシークを有効または無効にします。旧 thumbnailScrubbingEnabled プロパティは非推奨となり、Native SDK for iOS 6.10.3 で削除されました。代わりに thumbnailSeekingEnabled を使用してください。詳細については、Native SDK for iOS リファレンスの Thumbnail Seeking セクションを参照してください。

デフォルト値は true です。サムネイルシークを無効にするには、値を false に設定します。

/**
 * Enables or disables thumbnail seeking for this playback controller.
 *
 * Default value is true
 */
playbackController.thumbnailSeekingEnabled = false

制限事項

ネイティブ SDK を使用したサムネイルシークには、次の制限があります。

サムネイルシークはオフライン再生ではサポートされていません
Android 用ネイティブ SDK では、リモートアセット動画のサムネイルシークは利用できません。

ページコンテンツ