이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Roku용 IMA DAI SDK

클래스 ima

메서드

disableLogging, getStreamManager, initSdk, requestStream

IMA SDK를 제어하는 전역 함수

`disableLogging()`

SDK 로깅을 사용 중지합니다. Logging은 기본적으로 사용 설정됩니다.

`getStreamManager()`

스트림 관리자가 사용 가능한 경우 이를 반환합니다. 스트림 관리자를 아직 사용할 수 없는 경우 Invalid가 반환됩니다. 스트림 관리자를 만드는 중에 오류가 발생하면 오류 객체가 반환됩니다.

반환하는 object: 스트림 관리자 또는 오류 객체.

`initSdk(settings)`

SDK를 초기화합니다.

파라미터	유형	설명
`settings`	`object`	선택적 IMA 설정 객체입니다.

`requestStream(streamRequest)`

비동기 스트림 요청을 시작합니다. 이 메서드를 호출한 후 Control이 즉시 플레이어에 반환됩니다.

반환하는 object: 오류를 반환하거나 오류가 없으면 무효합니다.

파라미터	유형	설명
`streamRequest`	`object`

이름	유형	설명
`adPosition`		광고 시점의 광고 색인입니다. 독립형 광고의 경우 1입니다.
`duration`		광고 시점의 최대 지속 시간(초 단위) 또는 -1(알 수 없는 경우)입니다.
`podIndex`		라이브 스트림의 경우 항상 -1을 반환합니다. VOD의 경우 광고 모음의 색인을 반환합니다. 프리롤 광고 모음의 경우 0을 반환합니다. 미드롤의 경우 1, 2, ..., n을 반환합니다. 포스트롤 광고 모음의 경우 n+1...n+x를 반환합니다. 이 광고가 광고 모음에 속하지 않거나 이 광고 모음이 재생목록에 속하지 않는 경우 기본값은 0입니다.
`timeOffset`		콘텐츠 내 광고 모음의 위치(초) 프리롤은 0을 반환하고 포스트롤은 -1을 반환하며 미드롤은 광고 모음의 예약된 시간을 반환합니다.
`totalAds`		이 광고 시점에 포함된 광고의 총 개수입니다. 독립형 광고의 경우 1입니다.

이름	유형	설명
`AD_PERIOD_ENDED`		스트림이 광고 또는 슬레이트에서 콘텐츠로 전환될 때마다 실행됩니다. 광고가 두 번 재생되거나 광고를 탐색하는 경우에도 실행됩니다.
`AD_PERIOD_STARTED`		스트림이 콘텐츠에서 광고 또는 슬레이트로 전환될 때마다 실행됩니다. 광고가 두 번 재생되거나 광고를 탐색하는 경우에도 실행됩니다.
`COMPLETE`		광고 재생이 완료되면 시작됩니다.
`ERROR`		오류가 발생하면 실행됩니다.
`FIRST_QUARTILE`		광고 플레이헤드가 1분위를 넘어가면 시작됩니다.
`ICON_FALLBACK_IMAGE_CLOSED`		사용자가 아이콘 대체 이미지 대화상자를 닫으면 실행됩니다.
`ICON_FALLBACK_IMAGE_SHOWN`		아이콘 대체 이미지가 표시될 때 실행됩니다.
`MIDPOINT`		광고 플레이헤드가 중간 지점을 넘어가면 시작됩니다.
`PROGRESS`		광고 진행 상황이 업데이트되면 실행됩니다.
`SKIPPABLE_STATE_CHANGED`		광고의 건너뛸 수 있는 상태가 변경되면 실행됩니다.
`SKIPPED`		광고를 건너뛰면 시작됩니다.
`START`		광고 재생이 시작되면 시작됩니다.
`THIRD_QUARTILE`		광고 플레이헤드가 3분위를 넘어가면 시작됩니다.

이름	유형	설명
`adBreakInfo`		이 광고가 포함된 전체 광고 시점과 관련된 정보입니다.
`adDescription`		광고에 대한 설명입니다.
`adId`		광고의 ID이거나 빈 문자열(알 수 없는 경우)입니다.
`adSystem`		광고 소재를 제공하는 광고 시스템입니다.
`adTitle`		광고의 제목입니다.
`advertiserName`		게재업체에서 정의한 광고주 이름입니다.
`companions`		VAST 응답에 지정된 컴패니언 광고입니다.
`currentTime`		광고 내의 현재 시간(초 단위) 또는 -1(알 수 없는 경우)입니다.
`duration`		이 단일 광고의 길이(초 단위) 또는 -1(알 수 없는 경우)입니다.
`skipOffset`		광고를 건너뛸 수 있게 되는 데 걸리는 시간 또는 알 수 없는 경우 -1로 표시됩니다.
`universalAdIDRegistry`		선택한 광고 소재의 범용 광고 ID가 카탈로그화된 레지스트리 웹사이트의 URL을 식별하는 데 사용되는 문자열입니다.
`universalAdIDValue`		광고에 대해 선택된 광고 소재의 범용 광고 ID
`wrappers`		이 광고에 대한 래퍼 정보가 포함된 ima.WrapperInfo의 배열입니다. 순서는 외부 래퍼에서 내부 래퍼가 될 것입니다.

