IMA DAI SDK 시작하기

관심 있는 DAI 솔루션 선택

<ph type="x-smartling-placeholder"></ph>

전체 서비스 DAI

이 가이드에서는 IMA CAF DAI SDK를 사용하여 DAI 스트림을 재생하는 방법을 설명합니다. 만약 완료된 샘플 통합과 함께 보거나 따르고 싶은 예를 다운로드하세요.

이 가이드를 사용하기 전에 Chromecast 애플리케이션 프레임워크의 웹 수신기 프로토콜로 구현됩니다. 이 가이드는 메시지 인터셉터mediaInformation 전송 명령 및 컨트롤 사용에 대한 지식뿐만 아니라 전송 명령어 및 컨트롤에 대한 지식 도구를 사용하여 CAF 발신자를 에뮬레이션할 수 있습니다.

IMA DAI를 사용하려면 Ad Manager 360 계정에만 적용됩니다. 광고가 있는 경우 관리자 계정인 경우 자세한 내용은 계정 관리자에게 문의하세요. 정보 자세한 내용은 Ad Manager 도움말 중앙으로 이동합니다.

다른 플랫폼과 통합하거나 IMA SDK를 사용하는 방법에 대한 자세한 내용은 클라이언트 측 SDK에 관한 자세한 내용은 양방향 미디어 광고 SDK를 참고하세요.

CAF DAI 개요

IMA CAF DAI SDK를 사용하여 DAI를 구현하려면 다음 사항을 참조하세요.

  • StreamRequest: Google의 광고 서버에 대한 스트림 요청을 정의하는 객체입니다. 스트림 요청은 크게 두 가지로 나눌 수 있습니다.

    • LiveStreamRequest: 는 자산 키, 선택적 API 키 및 기타 선택적 매개변수를 제공합니다.
    • VODStreamRequest: 콘텐츠 소스 ID, 동영상 ID, API(선택사항)를 지정합니다. 키와 기타 선택적 매개변수를 포함합니다.
  • StreamManager: 동영상 스트림과 IMA DAI SDK 간의 통신(예: 추적 핑 실행 및 스트림 이벤트를 게시자에게 전달)을 처리하는 객체입니다.

기본 요건

  • Cast 개발자 콘솔 계정과 확인할 수 있습니다.
  • 호스팅된 웹 수신기 앱이 Cast 개발자 콘솔에 등록되어 있으며 이를 호스팅하도록 수정할 수 있는 이 가이드에서 제공하는 코드입니다.
  • 웹 수신기 앱을 사용하도록 구성된 전송 앱 예시 Cast 명령 및 제어 도구를 다음과 같이 사용합니다. 있습니다.

발신자의 MediaInfo 객체 구성

먼저 발신기 앱의 MediaInfo 구성 객체를 사용하여 다음 필드를 포함해야 합니다.

contentId 이 미디어 항목의 고유 식별자입니다.
contentUrl DAI StreamRequest가 실패하는 경우 로드할 대체 스트림 URL입니다. 이유
streamType 라이브 스트림의 경우 이 값을 `LIVE`로 설정해야 합니다. VOD 스트림의 경우 이 값은 `BUFFERED`로 설정해야 합니다.
customData assetKey 라이브 스트림만 해당 로드할 라이브 스트림 식별
contentSourceId VOD 스트림만 해당. 있습니다.
videoId VOD 스트림만 해당. 다음 내에서 요청된 스트림을 식별합니다. 지정할 수 있습니다.
ApiKey 스트림 URL을 가져오는 데 필요할 수 있는 선택적 API 키입니다. IMA DAI SDK
senderCanSkip 발신 기기가 수신 기기에 있는지 여부를 알려주는 불리언 값입니다. 건너뛰기 버튼을 표시하여 건너뛸 수 있는 광고를 지원하는 기능

전송 명령 및 제어 도구에서 이 값을 구성하려면 Load(전송) 명령 및 제어 도구에서 Media 탭에서 커스텀 로드 요청 유형을 LOAD로 설정합니다. 그런 다음 다음 JSON 객체 중 하나가 있는 텍스트 영역의 JSON 데이터:

라이브

{
  "media": {
    "contentId": "bbb",
    "contentUrl": "https://storage.googleapis.com/interactive-media-ads/media/bbb.m3u8",
    "streamType": "LIVE",
    "customData": {
      "assetKey": "sN_IYUG8STe1ZzhIIE_ksA",
      "ApiKey": "",
      "senderCanSkip": true
    }
  },
  "credentials": "testCredentials"
}

VOD

