支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    從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

    請注意,這些權限在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之間的中介。 以下是一些有用的鏈接:


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