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

    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/{accountID}

    권한

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

    Authorization: Bearer {access_token}

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

    권한

    Cross-Device Resume API에 대한 요청은클라이언트 자격 증명다음 권한으로 :

    • video-cloud/xdr/read

    이러한 권한은 아직 Studio Admin UI에서 사용할 수 없습니다. 그들이 될 때까지 이것을 사용할 수 있습니다. Brightcove Learning Services 앱클라이언트 자격 증명을 만듭니다. 확인하십시오video-cloud/xdr/read자격 증명을 만들 때 확인란을 선택합니다 (원하는만큼 다른 확인란을 선택할 수 있음).

    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 사이에서 중개 역할을하는 서버 측 애플리케이션입니다. 다음은 몇 가지 유용한 링크입니다.