{
  "media": {
    "contentId": "tos",
    "contentUrl": "https://storage.googleapis.com/interactive-media-ads/media/tos.m3u8",
    "streamType": "BUFFERED",
    "customData": {
      "contentSourceId": "2548831",
      "videoId": "tears-of-steel",
      "ApiKey": "",
      "senderCanSkip": true
    }
  },
  "credentials": "testCredentials"
}

이 맞춤 로드 요청 객체는 수신자로 전송되어 다음 단계를 따르세요.

기본 CAF 수신기 만들기

CAF SDK 기본 수신기 가이드에 따라 기본 웹 수신기를 만듭니다.

수신자 코드는 다음과 같습니다.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    cast.framework.CastReceiverContext.getInstance().start();
  </script>
</body>
</html>

IMA DAI SDK 가져오기 및 플레이어 관리자 가져오기

스크립트에서 CAF를 로드한 직후에 스크립트 태그를 추가하여 CAF용 IMA DAI SDK를 웹 수신기로 가져옵니다. CAF DAI SDK는 상시 제공되므로 특정 버전을 설정할 수 있습니다 그런 다음 수신기를 시작하기 전에 뒤에 오는 스크립트 태그에 수신기 컨텍스트와 플레이어 관리자를 상수로 저장합니다.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();

    castContext.start();
  </script>
</body>
</html>

IMA 스트림 관리자 초기화

CAF DAI SDK의 스트림 초기화 관리자를 선택합니다.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();
    const streamManager = new google.ima.cast.dai.api.StreamManager();

    castContext.start();
  </script>
</body>
</html>

로드 메시지 인터셉터 만들기

CAF DAI SDK는 CAF 로드 메시지를 사용합니다. 인터셉터 를 사용하여 스트림 요청을 만들고 콘텐츠 URL을 최종 DAI 스트림으로 대체합니다. 메시지 인터셉터는 streamManager.requestStream()을 호출하여 광고 시점 설정, 스트림 요청, 기존 contentURL입니다.

로드 메시지 인터셉터는 하나만 있을 수 있으므로, 앱에서 인터셉터의 경우 커스텀 함수를 동일한 있습니다.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();
    const streamManager = new google.ima.cast.dai.api.StreamManager();

    const getStreamRequest = (request) => null;

    playerManager.setMessageInterceptor(
        cast.framework.messages.MessageType.LOAD, (request) => {
          return streamManager.requestStream(request, getStreamRequest(request))
              .then((request) => {
                this.broadcast('Stream request successful.');
                return Promise.resolve(request);
              })
              .catch((error) => {
                this.broadcast('Stream request failed.');
                return Promise.resolve(request);
              });
        });

    castContext.start();
  </script>
</body>
</html>

스트림 요청 빌드

CAF DAI 통합을 완료하려면 스트림을 빌드해야 합니다. 요청 발신자가 mediaInfo 객체에 포함된 데이터를 사용하여 요청을 전송합니다.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
  <script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    const castContext = cast.framework.CastReceiverContext.getInstance();
    const playerManager = castContext.getPlayerManager();
    const streamManager = new google.ima.cast.dai.api.StreamManager();

    const getStreamRequest = (request) => {
      const imaRequestData = request.media.customData;
      let streamRequest = null;
      if (imaRequestData.assetKey) {
        // Live stream
        streamRequest = new google.ima.cast.dai.api.LiveStreamRequest();
        streamRequest.assetKey = imaRequestData.assetKey;
      } else if (imaRequestData.contentSourceId) {
        // VOD stream
        streamRequest = new google.ima.cast.dai.api.VODStreamRequest();
        streamRequest.contentSourceId = imaRequestData.contentSourceId;
        streamRequest.videoId = imaRequestData.videoId;
      }
      if (streamRequest && imaRequestData.ApiKey) {
        streamRequest.ApiKey = imaRequestData.ApiKey;
      }
      if (streamRequest && imaRequestData.senderCanSkip) {
        streamRequest.senderCanSkip = imaRequestData.senderCanSkip;
      }
      return streamRequest;
    };

    playerManager.setMessageInterceptor(
        cast.framework.messages.MessageType.LOAD, (request) => {
          return streamManager.requestStream(request, getStreamRequest(request))
              .then((request) => {
                return Promise.resolve(request);
              })
              .catch((error) => {
                this.broadcast('Stream request failed.');
                return Promise.resolve(request);
              });
        });

    castContext.start();
  </script>
</body>
</html>

이제 Google CAF DAI SDK로 DAI 스트림을 요청하고 재생할 수 있습니다. 고급 SDK 기능에 대해 자세히 알아보려면 다른 가이드 또는 샘플 수신기를 다운로드해 애플리케이션입니다.