XDR API에서 재생 위치 가져오기

이 항목에서는 XDR(Cross-Device Resume) API에서 시청자의 재생 위치를 검색하는 방법을 알아봅니다.

개요

교차 기기 재개를 사용하면 시청자가 한 기기에서 동영상 시청을 시작하고 나중에 다른 기기에서 중단한 부분부터 동영상을 계속 시청할 수 있습니다.

XDR (Cross-Device Resume) API는 클라이언트 측 앱에서 호출 할 수 없으므로 서버 측 프록시를 생성하여 호출하고 재생 위치 값을 반환해야합니다.

재생 위치 가져 오기

기기 간 재시작 (XDR) API를 사용하여 시청자 재생 위치를 확인할 수있습니다.

교차 장치 다시 시작 (XDR) API

Cross-Device Resume API를 사용하여 특정 뷰어의 모든 재생 헤드 위치 또는 특정 뷰어 및 비디오의 모든 재생 헤드를 가져올 수 있습니다.

기본 URL

API의 기본 URL은 다음과 같습니다. 

https://data.brightcove.com/v1/xdr

계정 경로

모든 경우에 특정 Video Cloud 계정에 대한 요청이 이루어집니다. 따라서 항상 기본 URL에 계정이라는 용어와 계정 ID를 추가합니다. 

https://data.brightcove.com/v1/xdr/accounts/{account_id}

권한

요청에 대한 액세스 토큰이 필요하며 권한 부여 헤더에 있어야합니다. 

Authorization: Bearer {access_token}

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

권한

Cross-Device Resume API에 대한 요청은 다음에서 이루어져야 합니다. 클라이언트 자격 증명다음 권한으로:

  • video-cloud/xdr/read

이러한 권한은 아직 Studio Admin UI에서 사용할 수 없습니다. 인증이 완료되기 전까지는 이 Brightcove 학습 서비스 앱을사용하여 클라이언트 자격 증명을 생성할 수 있습니다. 자격 증명을 생성할 때video-cloud/xdr/read확인란을 선택하기만 하면 됩니다 (다른 상자는 원하는 만큼 선택할 수 있음).

API 메소드

Cross-Device Resume API는 다음 요청을 지원합니다. 자세한 내용은크로스 디바이스 재시작 (XDR) API 참조를 참조하십시오 .

뷰어 플레이 헤드 가져 오기

이 요청은 뷰어의 모든 재생 헤드를 가져옵니다. 

GET /accounts/{accountID}/playheads/{viewer_id}
응답 본문

응답 본문에는 비디오 및 재생 헤드 배열이 포함됩니다. 다음과 유사해야합니다. 

{
  "account_id": "1752604059001",
  "viewer_id": "viewer001",
  "items": [
    {
    "timestamp": 1589548991563000,
    "video_id": "6152436480001",
    "playhead_seconds": 17
    },
    {
    "timestamp": 1589548858719000,
    "video_id": "6152440604001",
    "playhead_seconds": 3
    }
  ],
  "size": 2
  }

뷰어 비디오 재생 헤드 가져 오기

이 요청은 시청자 및 특정 동영상에 대한 모든 재생 헤드를 가져옵니다. 

GET /accounts/{account_id}/playheads/{viewer_id}/{video_id}

응답 본문

하나의 비디오 ID를 지정하면 응답 본문에 하나의 항목 객체가 포함됩니다. 비디오 ID를 두 개 이상 지정하면items배열에 여러 항목 객체가 포함됩니다. 다음과 유사해야합니다. 

{
  "account_id": "1752604059001",
  "viewer_id": "viewer001",
  "items": [
    {
    "timestamp": 1589896539910000,
    "video_id": "6156696074001",
    "playhead_seconds": 39
    }
  ],
  "size": 1
  }

서버 측 프록시 사용

프록시는 클라이언트 측 애플리케이션과 REST API 사이에서 중개 역할을하는 서버 측 애플리케이션입니다. 다음은 몇 가지 유용한 링크입니다.