與布萊特灣播放器的跨裝置履歷

在本主題中，您將了解如何將跨設備恢復與 Brightcove Player 結合使用。

概覽

Cross-Device Resume 允許觀眾在一台設備上開始觀看視頻，稍後在相同或不同的設備上繼續觀看他們離開的視頻。

假設有人開始在他們的移動設備上觀看視頻。稍後，他們可以繼續使用網絡瀏覽器上的播放器觀看同一視頻。播放將從他們中斷的地方繼續，所以他們不會錯過任何東西。

如果您不熟悉此功能，請參閱概觀：跨設備簡歷文件。

需求

以下要求適用於跨設備簡歷：

  • Brightcove Player版本6.41.0+

設定

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

若要開始使用，請執行下列動作：

  • 聯繫您的客戶經理為您的帳戶啟用跨設備簡歷
  • 確定您使用的影片已擷取進行動態傳遞

實現跨設備簡歷

要實施跨設備恢復，請按照下列步驟操作：

  1. 設置用戶標識符在Brightcove Analytics中
  2. 獲取查看器播放位置
  3. 恢復播放在Brightcove播放器上

發送觀眾 ID - Brightcove 播放器

首先，您需要設置用戶標識符來存儲他們的觀看活動。

布萊特灣玩家

如果您使用的是Brightcove Player，請按照下列步驟操作：

  1. 即使瀏覽者資料會自動傳送至 Brightcove 分析，您仍需要設定使用者識別碼。為此，請使用setUser()方法。例如： 

    myPlayer.bcAnalytics.client.setUser('viewer id');

    在託管 Brightcove Player 的網站上，您可以使用身份驗證網關或某些身份管理解決方案來跟踪查看者。使用此查看器 ID 作為查看器標識符以傳遞給 Brightcove 分析。

  2. 在播放器上設置任何源之前設置查看器 ID 很重要。初始化播放器後應立即調用它。 

    <video-js
  id="myPlayerID"
  data-account="1752604059001"
  data-player="hyQW6GByl"
  data-embed="default"
  controls=""
  data-video-id="6156696074001"
  data-playlist-id=""
  data-application-id=""
  width="640" height="360"></video-js>
<script src="https://players.brightcove.net/1752604059001/hyQW6GByl_default/index.min.js"></script>

<script>
  videojs.getPlayer('myPlayerID').ready(function() {
    var myPlayer = this;

    // Set the viewer id for Brightcove analytics
    myPlayer.bcAnalytics.client.setUser('viewer id');
  });
</script>
  3. 當。。。的時候setUser()使用方法時，不會對該值進行哈希處理，並將與所有後續信標一起以明文形式發送。

    請注意player_init事件將不包括user在這種情況下，但所有video_*事件應該包括它。

自定義網絡播放器

如果您要建置不使用 Brightcove 播放器的自訂實作，請將user參數新增至您的資料收集 API 請求。有關詳細信息，請參見概述：數據收集API v2文件。

在託管播放器的網站上，您可以使用身份驗證網關或某些身份管理解決方案來跟踪觀眾。使用此查看器 ID 作為查看器標識符以傳遞給 Brightcove 分析。

這個user傳遞給Brightcove的參數可以在下一部分中使用，以從XDR API檢索播放位置。

獲取查看器播放位置

接下來，您將從跨設備恢復 (XDR) API 獲取查看器播放位置。

您將需要一個服務器端應用程序來發出 REST API 請求以獲取查看器播放位置。

有關詳細信息，請參見從XDR API獲取播放位置文件。

繼續播放

從 XDR API 獲得查看器播放位置後，您可以從該點恢復播放。

  1. 使用上一節中的查看器播放位置，使用currentTime()方法。

    這是一個例子： 

    // The specific event to use may require some experimentation
player.on('loadstart', function() {

  // This initialPlayhead variable will have to come from the publisher's
  // custom integration.
  player.currentTime(viewer playhead position);
});
  2. 有關調用服務器端代理以從XDR API獲取播放頭的Web播放器示例，請參見github上的跨設備簡歷示例。