이름	유형	설명
`apiFramework`		이 광고를 실행하는 데 필요한 API이거나 사용할 수 없는 경우 잘못되었습니다.
`creativeType`		광고 소재 유형(일반적으로 MIME 유형)을 나타냅니다.
`height`		컴패니언의 높이(픽셀)입니다. 사용할 수 없는 경우 0입니다.
`trackingEvents`		키가 이벤트이고 값은 이벤트 시 핑할 URL 목록인 추적 이벤트의 맵입니다.
`url`		이 컴패니언의 정적 리소스에 대한 URL입니다.
`width`		컴패니언의 너비(픽셀)입니다. 사용할 수 없는 경우 0입니다.

이름	유형	설명
`end`		큐 시점의 종료 시간(초)입니다. 광고 시점에 해당합니다.
`hasPlayed`		큐 시점이 이미 재생되었음을 나타내는 부울입니다.
`start`		큐 시점의 시작 시간(초)입니다. 광고 시점에 해당합니다.

이름	유형	설명
`id`		오류의 ID입니다. 오류 코드 목록은 ErrorEvent 상수를 참조하세요.
`info`		오류에 대한 추가 정보입니다.
`type`		이 객체의 유형을 나타내려면 항상 오류로 설정하세요.

이름	유형	설명
`BAD_STREAM_REQUEST`		스트림 요청이 제대로 채워지지 않았습니다.
`COULD_NOT_LOAD_STREAM`		스트림을 로드할 수 없습니다.
`ERROR`		알 수 없는 오류입니다.
`INVALID_RESPONSE`		서버 응답이 잘못되었습니다.
`STREAM_API_KEY_NOT_VALID`		제공된 API 키를 서버에서 승인하지 않았습니다.

이름	유형	설명
`format`		동영상 형식: hls 또는 대시. ima.StreamFormat에 정의됩니다.
`manifest`		스트림의 URL입니다.
`streamId`		스트림의 고유 ID입니다.
`streamType`		동영상 유형(라이브 또는 주문형) ima.StreamType에 정의됩니다.
`subtitles`		자막(제공되는 경우) 그렇지 않은 경우 유효하지 않습니다.

파라미터	유형	설명
`streamRequest`	`ima.StreamRequest`
`streamInitResponse`	`ima.StreamInitResponse`

파라미터	유형	설명
`streamManifest`	`string`	광고가 연결된 스트림 매니페스트 URL입니다.
`streamSubtitle`	`ifArray>\|Invalid`	스트림과 연결된 자막이며, 없는 경우 `Invalid`입니다.

이름	유형	설명
`adTagParameters`		선택사항입니다. 스트림 요청에서 제한된 광고 태그 매개변수 집합을 재정의할 수 있습니다. 타겟팅 매개변수를 스트림에 제공에서 자세한 정보를 제공합니다. 스트림 변형 환경설정에 dai-ot 및 dai-ov 매개변수를 사용할 수도 있습니다. 자세한 내용은 스트림 변형 매개변수 재정의를 참고하세요.
`adUiNode`		광고 UI가 표시되는 장면 그래프 노드입니다. IMA는 광고가 게재되는 동안 이 요소에 이 광고가 표시된 이유, 건너뛰기 버튼과 같은 요소를 배치합니다. 이 요소는 전체 동영상 요소를 오버레이해야 합니다.
`apiKey`		선택사항입니다. 이러한 키는 스트림 요청을 인증하는 데 사용할 수 있습니다. DAI 인증 키는 Google Ad Manager UI에서 설정해야 합니다.
`assetKey`		라이브 스트림의 필수 속성입니다. 어떤 스트림을 재생해야 하는지 결정하는 데 사용됩니다. 실시간 스트림 요청 애셋 키는 DFP UI에서 확인할 수 있는 식별자입니다.
`authToken`		스트림 요청 승인 토큰입니다. 더 엄격한 콘텐츠 승인을 위해 API 키 대신 사용됩니다. 게시자는 이 토큰을 기반으로 개별 콘텐츠 스트림 승인을 제어할 수 있습니다.
`contentSourceId`		주문형 스트림에 필요합니다. cmsid는 DFP UI의 DFP 동영상 콘텐츠 소스에서 제공됩니다.
`customAssetKey`		맞춤 애셋 키는 재생할 스트림을 결정하는 데 사용됩니다. 포드 게재 스트림 요청에는 커스텀 애셋 키가 필요합니다.
`format`		스트림의 형식입니다. 기본값은 `ima.StreamFormat.HLS`입니다.
`networkCode`		스트림을 요청하는 게시자의 네트워크 코드입니다. 포드 제공 스트림 요청에는 네트워크 코드가 필요합니다.
`player`		플레이어 인터페이스의 구현입니다.
`ppid`		지원이 중단되었습니다. adTagParameters를 사용합니다. 선택사항입니다. DFP 잠재고객 게시자 제공 식별자
`streamActivityMonitorId`		스트림 활동 모니터로 스트림을 디버그하는 데 사용되는 ID입니다. 게시자가 스트림 활동 모니터링 도구에서 스트림 로그를 찾을 수 있는 편리한 방법을 제공하는 데 사용됩니다.
`videoId`		주문형 스트림에 필요합니다. 동영상 콘텐츠 소스의 식별자입니다.
`videoObject`		클라이언트 앱에서 동영상 재생을 담당하는 동영상 객체 (예: Video roSGNode)입니다. 이 객체는 실시간 HLS ID3 이벤트의 적절한 타이밍에 사용될 다양한 데이터를 확인하기 위해 폴링됩니다.
`videoStitcherSessionOptions`		세션 옵션은 VideoStitcher StreamRequest의 동영상 스티처 관련 매개변수를 설정하는 데 사용됩니다.

