cast. framework. PlayerManager
メディアの再生を制御、モニタリングします。
- 例外
-
non-null Error
: コンストラクタが直接使用される場合。PlayerManager
は、cast.framework.CastReceiverContext#getPlayerManager を呼び出してアクセスする必要があります。
Methods
addEventListener
addEventListener(eventType, eventListener)
再生イベントをリッスンするイベント リスナーを追加します。
パラメータ |
|
---|---|
eventType |
(null 以外の cast.framework.events.EventType または null 以外の cast.framework.events.EventType の配列) イベントタイプまたはイベントタイプの配列 |
eventListener |
function(non-null cast.framework.events.Event) |
- 例外
-
non-null Error
: 指定された引数が無効な場合。
addSupportedMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
サポートされているメディア コマンドの既存のリストに、新たにサポートされるコマンドが追加されました。
パラメータ |
|
---|---|
supportedMediaCommands |
数値 アプリケーションでサポートされているメディア コマンドのビットマスク。 |
broadcastStatus |
省略可 boolean
|
- 関連ドキュメント
- cast.framework.messages.Command
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() が number を返す
現在再生中のブレーク クリップの時間を秒単位で返します。
- 戻り値
-
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() が number を返す
現在の再生速度を返します。
レシーバ CastReceiverContext#start
が呼び出される前に 1
を返します。
- 戻り値
-
number
現在の再生速度。
getPlayerState
getPlayerState() が cast.framework.messages.PlayerState を返す
Player
状態を取得します。
- 戻り値
-
non-null cast.framework.messages.PlayerState
現在のPlayer
の状態。
getPreferredPlaybackRate
getPreferredPlaybackRate() が number を返す
優先再生速度を取得します。 シャットダウン イベント時に使用して、最新の優先再生速度を永続ストレージに保存できます。これにより、次のセッションでキャスト オプションで使用できるようになります。
- 戻り値
-
number
getPreferredTextLanguage
getPreferredTextLanguage() が string を返す
使用するテキスト トラックの言語を取得します。
- 戻り値
-
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
オペレーションが成功したときに解決され、失敗した場合は拒否される Promise。
pause
pause()
再生中のメディアを一時停止します。
再生
play()
現在一時停止されているメディアを再生します。
removeEventListener
removeEventListener(eventType, eventListener)
特定の再生イベントに対して追加されたイベント リスナーを削除します。 一致するイベント リスナーが存在しない場合、この呼び出しは無視されます。
パラメータ |
|
---|---|
eventType |
(null 以外の cast.framework.events.EventType または null 以外の cast.framework.events.EventType の配列) eventType またはイベントタイプの配列 |
eventListener |
function(non-null cast.framework.events.Event) |
removeSupportedMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
サポートされているメディア コマンドのリストからコマンドを削除します。
パラメータ |
|
---|---|
supportedMediaCommands |
数値 アプリケーションでサポートされているメディア コマンドのビットマスク。 |
broadcastStatus |
省略可 boolean
|
- 関連ドキュメント
- cast.framework.messages.Command
尽力する
シーク(seekTime)
現在のメディアでシークします。
パラメータ |
|
---|---|
seekTime |
数値 |
sendCustomState
sendCustomState(state)
アプリの再生ロジックから UI ロジックにカスタム状態を送信します。
このメソッドにより、再生ロジックと UI を分離できます。ロジックと UI を分離することで、ローカル再生とリモート コントロールの両方に同じ UI ロジックを使用できます。
このメソッドによって送信されたカスタム 状態は、PlayerData
を通じて UI から利用できます。
パラメータ |
|
---|---|
state |
オブジェクト カスタム状態オブジェクト。 値を null にすることはできません。 |
sendError
sendError(senderId, requestId, type, reason, customData)
特定の送信者にエラーを送信します。
パラメータ |
|
---|---|
senderId |
文字列 送信者 ID。 |
requestId |
数値 このエラーの原因となった受信リクエストの ID。 |
type |
cast.framework.messages.ErrorType エラーのタイプ。 値を null にすることはできません。 |
reason |
省略可 cast.framework.messages.ErrorReason エラーの理由。 値を null にすることもできます。 |
customData |
省略可 オブジェクト エラー メッセージ アプリケーション固有のカスタムデータ。 値を null にすることもできます。 |
sendLocalMediaRequest
sendLocalMediaRequest(request)
ローカル メディア リクエストを送信します。
パラメータ |
|
---|---|
request |
cast.framework.messages.RequestData 値を null にすることはできません。 |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
特定の送信者にメディア ステータス メッセージを送信します。
パラメータ |
|
---|---|
senderId |
文字列 送信者 ID。 |
requestId |
数値 このレスポンスの原因となった受信リクエストの ID。 |
includeMedia |
省略可 boolean
|
customData |
省略可 オブジェクト ステータス メッセージのアプリケーション固有のカスタムデータ。 値を null にすることもできます。 |
includeQueueItems |
省略可 boolean ステータス メッセージにキューアイテムを含めるかどうか。デフォルトでは、これらのデータは含まれません。 |
setIdleReason
setIdleReason(idleReason)
プレーヤーが IDLE
状態になっている理由を設定します。これにより、アプリで IDLE
状態を強制的に表示して、その理由(カスタムエラーなど)を示すことができます。
アイドル状態の理由は、次のステータス メッセージで送信されます。
注: ほとんどのアプリケーションでは、この値を設定する必要はありません。これは、アプリが特別な状況で Player
を IDLE
状態にする必要があり、デフォルトの idedReason が意図した動作を反映していない場合にのみ必要です。
パラメータ |
|
---|---|
idleReason |
cast.framework.messages.IdleReason
値を null にすることはできません。 |
setMediaElement
setMediaElement(mediaElement)
使用する HTMLMediaElement
を設定します。HTMLMediaElement
の Promise
が設定されている場合、Promise
が解決された後にメディアの再生が開始されます。
パラメータ |
|
---|---|
mediaElement |
(null 以外の HTMLMediaElement、または null 以外の HTMLMediaElement を含む非 null Promise)
|
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
インターセプタが呼び出されます。
パラメータ |
|
---|---|
type |
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
|
- 関連ドキュメント
- cast.framework.messages.Command
停止
停止()
再生中のメディアを停止します。