클래스: PlayerManager

cast.framework.PlayerManager

클래스   정적

미디어 재생을 제어하고 모니터링합니다.

생성 값

non-null Error 생성자가 직접 사용되는 경우 PlayerManager는 cast.framework.CastReceiverContext#getPlayerManager를 호출하여만 액세스해야 합니다.

방법

addEventListener

addEventListener(eventType, eventListener)

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

매개변수
eventType	(null이 아닌 cast.framework.events.EventType 또는 null이 아닌 cast.framework.events.EventType의 null이 아닌 배열) 이벤트 유형 또는 이벤트 유형의 배열
eventListener	function(non-null cast.framework.events.Event)

생성 값

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

addSupportedMediaCommands

addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

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

매개변수
supportedMediaCommands	숫자 애플리케이션에서 지원하는 미디어 명령어의 비트마스크입니다.
broadcastStatus	선택사항 boolean true는 발신자에게 변경사항에 대한 알림을 받아야 함을 나타냅니다. 값을 제공하지 않으면 발신자에게 알림이 전송됩니다.

참고 항목

cast.framework.messages.Command

broadcastStatus

broadcastStatus(includeMedia, requestId, customData, includeQueueItems)

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

매개변수
includeMedia	선택사항 boolean true는 메시지에 미디어 정보를 포함해야 함을 나타냅니다.
requestId	선택사항 숫자 이 응답의 원인이 된 수신 요청의 ID입니다.
customData	선택사항 객체 상태 메시지 애플리케이션별 맞춤 데이터입니다. 값이 null일 수 있습니다.
includeQueueItems	선택사항 boolean 상태 메시지에 큐 항목을 포함할지 여부입니다. 기본적으로 포함되지 않습니다.

getAbsoluteTimeForMediaTime

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

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

매개변수
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()가 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)은 숫자를 반환

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

매개변수
absoluteTime	숫자 UNIX 에포크 시간 (Unix 에포크 이후의 초 단위)으로, 미디어의 절대 시간입니다.

반환 값

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입니다.

getStartAbsoluteTime

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

절대 미디어 시작 시간을 UNIX 에포크 시간 (Unix 에포크 시간 이후의 초)으로 가져옵니다. 절대 시간은 실시간 스트림에만 적용됩니다.

반환 값

nullable number 

getStats

getStats() returns 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를 반환

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

매개변수
loadRequest	cast.framework.messages.LoadRequestData 미디어 로드 요청입니다. 값은 null이 아니어야 합니다.

반환 값

non-null Promise containing void 작업이 성공할 때 확인되고 실패 시 거부되는 프로미스입니다.

일시중지

일시중지()

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

플레이

play()

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

removeEventListener

removeEventListener(eventType, eventListener)

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

매개변수
eventType	(null이 아닌 cast.framework.events.EventType 또는 null이 아닌 cast.framework.events.EventType의 null이 아닌 배열) eventType 또는 이벤트 유형의 배열
eventListener	function(non-null cast.framework.events.Event)

removeSupportedMediaCommands

removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

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

매개변수
supportedMediaCommands	숫자 애플리케이션에서 지원하는 미디어 명령어의 비트마스크입니다.
broadcastStatus	선택사항 boolean true는 발신자에게 변경사항에 대한 알림을 받아야 함을 나타냅니다. 값을 제공하지 않으면 발신자에게 알림이 전송됩니다.

참고 항목

cast.framework.messages.Command

노력

탐색(seekTime)

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

매개변수
seekTime	숫자

sendCustomState

sendCustomState(state)

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

매개변수
state	객체 맞춤 상태 객체입니다. 값은 null이 아니어야 합니다.

참고 항목

cast.framework.ui.PlayerData#customState

sendError

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

특정 발신자에게 오류를 보냅니다.

매개변수
senderId	string 발신자 ID입니다.
requestId	숫자 이 오류를 일으킨 수신 요청의 ID입니다.
유형	cast.framework.messages.ErrorType 오류 유형입니다. 값은 null이 아니어야 합니다.
reason	선택사항 cast.framework.messages.ErrorReason 오류 이유입니다. 값이 null일 수 있습니다.
customData	선택사항 객체 오류 메시지 애플리케이션별 커스텀 데이터입니다. 값이 null일 수 있습니다.

sendLocalMediaRequest

sendLocalMediaRequest(request)

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

매개변수
요청	cast.framework.messages.RequestData 값은 null이 아니어야 합니다.

sendStatus

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

특정 발신자에게 미디어 상태 메시지를 보냅니다.

매개변수
senderId	string 발신자 ID입니다.
requestId	숫자 이 응답의 원인이 된 수신 요청의 ID입니다.
includeMedia	선택사항 boolean true는 메시지에 MediaInformation 인스턴스를 포함해야 함을 나타냅니다.
customData	선택사항 객체 상태 메시지 애플리케이션별 맞춤 데이터입니다. 값이 null일 수 있습니다.
includeQueueItems	선택사항 boolean 상태 메시지에 큐 항목을 포함할지 여부입니다. 기본적으로 포함되지 않습니다.

setIdleReason

setIdleReason(idleReason)

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

매개변수
idleReason	cast.framework.messages.IdleReason IDLE 상태에 있는 이유입니다. 값은 null이 아니어야 합니다.

setMediaElement

setMediaElement(mediaElement)

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

매개변수
mediaElement	(null이 아닌 HTMLMediaElement 또는 null이 아닌 HTMLMediaElement를 포함하는 null이 아닌 프로미스) Player에서 사용할 MediaElement입니다.

setMediaInformation

setMediaInformation(mediaInformation, opt_broadcast)

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

매개변수
mediaInformation	cast.framework.messages.MediaInformation 값은 null이 아니어야 합니다.
opt_broadcast	선택사항 boolean

setMediaPlaybackInfoHandler

setMediaPlaybackInfoHandler(handler)

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

매개변수
handler	function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.PlaybackConfig) 요청별 재생 구성을 제공하는 함수입니다. 값이 null일 수 있습니다.

setMediaUrlResolver

setMediaUrlResolver(resolver)

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

매개변수
리졸버	function(non-null cast.framework.messages.LoadRequestData) 미디어 콘텐츠 URL을 확인하는 함수입니다. 값이 null일 수 있습니다.

setMessageInterceptor

setMessageInterceptor(type, interceptor)

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

매개변수
유형	cast.framework.messages.MessageType 값은 null이 아니어야 합니다.
인터셉터	function(non-null cast.framework.messages.RequestData) 값이 null일 수 있습니다.

setPlaybackConfig

setPlaybackConfig(playbackConfig)

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

매개변수
playbackConfig	cast.framework.PlaybackConfig 값은 null이 아니어야 합니다.

setSupportedMediaCommands

setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

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

매개변수
supportedMediaCommands	숫자 애플리케이션에서 지원하는 미디어 명령어의 비트마스크입니다.
broadcastStatus	선택사항 boolean true는 발신자에게 변경사항에 대한 알림을 받아야 함을 나타냅니다. 값을 제공하지 않으면 발신자에게 알림이 전송됩니다.

참고 항목

cast.framework.messages.Command

경유

정지()

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