デバイス制限の実装

入門

Brightcove再生制限を使用すると、ビデオ再生のデバイス制限を設定できます。DRM ライセンス要求が行われると、各ユーザーのデバイスは一意の ID で登録されます。ユーザーごとのデバイスの数を制御します。

デバイス制限は、ライセンス要求ごとにチェックされ、適用されます。この制限を使用するには、 JSON Web Token（JWT）現在のユーザーIDでuidPlayback APIに。

この機能を初めて使用する場合は、概要：Brightcoveの再生制限資料。

デバイス登録

デバイスは、以下を含む有効な再生要求時にBrightcoveに登録されます。 JSON Web Token（JWT）とuidそしてdlimitクレームを受け取ります。その瞬間から、このデバイスは1つのスロットを占有します。

JWTの主張

デバイスの制限については、一般的に必要なクレームとともに次のクレームを使用できます。

uid:

エンドビューアのユーザー ID。このフィールドは、デバイスの登録に必要です。
dlimit:

DRMコンテンツの場合、dlimitクレームは、ユーザーがストリーミングできるデバイスの数を示します。ストリームを要求する各ユーザーのすべてのデバイスが登録されます。ストリーム制限に達すると、それ以上のデバイスはストリーミングできなくなります。

ザ・dlimitクレームを使用すると、指定したユーザーに関連付けることができるデバイスの数を制御できますuid。値は>でなければなりません0。

の場合dlimitクレーム値は後のリクエストで削除され、以前に許可されたデバイスは引き続き動作します。

例
の場合dlimit値はに設定されます3、ユーザーはデバイスA、B、およびCでプレイできます（すべて許可されます）。デバイス D で再生しようとすると拒否されます。
の場合dlimit値がに変更されます1、Devices APIを使用してデバイスを管理することでデバイスを手動で取り消さない限り、ユーザーは3つのデバイスA、B、Cすべてで引き続きプレイできます。これを行うには、を参照してくださいデバイスを管理するセクション。

実装

デバイス制限を使用するには、次の手順に従います。

作成するJSON Web Token（JWT）一般的に必要なクレームとuidそしてdlimit請求。

DRM ライセンス要求が行われると、各ユーザーのデバイスは一意の ID で登録されます。
ユーザーデバイスを管理するデバイスAPIを使用します。このAPIを使用すると、ユーザーのデバイスを取得したり、デバイスを削除したり、デバイスの名前を更新したりできます。

デバイスが登録されると、IDとニックネームで識別されます。Devices APIを使用すると、デバイスのニックネームを編集できるため、デバイスのリストを簡単に管理できます。
プレーヤーを構成するを使用するにはJSONWebトークン（JWT）前のステップで作成されました。

デバイスを管理する

あなたはでユーザーデバイスを管理することができますデバイスAPI。

デバイスAPI

Devices APIを使用すると、ユーザーデバイスを取得および削除できます。

ベース URL

API のベース URL は次のとおりです。

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

アカウントパス

いずれの場合も、特定の Video Cloud アカウントに対してリクエストが行われます。したがって、あなたは常にベースURLにアカウントIDが続く用語アカウントを追加します。

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

認証

リクエストのアクセストークンが必要で、Authorization ヘッダーに存在する必要があります。

Authorization: Bearer {access_token}

アクセストークンは、一時的な OAuth2 アクセストークンで、Brightcove OAuth サービスから取得する必要があります。クライアントクレデンシャルを取得してアクセストークンを取得する方法の詳細については、「 Brightcove OAuth の概要」を参照してください。

権限

デバイスAPIへのリクエストは、クライアントの資格情報次の権限を持つ：

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

API メソッド

Devices APIは、次のリクエストをサポートしています。詳細については、デバイスAPIリファレンス。

すべてのユーザーデバイスを取得する

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

レスポンスボディ

応答本文にはデバイスの配列が含まれており、次のようになります。

[
    {
        "id": "12e12345-11e1-1bd1-d123-1234567890",
        "created_at": 1612646018,
        "updated_at": 1612646018,
        "name": "my device1",
        "user_agent": "PlayReadyClient"
    },
    {
        "id": "WVCf123456789abcdefghijkl1234567890abcdefg",
        "created_at": 1612385697,
        "updated_at": 1612385697,
        "name": "my device2",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:85.0) Gecko/20100101 Firefox/85.0"
    }
]

デバイス名を更新する

ザ・PATCH requestを使用すると、デバイスのわかりやすい名前を設定できます。

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

リクエスト本文

リクエストの本文にはデバイス名が含まれています。

{
    "name": "my device1"
}

フィールドの詳細は次のとおりです。

フィールド	タイプ	説明
`name`	文字列	デバイスの識別に役立つわかりやすいニックネーム

すべてのユーザーデバイスを削除します

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

特定のユーザーデバイスを削除する

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

ページコンテンツ