addEventListener

addEventListener(eventType, eventListener)

재생 이벤트를 수신 대기하는 이벤트 리스너를 추가합니다.

생성 값

non-null Error: 제공된 인수가 유효하지 않은 경우

addSupportedMediaCommands

addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

지원되는 미디어 명령어의 기존 목록에 지원되는 새 명령어를 추가합니다.

참고 항목

cast.framework.messages.Command

broadcastStatus

broadcastStatus(includeMedia, requestId, customData, includeQueueItems)

모든 발신자에게 미디어 상태 메시지를 전송합니다 (브로드캐스트). 애플리케이션은 이를 사용하여 맞춤 상태 변경을 전송합니다.

getAbsoluteTimeForMediaTime

getAbsoluteTimeForMediaTime(mediaTime)은 숫자를 반환합니다.

미디어 시간을 미디어 절대 시간으로 변환합니다. 절대 시간은 라이브 스트림에만 적용됩니다.

반환 값

nullable number 절대 시간 또는 null(없는 경우)입니다.

getAudioTracksManager

getAudioTracksManager()는 cast.framework.AudioTracksManager를 반환합니다.

AudioTracksManager 인스턴스를 가져옵니다.

반환 값

non-null cast.framework.AudioTracksManager 

getBreakClipCurrentTimeSec

getBreakClipCurrentTimeSec()은 숫자를 반환합니다.

현재 재생 중인 광고 클립의 현재 시간을 초 단위로 반환합니다.

반환 값

nullable number 현재 광고 애드립 내 현재 시간(초)입니다. Player이 휴식 클립을 재생하지 않는 경우 null

getBreakClipDurationSec

getBreakClipDurationSec()은 숫자를 반환합니다.

현재 재생 중인 광고 클립의 길이를 초 단위로 반환합니다.

반환 값

nullable number 현재 광고 클립의 길이입니다. Player이 광고 클립을 재생하지 않는 경우 null가 발생합니다.

getBreakManager

getBreakManager()는 cast.framework.breaks.BreakManager를 반환합니다.

BreakManager 인스턴스를 가져옵니다.

반환 값

non-null cast.framework.breaks.BreakManager 

getBreaks

getBreaks() returns Array of non-null cast.framework.messages.Break

브레이크 목록을 반환합니다.

반환 값

non-null Array of non-null cast.framework.messages.Break 

getCurrentSupportedMediaCommands

getCurrentSupportedMediaCommands()는 숫자를 반환합니다.

현재 수신기에서 지원하는 미디어 명령어를 가져옵니다. getSupportedMediaCommands()와 달리 이 메서드의 반환 값은 현재 재생 상태에 따라 동적으로 변경됩니다. 예를 들어 광고 재생 중에는 SEEK 명령어가 지원되지 않을 수 있습니다. 이 메서드는 수신기 CastReceiverContext#start를 호출한 후에만 호출해야 합니다. 그렇지 않으면 0가 반환됩니다.

참고 항목

cast.framework.messages.Command

반환 값

number 애플리케이션에서 지원하는 미디어 명령어의 비트 마스크입니다.

getCurrentTimeSec

getCurrentTimeSec()은 숫자를 반환합니다.

현재 미디어의 경과된 재생 시간을 가져옵니다.

반환 값

number 경과 시간(초)입니다. 재생 중인 미디어가 없으면 0입니다.

getDurationSec

getDurationSec()은 숫자를 반환합니다.

현재 재생 중인 미디어의 길이를 초 단위로 가져옵니다.

반환 값

number 미디어 길이입니다. NaN(재생 중인 미디어가 없는 경우)

getLiveSeekableRange

getLiveSeekableRange()는 cast.framework.messages.LiveSeekableRange를 반환합니다.

시작 시간과 종료 시간이 초 단위인 라이브 탐색 가능 범위를 반환합니다. 값은 미디어 시간을 기준으로 합니다.

반환 값

nullable cast.framework.messages.LiveSeekableRange 

getMediaInformation

getMediaInformation()은 cast.framework.messages.MediaInformation을 반환합니다.

현재 미디어의 미디어 정보를 가져옵니다.

반환 값

nullable cast.framework.messages.MediaInformation 

getMediaTimeForAbsoluteTime

getMediaTimeForAbsoluteTime(absoluteTime)은 숫자를 반환합니다.

미디어 절대 시간을 미디어 시간으로 변환합니다. 절대 시간은 라이브 스트림에만 적용됩니다.

반환 값

nullable number 미디어 시간입니다. 없는 경우 null입니다.

