使用原生 SDK 進行縮略圖搜索

概覽

縮略圖搜索允許用戶沿著時間線拖動播放頭，並查看縮略圖作為相關內容的預覽。這使用戶能夠快速瀏覽視頻文件並找到他們感興趣的內容。

什麼時候生成圖像？

Brightcove可根據要求動態生成圖像。使用動態投放提取的任何視頻都將在第一個請求時生成圖像。這樣可以確保不會為未使用的視頻創建圖像。生成後，就像其他任何圖像一樣，圖像會在本地和CDN上緩存以便重複查看。

視頻的圖像頻率是多少？

內容每 5 秒生成一次圖像 < 1 小時，內容每 10 秒一次 > 1小時。

需求

使用 Brightcove 本機 SDK 進行縮略圖搜索需要滿足以下要求：

此功能需要使用 Playback API v2。

裝置作業系統版本

• 安卓 6.0 以上
• iOS 11.0 以上

布萊特灣原生 SDK 版本

• 適用於Android 6.12.0+的本機SDK
• 適用於iOS 6.7.4+的本機SDK

入門

擁有 Brightcove 視訊雲端帳戶的任何人都可以使用此功能。

請確認您的影片已收錄進行動態傳遞。

安卓實作

要通過適用於 Android 的 Native SDK 使用縮略圖搜索，請執行以下步驟：

1. 在裡面構建.gradle文件，添加以下 Gradle 依賴項：

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

2. 在裡面主活動.java文件，創建一個實例ThumbnailComponent .

   ThumbnailComponent thumbnailComponent = new ThumbnailComponent(brightcoveVideoView);

3. 設置預覽媒體控制器。

   thumbnailComponent.setupPreviewThumbnailController();

4. 有關完整的代碼示例，請參閱ThumbnailScrubberSampleApp

SSAI的其他步驟

如果您使用服務器端廣告插入（SSAI），則還有其他步驟。

要將Thumbnail插件與SSAI插件一起使用，您需要考慮內容中縫合廣告引入的偏移。

1. 回到你的主活動.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 時，縮略圖搜索對遠程資產視頻不可用。