從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

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列表：（最大= 100）

GET /accounts/{accountID}/playheads/{viewerID}/{videoID},{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上的跨設備簡歷示例.