支持 聯繫支持 | 系統狀況 系統狀態

從XDR API獲取播放位置

在本主題中,您將學習如何從跨設備恢復(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,則響應主體將包含一個item對象。 當您指定多個視頻ID時, items 數組將包含多個項目對象。 它看起來應該類似於:

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

使用服務器端代理

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


頁面最後更新於26年2020月XNUMX日