클래스: 미디어

생성자

미디어

new Media(sessionId, mediaSessionId)

매개변수

sessionId

string

세션 식별자입니다.

mediaSessionId

숫자

미디어 식별자입니다.

속성

activeTrackIds

null을 허용하는 숫자 배열

활성 트랙에 해당하는 ID 목록입니다.

breakStatus

(null이 아닌 chrome.cast.media.BreakStatus 또는 정의되지 않음)

수신기에서 광고 시점이 재생 중일 때 광고 시점의 상태입니다. 이 필드는 수신기가 광고 시간을 재생 중일 때는 정의되고, 광고 시점이 재생 중이 아닐 때는 비어 있지만, 콘텐츠에 있는 경우에는 정의되지 않습니다. 콘텐츠에 광고 시점이 포함되어 있지 않으면 정의되지 않습니다.

currentItemId

null을 허용하는 숫자

미디어 상태 변경이 발생했을 때 대기열에 활성 상태였던 항목 ID (재생 중이지 않을 수 있음)입니다.

currentTime

숫자

미디어 시작 후 경과된 현재 재생 위치(초)입니다. 이 구성원은 산발적으로만 업데이트되므로 값이 최신이 아닌 경우가 많습니다. getEstimatedTime 메서드를 사용하여 수신기가 보고한 마지막 정보를 기반으로 실제 재생 위치의 추정치를 가져옵니다.

지원 중단됨
대신 getEstimatedTime을 사용하세요.

customData

null을 허용하는 객체

수신기 애플리케이션에서 설정한 맞춤 데이터 세트입니다.

idleReason

null 허용 chrome.cast.media.IdleReason

수신자가 알고 있는 경우 유휴 사유입니다.

items

null이 아닌 chrome.cast.media.QueueItem의 null을 허용하는 배열

큐에 있는 정렬된 항목의 배열입니다.

liveSeekableRange

(null이 아닌 chrome.cast.media.LiveSeekableRange 또는 정의되지 않음)

실시간 또는 이벤트 스트림의 검색 가능한 범위입니다. 상대적 미디어 시간(초)을 사용합니다. VOD 스트림에는 정의되지 않습니다.

loadingItemId

null을 허용하는 숫자

현재 수신기에서 로드 중인 항목의 항목 ID입니다. 현재 로드 중인 항목이 없는 경우 null이 반환됩니다.

media

null 허용 chrome.cast.media.MediaInfo

미디어 설명입니다.

mediaSessionId

숫자

미디어 항목을 식별합니다.

playbackRate

숫자

재생 속도입니다. 1.0은 일반 재생을 나타냅니다.

playerState

non-null chrome.cast.media.PlayerState

플레이어의 상태입니다.

preloadedItemId

null을 허용하는 숫자

다음 항목의 ID로, 미리 로드된 경우에만 사용할 수 있습니다. 수신기에서 미디어 항목은 메모리에 임시로 미리 로드되고 캐시될 수 있으므로 나중에 로드될 때 프로세스가 더 빨라집니다 (네트워크에서 미디어를 가져올 필요가 없기 때문).

queueData

(null이 아닌 chrome.cast.media.QueueData 또는 정의되지 않음)

큐 데이터

repeatMode

non-null chrome.cast.media.RepeatMode

현재 재생목록 재생의 반복 모드입니다.

sessionId

string

미디어를 호스팅하는 세션을 식별합니다.

supportedMediaCommands

non-null Array of non-null chrome.cast.media.MediaCommand

미디어 플레이어에서 지원하는 미디어 명령어입니다.

videoInfo

(null이 아닌 chrome.cast.media.VideoInformation 또는 정의되지 않음)

동영상 정보입니다.

볼륨

null이 아닌 chrome.cast.Volume

미디어 스트림 볼륨입니다. Volume.level 및 Volume.muted는 항상 설정됩니다.

방법

addUpdateListener

addUpdateListener(listener)

미디어의 상태가 변경되었을 때 호출되는 리스너를 추가합니다. currentTime, Volume, metadata, playbackRate, playerState, customData를 변경하면 리스너가 트리거됩니다. 미디어의 getStatus 메서드 호출이 성공하면 리스너도 트리거됩니다.

매개변수

리스너

function(boolean)

추가할 리스너입니다. 매개변수는 미디어 객체가 아직 활성 상태인지 여부를 나타냅니다.

editTracksInfo

editTracksInfo(editTracksInfoRequest, successCallback, errorCallback)

