구현 장치 제한

소개

Brightcove의 재생 권한 관리 서비스를 사용하면 비디오 재생에 대한 장치 제한을 설정할 수 있습니다. DRM 라이선스 요청 시 각 사용자의 기기는 고유한 ID로 등록됩니다. 사용자당 장치 수를 제어합니다.

장치 제한은 각 라이선스 요청과 함께 확인 및 적용됩니다. 이 제한을 사용하려면 다음을 통과해야 합니다. JSON 웹 토큰(JWT)현재 사용자 ID로uidPlayback API에.

이 기능에 익숙하지 않은 경우 다음을 참조하십시오. 개요: 재생 권한 관리 서비스문서.

기기 등록

다음을 포함하는 유효한 재생 요청이 있을 때 장치가 Brightcove에 등록됩니다. JSON 웹 토큰(JWT) ~와 함께uid그리고dlimit클레임이 접수됩니다. 그 순간부터 이 장치는 하나의 슬롯을 차지하게 됩니다.

구현

기기 제한을 활성화하려면 다음 단계를 따르세요.

만들기 JSON 웹 토큰(JWT)일반적으로 요구되는 클레임과 함께uid그리고dlimit주장.

DRM 라이선스 요청 시 각 사용자의 기기는 고유한 ID로 등록됩니다.

NS dlimit클레임을 통해 지정된 사용자와 연결할 수 있는 장치 수를 제어할 수 있습니다. uid . 값은 > 0 .

만약dlimit이후 요청에서 클레임 값이 삭제되면 이전에 허용된 장치가 계속 작동합니다.

예시
만약dlimit값은 다음으로 설정됩니다. 3 , 사용자는 장치 A, B 및 C에서 재생할 수 있습니다(모두 허용됨). 장치 D에서 재생을 시도하면 거부됩니다.
만약dlimit값이 다음으로 변경됩니다. 1 , 장치 API로 장치를 관리하여 장치를 수동으로 취소하지 않는 한 사용자는 3개의 장치 A, B, C 모두에서 계속 재생할 수 있습니다. 이렇게 하려면 다음을 참조하십시오. 기기 관리부분.
사용자 기기 관리장치 API를 사용합니다. 이 API를 사용하면 사용자의 장치를 가져오고, 장치를 삭제하고, 장치의 이름을 업데이트할 수 있습니다.

디바이스 등록 시 아이디와 닉네임으로 식별합니다. 장치 API를 사용하면 장치 닉네임을 편집하여 장치 목록을 쉽게 관리할 수 있습니다.
플레이어 구성사용하다 JSON 웹 토큰 (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}

액세스 토큰은 Brightcove OAuth 서비스에서 가져와야 하는 임시 OAuth2 액세스 토큰입니다. 클라이언트 자격 증명을 얻고 이를 사용하여 액세스 토큰을 검색하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 브라이트코브 OAuth 개요 .

권한

Devices 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"
    }
]

기기 이름 업데이트

NS 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}