從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上的跨設備簡歷示例.