實作裝置限制

簡介

Brightcove的播放權限管理服務使您可以設置視頻播放的設備限制。提出 DRM 授權要求時，每個使用者的裝置都會以唯一的 ID 註冊。您可以控制每個用戶的設備數量。

每個授權要求都會檢查並強制執行裝置限制。要使用此限制，您將通過JSON Web令牌（JWT）使用當前用戶ID uid播放API。

如果您不熟悉此功能，請參閱概觀：播放版權管理服務文件。

設備註冊

當有效的播放請求包括JSON Web令牌（JWT）與uid和dlimit索賠已收到。從那時起，該設備將佔據一個插槽。

實作

要啟用設備限制，請按照下列步驟操作：

1. 創建一個JSON Web令牌（JWT）與一般要求的索賠以及uid和dlimit索賠。

   提出 DRM 授權要求時，每個使用者的裝置都會以唯一的 ID 註冊。

   的dlimit聲明可讓您控制可與指定用戶關聯的設備數量uid。該值必須> 0。

   如果dlimit聲明值在以後的請求中被刪除，先前允許的設備將繼續運行。

   例
   如果dlimit值設置為3，則用戶可以在設備A，B和C上播放（允許所有播放）。嘗試在裝置 D 上播放將被拒絕。
   如果dlimit值更改為1，用戶仍然可以在A，B和C的所有3種設備上播放，除非通過使用Devices API管理設備手動撤消了這些設備。為此，請參見管理設備部分。

2. 管理用戶設備設備API。使用此API，您可以為用戶獲取設備，刪除設備並更新設備名稱。

   設備註冊後，將通過ID和暱稱進行標識。Devices API使您可以編輯設備暱稱，從而輕鬆管理設備列表。

3. 配置播放器使用JSON Web Token（JWT）在上一步中創建。

管理設備

您可以使用設備API。

設備API

使用設備API，您可以獲取和刪除用戶設備。

基本網址

API 的基本網址是：

https://playback-auth.api.brightcove.com/v1

帳號路徑

在所有情況下，我們都會針對特定的視訊雲端帳戶提出要求。因此，您將始終將術語帳戶後面跟著您的帳戶 ID 添加到基本 URL 中：

https://playback-auth.api.brightcove.com/v1/accounts/{accountID}

授權

請求的訪問令牌是必需的，並且必須出現在授權頭中：

Authorization: Bearer {access_token}

訪問令牌是一個臨時的 OAuth2 訪問令牌，必須從布萊特灣 OAuth 服務獲得。如需有關如何取得用戶端認證並使用它們來擷取存取權杖的詳細資訊，請參閱 Brightcove OAuth 概觀。

權限

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

• video-cloud/playback-auth/devices/read
• video-cloud/playback-auth/devices/write

API 方法

設備API支持以下請求。有關詳細信息，請參見設備API參考。

獲取所有用戶設備

GET /v1/accounts/{accountID}/users/{userID}/devices

回應主體

響應主體包含一系列設備，其外觀應類似於此：

[
  {
    "id": "device01",
    "created_at": 1571242764,
    "updated_at": 1571242764,
    "name": "my device",
    "user_agent": "Client's user agent"
  }
]

更新設備名稱

的PATCH請求可讓您設置設備的描述性名稱。

PATCH  /v1/accounts/{accountID}/users/{userID}/devices/{deviceID}
  Content-Type: application/json
  Body: {devices object}

要求主體

請求正文包含設備名稱。

{
    "name": "patched-name"
}

這裡是字段的詳細信息：

刪除所有用戶設備

DELETE /v1/accounts/{accountID}/users/{userID}/devices

刪除特定的用戶設備

DELETE /v1/accounts/{accountID}/users/{userID}/devices/{deviceID}