이름	유형	설명
`LIVE`		동영상이 게시되었습니다.
`VOD`		주문형 동영상입니다.

파라미터	유형	설명
`adTagUrl`	`string`
`networkCode`	`string`
`contentSourceUrl`	`string`
`region`	`string`
`projectNumber`	`string`
`oAuthToken`	`string`

파라미터	유형	설명
`vodConfigId`	`string`
`networkCode`	`string`
`region`	`string`
`projectNumber`	`string`
`oAuthToken`	`string`

Roku용 IMA DAI SDK

클래스 ima

disableLogging()

getStreamManager()

initSdk(settings)

requestStream(streamRequest)

ima.AdBreakInfo 클래스

속성

createAdBreakInfo()

ima.AdEvent 클래스

속성

ima.AdInfo 클래스

속성

createAdInfo()

ima.Companion 클래스

속성

createCompanion()

ima.CuePoint 클래스

속성

createCuePoint()

ima.Error 클래스

속성

createError()

ima.ErrorEvent 클래스

속성

ima.Player 클래스

adBreakEnded(adBreakInfo)

adBreakStarted(adBreakInfo)

allVideoComplete()

createPlayer()

loadUrl(streamInfo)

ima.StreamFormat 클래스

속성

ima.StreamInfo 클래스

속성

createStreamInfo()

ima.StreamManager 클래스

addEventListener(event, callback)

createStreamManager(streamRequest, streamInitResponse)

enableInteractiveAds()

getContentTime(streamTime)

getCuePoints()

getPreviousCuePoint(time)

getStreamTime(contentTime)

loadThirdPartyStream(streamManifest, streamSubtitle)

onMessage(msg)

replaceAdTagParameters(adTagParameters)

start()

ima.StreamRequest 클래스

속성

createLiveStreamRequest(assetKey, apiKey)

createPodLiveStreamRequest(customAssetKey, networkCode, apiKey)

createPodVodStreamRequest(networkCode)

createStreamRequest()

createVideoStitcherLiveStreamRequest(customAssetKey, networkCode, liveConfigId, region, projectNumber, oAuthToken)

createVideoStitcherVodStreamRequest(adTagUrl, networkCode, contentSourceUrl, region, projectNumber, oAuthToken)

CreateVideoStitcherVodStreamRequestWithVodConfig(vodConfigId, networkCode, region, projectNumber, oAuthToken)

createVodStreamRequest(contentSourceId, videoId, apiKey)

ima.StreamType 클래스

속성

ima.WrapperInfo 클래스

속성

createWrapperInfo()

`disableLogging()`

`getStreamManager()`

`initSdk(settings)`

`requestStream(streamRequest)`

`createAdBreakInfo()`

`createAdInfo()`

`createCompanion()`

`createCuePoint()`

`createError()`

`adBreakEnded(adBreakInfo)`

`adBreakStarted(adBreakInfo)`

`allVideoComplete()`

`createPlayer()`

`loadUrl(streamInfo)`

`createStreamInfo()`

`addEventListener(event, callback)`

`createStreamManager(streamRequest, streamInitResponse)`

`enableInteractiveAds()`

`getContentTime(streamTime)`

`getCuePoints()`

`getPreviousCuePoint(time)`

`getStreamTime(contentTime)`

`loadThirdPartyStream(streamManifest, streamSubtitle)`

`onMessage(msg)`

`replaceAdTagParameters(adTagParameters)`

`start()`

`createLiveStreamRequest(assetKey, apiKey)`

`createPodLiveStreamRequest(customAssetKey, networkCode, apiKey)`

`createPodVodStreamRequest(networkCode)`

`createStreamRequest()`

`createVideoStitcherLiveStreamRequest(customAssetKey, networkCode, liveConfigId, region, projectNumber, oAuthToken)`

`createVideoStitcherVodStreamRequest(adTagUrl, networkCode, contentSourceUrl, region, projectNumber, oAuthToken)`

`CreateVideoStitcherVodStreamRequestWithVodConfig(vodConfigId, networkCode, region, projectNumber, oAuthToken)`

`createVodStreamRequest(contentSourceId, videoId, apiKey)`

`createWrapperInfo()`