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
|
broadcastStatus
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
모든 발신자에게 미디어 상태 메시지를 전송합니다 (브로드캐스트). 애플리케이션은 이를 사용하여 맞춤 상태 변경을 전송합니다.
매개변수 |
|
|---|---|
|
includeMedia |
선택사항 boolean
|
|
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를 반환합니다.
시작 시간 및 종료 시간(초)과 함께 실시간 탐색 가능 범위를 반환합니다. 값은 미디어 시간을 기준으로 합니다.
- 반환 값
getMediaInformation
getMediaInformation()이 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을 반환합니다.
선호하는 텍스트 트랙 스타일을 가져옵니다.
- 반환 값
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
|
노력
탐색(seekTime)
현재 미디어에서 탐색합니다.
매개변수 |
|
|---|---|
|
seekTime |
숫자 |
sendCustomState
sendCustomState(state)
애플리케이션 재생 로직에서 UI 로직으로 맞춤 상태를 전송합니다.
이 메서드는 재생 로직과 UI를 분리하는 데 도움이 됩니다.
로직과 UI를 분리하면 로컬 재생 및 원격 제어에 모두 동일한 UI 로직을 사용할 수 있습니다.
이 메서드에서 전송한 맞춤 상태는 PlayerData를 통해 UI에서 사용할 수 있습니다.
매개변수 |
|
|---|---|
|
state |
객체 맞춤 상태 객체입니다. 값은 null이 아니어야 합니다. |
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
|
|
customData |
선택사항 객체 상태 메시지 애플리케이션별 맞춤 데이터입니다. 값이 null일 수 있습니다. |
|
includeQueueItems |
선택사항 boolean 상태 메시지에 큐 항목을 포함할지 여부입니다. 기본적으로 포함되지 않습니다. |
setIdleReason
setIdleReason(idleReason)
플레이어가 IDLE 상태에 있는 이유를 설정합니다.
이렇게 하면 애플리케이션에서 IDLE 상태를 강제 표시해야 하는 이유 (예: 맞춤 오류)를 표시할 수 있습니다.
유휴 이유는 다음 상태 메시지에서 전송됩니다.
참고 대부분의 애플리케이션에서는 이 값을 설정할 필요가 없습니다. 앱이 특별한 상황에서 Player를 IDLE 상태로 전환해야 하고 기본 유휴 사유가 의도된 동작을 반영하지 않는 경우에만 필요합니다.
매개변수 |
|
|---|---|
|
idleReason |
cast.framework.messages.IdleReason
값은 null이 아니어야 합니다. |
setMediaElement
setMediaElement(mediaElement)
사용할 HTMLMediaElement를 설정합니다. HTMLMediaElement의 Promise가 설정되면 Promise가 결정된 후 미디어가 재생을 시작합니다.
매개변수 |
|
|---|---|
|
mediaElement |
(null이 아닌 HTMLMediaElement 또는 null이 아닌 HTMLMediaElement를 포함하는 null이 아닌 프로미스)
|
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 |
값은 null이 아니어야 합니다. |
setSupportedMediaCommands
setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
수신기에서 지원하는 미디어 명령어를 설정합니다.
매개변수 |
|
|---|---|
|
supportedMediaCommands |
숫자 애플리케이션에서 지원하는 미디어 명령어의 비트마스크입니다. |
|
broadcastStatus |
선택사항 boolean
|
경유
정지()
현재 재생 중인 미디어를 중지합니다.