cast.
            メディアの再生を制御、モニタリングします。
- 例外
- 
                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
停止
停止()
再生中のメディアを停止します。