지원 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    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 계정. 따라서 항상 계정이라는 용어 다음에 계정 ID를 기본 URL에 추가합니다.

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

    권한 부여

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

    Authorization: Bearer {access_token}

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

    권한

    교차 기기 재개 API에 대한 요청은 클라이언트 신임장 다음 권한이 있습니다.

    • video-cloud/xdr/read

    Note that these permissions are not yet available in the Studio Admin UI. Until they are, you can use this Brightcove Learning Services app to create your client credentials. Just be sure to check the video-cloud/xdr/read box when you create the credentials (you can check as many other boxes as you like).

    API 메소드

    Cross-Device Resume 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를 지정하면 응답 본문에 하나의 항목 객체가 포함됩니다. 동영상 ID를 두 개 이상 지정하면 items 배열에는 여러 항목 객체가 포함됩니다. 다음과 비슷해야합니다.

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

    서버 측 프록시 사용

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


    페이지 최종 업데이트 22 Sep 2020