getPlaybackConfig

getPlaybackConfig()는 cast.framework.PlaybackConfig를 반환합니다.

재생 구성을 반환하거나 기본값이 재정의되지 않은 경우 null을 반환합니다.

반환 값

nullable cast.framework.PlaybackConfig 

getPlaybackRate

getPlaybackRate()는 숫자를 반환합니다.

현재 재생 속도를 반환합니다. 수신기 CastReceiverContext#start가 호출되기 전에 1를 반환합니다.

반환 값

number 현재 재생 속도입니다.

getPlayerState

getPlayerState()는 cast.framework.messages.PlayerState를 반환합니다.

Player 상태를 가져옵니다.

반환 값

non-null cast.framework.messages.PlayerState 현재 Player의 상태입니다.

getPreferredPlaybackRate

getPreferredPlaybackRate()는 숫자를 반환합니다.

기본 재생 속도를 가져옵니다. 종료 이벤트에서 사용하여 최신 선호 재생 속도를 영구 저장소에 저장할 수 있으므로 캐스트 옵션의 다음 세션에서 사용할 수 있습니다.

반환 값

number 

getPreferredTextLanguage

getPreferredTextLanguage()는 문자열을 반환합니다.

기본 텍스트 트랙 언어를 가져옵니다.

반환 값

nullable string 

getPreferredTextStyle

getPreferredTextStyle()은 cast.framework.messages.TextTrackStyle을 반환합니다.

선호하는 텍스트 트랙 스타일을 가져옵니다.

반환 값

nullable cast.framework.messages.TextTrackStyle 

getQueueManager

getQueueManager() returns (cast.framework.QueueManager or undefined)

QueueManager 인스턴스를 가져옵니다.

반환 값

(non-null cast.framework.QueueManager or undefined) 

getRawCurrentTimeSec

getRawCurrentTimeSec()은 숫자를 반환합니다.

광고 시점 시간을 빼지 않고 현재 미디어의 경과된 재생 시간을 가져옵니다.

반환 값

number 경과 시간(초)입니다. 재생 중인 미디어가 없으면 0입니다.

getRawSeekableRange

getRawSeekableRange()는 cast.framework.messages.Range를 반환합니다.

현재 미디어 탐색 가능 범위를 반환합니다.

참고: 이는 getRawCurrentTimeSec()의 단위와 일치하지만 seek()과는 일치하지 않습니다. 광고 또는 기타 미디어 오프셋은 고려하지 않습니다. 원시 값이 필요한지 확실하지 않다면 대신 getLiveSeekableRange()를 사용해야 합니다.

반환 값

nullable cast.framework.messages.Range 

getStartAbsoluteTime

getStartAbsoluteTime()은 숫자를 반환합니다.

절대 미디어 시작 시간을 가져옵니다(UNIX 에포크 이후 경과된 시간(초)). 절대 시간은 라이브 스트림에만 적용됩니다.

반환 값

nullable number 

getStats

getStats()는 cast.framework.stats.Stats를 반환합니다.

재생 통계를 반환합니다. 통계는 적절한 경우 전체 재생 세션에 걸쳐 집계됩니다.

반환 값

non-null cast.framework.stats.Stats 

getSupportedMediaCommands

getSupportedMediaCommands()는 숫자를 반환합니다.

수신기 지원 미디어 명령어를 가져옵니다. CastReceiverContext#start()를 호출한 후에만 호출해야 합니다. 그렇지 않으면 0를 반환합니다. 지원되는 미디어 명령어 값은 수신기 애플리케이션에 의해서만 제어됩니다 . MediaStatus에 따라 자동으로 업데이트되지 않습니다.

참고 항목

cast.framework.messages.Command

반환 값

number 애플리케이션에서 지원하는 미디어 명령어의 비트 마스크입니다.

getTextTracksManager

getTextTracksManager()는 cast.framework.TextTracksManager를 반환합니다.

TextTracksManager 인스턴스를 가져옵니다.

반환 값

non-null cast.framework.TextTracksManager 

getTimedMetadata

getTimedMetadata()는 null이 아닌 cast.framework.TimedMetadata 배열을 반환합니다.

매니페스트 파싱 중에 발견된 시간 제한 메타데이터를 반환합니다. HLS에서는 #EXT-X-DATERANGE이고 DASH에서는 EventStream입니다.

반환 값

non-null Array of non-null cast.framework.TimedMetadata 

load

load(loadRequest)는 void가 포함된 Promise를 반환합니다.

미디어를 로드하는 요청을 시작합니다.

반환 값