텍스트 트랙 스타일을 수정하거나 트랙 상태를 변경합니다. 트랙 ID가 기존 트랙 ID와 일치하지 않으면 전체 요청이 실패하고 상태가 변경되지 않습니다.

매개변수

editTracksInfoRequest

chrome.cast.media.EditTracksInfoRequest

값은 null이 아니어야 합니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

getEstimatedBreakClipTime

getEstimatedBreakClipTime() returns (number or undefined)

수신기가 보고한 마지막 정보를 기반으로 현재 클립 위치를 추정합니다.

반환 값

(number or undefined) 미디어 시작 후 경과된 현재 클립 위치 추정치(초)입니다. 광고 시점이 재생되지 않을 때 breakStatus 또는 currentBreakClipTime이 정의되지 않은 경우 정의되지 않음을 반환합니다.

getEstimatedBreakTime

getEstimatedBreakTime() returns (number or undefined)

수신기가 보고한 마지막 정보를 기반으로 현재 광고 시점을 예측합니다.

반환 값

(number or undefined) 미디어 시작 이후의 현재 광고 시점 위치 추정치(초)입니다. breakStatus 또는 currentBreakTime이 정의되지 않은 경우 (광고 시간이 재생되지 않을 때) 정의되지 않은 값을 반환합니다.

getEstimatedLiveSeekableRange

getEstimatedLiveSeekableRange() returns (chrome.cast.media.LiveSeekableRange or undefined)

수신자가 보고한 마지막 정보를 기반으로 liveSeekableRange의 시작을 초 단위로 추정합니다.

반환 값

(non-null chrome.cast.media.LiveSeekableRange or undefined) 현재 liveSeekableRange의 추정치입니다. 콘텐츠가 게시되지 않을 때 liveSeekableRange, liveSeekableRange.start 또는 liveSeekableRange.end가 정의되지 않은 경우 undefined가 반환됩니다.

getEstimatedTime

getEstimatedTime()은 숫자를 반환

수신기에 의해 보고된 마지막 정보를 기반으로 현재 재생 위치를 추정합니다.

반환 값

number 미디어 시작 후 현재 재생 위치의 추정치(초)입니다.

getStatus

getStatus(getStatusRequest, successCallback, errorCallback)

수신 애플리케이션에서 미디어 항목의 상태를 가져옵니다.

지정된 성공Callback과 함께 추가된 미디어 업데이트 리스너는 수신 애플리케이션에서 상태가 수신될 때 호출됩니다. 이 메서드를 호출하여 미디어 상태를 폴링하는 대신 앱에서는 미디어가 변경될 때마다 미디어 업데이트 리스너의 자동 호출을 사용해야 합니다.

매개변수

getStatusRequest

chrome.cast.media.GetStatusRequest

get 상태 요청(선택사항)입니다.

successCallback

함수()

수신기 애플리케이션에서 상태가 수신되면 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

일시중지

일시중지(pauseRequest, 성공콜백, 오류콜백)

미디어 항목을 일시중지합니다.

매개변수

pauseRequest

chrome.cast.media.PauseRequest

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 미디어 일시중지 요청입니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

플레이

play(playRequest, successCallback, errorCallback)

미디어 항목을 재생합니다.

매개변수

playRequest

chrome.cast.media.PlayRequest

선택적 미디어 재생 요청입니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueAppendItem

queueAppendItem(item, successCallback, errorCallback)

새 미디어 항목을 대기열 끝에 추가합니다.

매개변수

항목

chrome.cast.media.QueueItem

큐 끝에 추가할 항목입니다.

값은 null이 아니어야 합니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueInsertItems

queueInsertItems(queueInsertItemsRequest, successCallback, errorCallback)

새 미디어 항목 목록을 대기열에 삽입합니다.

매개변수

queueInsertItemsRequest

chrome.cast.media.QueueInsertItemsRequest

미디어 대기열에 미디어 항목 삽입 요청입니다.

값은 null이 아니어야 합니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueJumpToItem

queueJumpToItem(itemId, successCallback, errorCallback)

대기열에 itemId가 있는 항목을 재생합니다.

itemId가 원래 존재하지 않았거나 이 함수를 호출하기 전에 다른 발신자가 삭제했기 때문에 큐에서 itemId를 찾을 수 없는 경우 이 함수는 수신자에게 요청을 전송하지 않고 자동으로 반환됩니다.

매개변수

itemId

숫자

이동할 항목의 ID입니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueMoveItemToNewIndex

