從XDR API獲取播放位置

概述

跨設備簡歷可讓您開始在一台設備上觀看視頻，稍後，您可以繼續在另一台設備上觀看該視頻。

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

獲取播放位置

您可以使用 跨設備簡歷（XDR）API.

跨設備簡歷（XDR）API

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

基本網址

API的基本URL為：

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

帳戶路徑

在所有情況下，都將針對特定 Video Cloud 帳戶。 因此，您將始終在基本URL中添加術語“帳戶”和“帳戶ID”：

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

授權

請求的訪問令牌是必需的，並且必須存在於Authorization標頭中：

Authorization: Bearer {access_token}

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

權限

對跨設備簡歷API的請求必須來自 客戶憑證 具有以下權限：

• video-cloud/xdr/read

請注意，這些權限在Studio管理員界面中尚不可用。 直到他們可以使用 Brightcove學習服務應用程序 創建您的客戶憑證。 只要確保檢查 video-cloud/xdr/read 創建憑據時，請選擇“框”（您可以根據需要選中任意多個其他框）。

API方法

跨設備簡歷API支持以下請求。 有關詳細信息，請參見 跨設備簡歷（XDR）API參考.

獲取觀眾播放頭

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

GET /accounts/{accountID}/playheads/{viewerID}

反應體

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

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

獲取觀看者視頻播放頭

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

GET /accounts/{accountID}/playheads/{viewerID}/{videoID}

反應體

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

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

使用服務器端代理

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

• 有關概念，請參見 學習指南：使用REST API
• 對於網絡 player 調用服務器端代理從XDR API獲取播放頭的示例，請參見 github上的跨設備簡歷示例.