non-null Promise containing void 작업이 성공하면 해결되고 실패하면 거부되는 프라미스입니다.

일시중지

pause()

현재 재생 중인 미디어를 일시중지합니다.

재생

play()

현재 일시중지된 미디어를 재생합니다.

removeEventListener

removeEventListener(eventType, eventListener)

지정된 재생 이벤트에 추가된 이벤트 리스너를 삭제합니다. 일치하는 이벤트 리스너가 없으면 이 호출은 무시됩니다.

removeSupportedMediaCommands

removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

지원되는 미디어 명령어 목록에서 명령어를 삭제합니다.

참고 항목

cast.framework.messages.Command

노력

seek(seekTime)

현재 미디어에서 탐색합니다.

sendCustomState

sendCustomState(state)

애플리케이션 재생 로직에서 UI 로직으로 맞춤 상태를 전송합니다. 이 메서드는 재생 로직과 UI를 분리하는 데 도움이 됩니다. 로직과 UI를 분리하면 로컬 재생과 원격 제어 모두에 동일한 UI 로직을 사용할 수 있습니다. 이 메서드로 전송된 맞춤 상태는 PlayerData를 통해 UI에서 사용할 수 있습니다.

참고 항목

cast.framework.ui.PlayerData#customState

sendError

sendError(senderId, requestId, type, reason, customData)

특정 발신자에게 오류를 전송합니다.

sendLocalMediaRequest

sendLocalMediaRequest(request)

로컬 미디어 요청을 전송합니다.

sendStatus

sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)

특정 발신자에게 미디어 상태 메시지를 전송합니다.

setIdleReason

setIdleReason(idleReason)

플레이어가 IDLE 상태인 이유를 설정합니다. 이를 통해 IDLE 상태를 강제하려는 애플리케이션은 그 이유 (예: 맞춤 오류)를 나타낼 수 있습니다. 유휴 상태 이유는 다음 상태 메시지에서 전송됩니다. 참고 대부분의 애플리케이션은 이 값을 설정할 필요가 없습니다. 앱이 특수한 상황에서 Player를 IDLE 상태로 전환해야 하고 기본 idleReason이 의도한 동작을 반영하지 않는 경우에만 필요합니다.

setMediaElement

setMediaElement(mediaElement)

사용할 HTMLMediaElement를 설정합니다. HTMLMediaElement의 Promise이 설정되면 Promise이 해결된 후 미디어가 재생되기 시작합니다.

setMediaInformation

setMediaInformation(mediaInformation, opt_broadcast)

미디어 정보를 설정합니다.

setMediaPlaybackInfoHandler

setMediaPlaybackInfoHandler(handler)

특정 로드 요청에 대해 cast.framework.PlaybackConfig를 반환하거나 수정하는 핸들러를 설정합니다. 핸들러 매개변수는 수신기용 LoadRequestData 및 기본 PlaybackConfig입니다 (CastReceiverOptions에 제공됨). 핸들러는 수정된 재생 구성을 반환하거나 미디어 재생을 방지하기 위해 null을 반환해야 합니다. 반환 값은 서버에서 데이터를 기다릴 수 있도록 Promise일 수도 있습니다.

setMediaUrlResolver

setMediaUrlResolver(resolver)

LOAD 요청의 미디어 URL을 반환하는 핸들러를 설정합니다. 이 핸들러는 미디어 콘텐츠 URL이 미디어 상태의 일부로 게시되지 않도록 하는 데 사용할 수 있습니다. 기본적으로 미디어 contentId이 콘텐츠 URL로 사용됩니다.

setMessageInterceptor

setMessageInterceptor(type, interceptor)

수신 및 발신 메시지의 인터셉터를 설정합니다. 인터셉터는 요청 데이터를 업데이트할 수 있으며, 업데이트된 데이터나 업데이트된 데이터가 포함된 Promise (데이터를 즉시 반환할 수 없는 경우) 또는 요청을 처리하지 않아야 하는 경우 null를 반환해야 합니다. 참고: LOAD 메시지 인터셉터가 제공되지만 별도의 PRELOAD 인터셉터가 제공되지 않으면 PRELOAD 메시지에 LOAD 인터셉터가 호출됩니다.

setPlaybackConfig

setPlaybackConfig(playbackConfig)

PlayerManager에서 재생 구성을 설정합니다.

setSupportedMediaCommands

setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

수신기에서 지원하는 미디어 명령어를 설정합니다.

참고 항목

cast.framework.messages.Command

중지

stop()

현재 재생 중인 미디어를 중지합니다.