queueMoveItemToNewIndex(itemId, newIndex, successCallback, errorCallback)

itemId가 있는 항목을 대기열의 newIndex 위치에 있도록 이동합니다.

itemId가 원래 존재하지 않았거나 이 함수를 호출하기 전에 다른 발신자가 삭제했기 때문에 큐에서 itemId를 찾을 수 없는 경우 이 함수는 수신자에게 요청을 전송하지 않고 자동으로 반환됩니다.

newIndex가 음수이면 errorCallback이 호출됩니다. 하지만 newIndex가 잘못 지정되었거나 다른 발신자가 큐를 줄여서 오버플로가 발생하면 항목은 큐의 끝으로 이동합니다.

매개변수

itemId

숫자

이동할 항목의 ID입니다.

newIndex

숫자

항목의 새 색인입니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueNext

queueNext(successCallback, errorCallback)

대기열의 다음 항목으로 이동합니다.

매개변수

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queuePrev

queuePrev(successCallback, errorCallback)

대기열의 이전 항목으로 이동합니다.

매개변수

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueRemoveItem

queueRemoveItem(itemId, successCallback, errorCallback)

대기열에서 itemId가 있는 항목을 삭제합니다.

itemId가 원래 존재하지 않았거나 이 함수를 호출하기 전에 다른 발신자가 삭제했기 때문에 큐에서 itemId를 찾을 수 없는 경우 이 함수는 수신자에게 요청을 전송하지 않고 자동으로 반환됩니다.

매개변수

itemId

숫자

삭제할 항목의 ID입니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueReorderItems

queueReorderItems(queueReorderItemsRequest, successCallback, errorCallback)

대기열의 미디어 항목 목록을 재정렬합니다.

매개변수

queueReorderItemsRequest

chrome.cast.media.QueueReorderItemsRequest

미디어 대기열의 항목 재정렬 요청입니다.

값은 null이 아니어야 합니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueSetRepeatMode

queueSetRepeatMode(repeatMode, successCallback, errorCallback)

큐의 반복 모드를 설정합니다.

매개변수

repeatMode

chrome.cast.media.RepeatMode

현재 항목이 종료된 경우 다음 항목을 선택하는 알고리즘입니다.

값은 null이 아니어야 합니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

queueUpdateItems

queueUpdateItems(queueUpdateItemsRequest, successCallback, errorCallback)

미디어 대기열의 속성(예: 반복 모드)과 미디어 대기열에 있는 기존 항목 속성을 업데이트합니다.

매개변수

queueUpdateItemsRequest

chrome.cast.media.QueueUpdateItemsRequest

미디어 대기열의 속성 업데이트 요청입니다.

값은 null이 아니어야 합니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

removeUpdateListener

removeUpdateListener(listener)

이 Media에 대해 이전에 추가된 리스너를 제거합니다.

매개변수

리스너

function(boolean)

제거할 리스너입니다.

노력

탐색(seekRequest, 성공Callback, 오류콜백)

미디어 항목을 찾습니다.

매개변수

seekRequest

chrome.cast.media.SeekRequest

미디어 탐색 요청입니다.

값은 null이 아니어야 합니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

setVolume

setVolume(volumeRequest, successCallback, errorCallback)

미디어 스트림 볼륨을 설정합니다. VolumeRequest.level 또는 VolumeRequest.muted를 하나 이상 설정해야 합니다. 음소거 상태를 변경해도 볼륨 수준에 영향을 미치지 않으며 반대의 경우도 마찬가지입니다.

매개변수

volumeRequest

chrome.cast.media.VolumeRequest

볼륨 설정 요청

값은 null이 아니어야 합니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

경유

중지(stopRequest, 성공콜백, 오류콜백)

미디어 플레이어를 중지합니다.

매개변수

stopRequest

chrome.cast.media.StopRequest

중지 요청입니다.

successCallback

함수()

성공 시 호출됩니다.

errorCallback

function(non-null chrome.cast.Error)

오류 시 호출됩니다. 가능한 오류는 TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR, EXTENSION_MISSING입니다.

supportsCommand

SupportCommand(command)가 불리언을 반환함

미디어 플레이어에서 지정된 미디어 명령어를 지원하는지 확인합니다.

매개변수

command

chrome.cast.media.MediaCommand

쿼리할 명령어입니다.

값은 null이 아니어야 합니다.

반환 값

boolean 플레이어가 명령어를 지원하는 경우 true입니다.