從 XDR API 獲取播放位置

在本主題中，您將了解如何從跨設備恢復 (XDR) API 檢索查看器的播放位置。

概覽

跨設備恢復讓觀眾可以在一台設備上開始觀看視頻，稍後可以在另一台設備上繼續觀看他們離開的視頻。

由於無法從客戶端應用程序調用跨設備恢復（XDR）API，因此您將需要創建服務器端代理來進行調用並返回播放位置值。

獲取播放位置

您可以使用跨裝置繼續 (XDR) API 取得檢視器播放位置。

跨設備簡歷（XDR）API

使用跨設備恢復API，您可以獲取特定觀看者的所有播放頭位置，或特定觀看者和視頻的所有播放頭。

基本網址

API 的基本網址是： 

https://data.brightcove.com/v1/xdr

帳號路徑

在所有情況下，我們都會針對特定的視訊雲端帳戶提出要求。因此，您將始終將術語帳戶後面跟著您的帳戶 ID 添加到基本 URL 中： 

https://data.brightcove.com/v1/xdr/accounts/{account_id}

授權

請求的訪問令牌是必需的，並且必須出現在授權頭中： 

Authorization: Bearer {access_token}

訪問令牌是一個臨時的 OAuth2 訪問令牌，必須從布萊特灣 OAuth 服務獲得。有關如何獲取客戶端憑據並使用它們來檢索訪問令牌的詳細信息，請參閱 Brightcove OAuth 概述。

權限

對跨設備恢復 API 的請求必須來自客戶憑據具有以下權限：

  • video-cloud/xdr/read

請注意，這些權限在Studio管理員界面中尚不可用。在這之前，您可以使用此 Brightcove 學習服務應用程序來創建客戶端憑據。只要確保在創建憑據時選中該video-cloud/xdr/read框（您可以根據需要選中盡可能多的其他框）。

API 方法

跨設備簡歷API支持以下請求。如需詳細資訊，請參閱跨裝置繼續 (XDR) API 參考資料。

獲取觀眾播放頭

此請求將為觀眾獲取所有播放頭。 

GET /accounts/{accountID}/playheads/{viewer_id}
回應主體

響應主體包含一系列視頻和播放頭。它看起來應該類似於： 

{
  "account_id": "1752604059001",
  "viewer_id": "viewer001",
  "items": [
    {
    "timestamp": 1589548991563000,
    "video_id": "6152436480001",
    "playhead_seconds": 17
    },
    {
    "timestamp": 1589548858719000,
    "video_id": "6152440604001",
    "playhead_seconds": 3
    }
  ],
  "size": 2
  }

獲取觀看者視頻播放頭

該請求將獲取觀眾和特定視頻的所有播放頭。 

GET /accounts/{account_id}/playheads/{viewer_id}/{video_id}

回應主體

如果您指定一個視頻 ID，則響應主體將包含一個項目對象。當您指定多個視頻 ID 時，比items數組將包含多個項目對象。它看起來應該類似於： 

{
  "account_id": "1752604059001",
  "viewer_id": "viewer001",
  "items": [
    {
    "timestamp": 1589896539910000,
    "video_id": "6156696074001",
    "playhead_seconds": 39
    }
  ],
  "size": 1
  }

使用服務器端代理

代理是服務器端應用程序，充當客戶端應用程序和REST API之間的中介。以下是一些有用的鏈接：