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  | 
                      
                         省略可 ブール値 
  | 
                    
broadcastStatus
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
すべてのセンダーにメディア ステータス メッセージを送信します(ブロードキャスト)。アプリケーションはこれを使用してカスタム状態変更を送信します。
                      パラメータ | 
                  |
|---|---|
| 
                         includeMedia  | 
                      
                         省略可 ブール値 
  | 
                    
| 
                         requestId  | 
                      
                         省略可 数値 このレスポンスの原因となった受信リクエストの ID。  | 
                    
| 
                         customData  | 
                      
                         省略可 オブジェクト ステータス メッセージのアプリケーション固有のカスタムデータ。 値は null でもかまいません。  | 
                    
| 
                         includeQueueItems  | 
                      
                         省略可 ブール値 ステータス メッセージにキューアイテムを含めるかどうか。デフォルトでは含まれません。  | 
                    
getAbsoluteTimeForMediaTime
getAbsoluteTimeForMediaTime(mediaTime) returns number
メディア時間をメディア絶対時間に変換します。絶対時間はライブ配信にのみ適用されます。
                      パラメータ | 
                  |
|---|---|
| 
                         mediaTime  | 
                      
                         数値 メディアの時間。  | 
                    
- 戻り値
 - 
                  
nullable number絶対時間。検出されない場合はnull。 
getAudioTracksManager
getAudioTracksManager() returns cast.framework.AudioTracksManager
AudioTracksManager インスタンスを取得します。
- 戻り値
 - 
                  
non-null cast.framework.AudioTracksManager 
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() returns number
現在再生中のブレーク クリップの現在の時刻を秒単位で返します。
- 戻り値
 - 
                  
nullable number現在のブレーク クリップ内の現在の時刻(秒単位)。Playerがブレーク クリップを再生していない場合はnull。 
getBreakClipDurationSec
getBreakClipDurationSec() returns number
現在再生中のブレーク クリップの再生時間(秒単位)を返します。
- 戻り値
 - 
                  
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() returns number
現在のレシーバーでサポートされているメディア コマンドを取得します。getSupportedMediaCommands() とは異なり、このメソッドの戻り値は現在の再生ステータスに基づいて動的に変化します。たとえば、広告の再生中に SEEK コマンドがサポートされないことがあります。このメソッドは、レシーバー CastReceiverContext#start の呼び出し後にのみ呼び出す必要があります。それ以外の場合は 0 を返します。
- 関連情報
 - cast.framework.messages.Command
 - 戻り値
 - 
                  
numberアプリでサポートされているメディア コマンドのビットマスク。 
getCurrentTimeSec
getCurrentTimeSec() returns number
現在のメディアの再生経過時間を取得します。
- 戻り値
 - 
                  
number経過時間(秒単位)。メディアが再生されていない場合は0になります。 
getDurationSec
getDurationSec() returns number
現在再生中のメディアの再生時間(秒)を取得します。
- 戻り値
 - 
                  
numberメディアの再生時間。再生中のメディアがない場合はNaN。 
getLiveSeekableRange
getLiveSeekableRange() returns cast.framework.messages.LiveSeekableRange
ライブのシーク可能な範囲を、開始時間と終了時間(秒単位)で返します。値はメディア時間に基づいています。
- 戻り値
 
getMediaInformation
getMediaInformation() returns cast.framework.messages.MediaInformation
現在のメディアのメディア情報を取得します。
- 戻り値
 
getMediaTimeForAbsoluteTime
getMediaTimeForAbsoluteTime(absoluteTime) returns number
メディアの絶対時間をメディア時間に変換します。絶対時間はライブ配信にのみ適用されます。
                      パラメータ | 
                  |
|---|---|
| 
                         absoluteTime  | 
                      
                         数値 メディアの絶対時間(UNIX エポック時刻(Unix エポックからの秒数))。  | 
                    
- 戻り値
 - 
                  
nullable numberメディア時間。利用できない場合はnull。 
getPlaybackConfig
getPlaybackConfig() は cast.framework.PlaybackConfig を返します
再生構成を返します。デフォルトがオーバーライドされていない場合は null を返します。
- 戻り値
 - 
                  
nullable cast.framework.PlaybackConfig 
getPlaybackRate
getPlaybackRate() returns number
現在の再生レートを返します。レシーバ CastReceiverContext#start が呼び出される前に 1 を返します。
- 戻り値
 - 
                  
number現在の再生レート。 
getPlayerState
getPlayerState() returns cast.framework.messages.PlayerState
Player 状態を取得します。
- 戻り値
 - 
                  
non-null cast.framework.messages.PlayerState現在のPlayerの状態。 
getPreferredPlaybackRate
getPreferredPlaybackRate() returns number
優先再生レートを取得します。シャットダウン イベントで使用して、最新の優先再生レートを永続ストレージに保存できます。これにより、キャスト オプションの次のセッションで使用できます。
- 戻り値
 - 
                  
number 
getPreferredTextLanguage
getPreferredTextLanguage() returns 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() returns number
広告ブレーク時間を差し引かずに、現在のメディアの経過再生時間を取得します。
- 戻り値
 - 
                  
number経過時間(秒単位)。メディアが再生されていない場合は0になります。 
getRawSeekableRange
getRawSeekableRange() returns cast.framework.messages.Range
現在のメディアのシーク可能な範囲を返します。
注: これは getRawCurrentTimeSec() の単位と一致しますが、seek() とは一致しません。広告やその他のメディア オフセットは考慮されません。未加工の値が必要であることが確実な場合を除き、代わりに getLiveSeekableRange() を使用する必要があります。
- 戻り値
 - 
                  
nullable cast.framework.messages.Range 
getStartAbsoluteTime
getStartAbsoluteTime() returns number
メディアの絶対開始時刻を UNIX エポック時刻(UNIX エポックからの秒数)として取得します。絶対時間はライブ配信にのみ適用されます。
- 戻り値
 - 
                  
nullable number 
getStats
getStats() returns cast.framework.stats.Stats
再生統計情報を返します。統計情報は、必要に応じて再生セッション全体で集計されます。
- 戻り値
 - 
                  
non-null cast.framework.stats.Stats 
getSupportedMediaCommands
getSupportedMediaCommands() returns number
レシーバーでサポートされているメディア コマンドを取得します。CastReceiverContext#start() の呼び出し後にのみ呼び出す必要があります。それ以外の場合は 0 を返します。サポートされているメディア コマンドの値は、レシーバー アプリケーションによってのみ制御されます。MediaStatus に基づいて自動的に更新されることはありません。
- 関連情報
 - cast.framework.messages.Command
 - 戻り値
 - 
                  
numberアプリでサポートされているメディア コマンドのビットマスク。 
getTextTracksManager
getTextTracksManager() は cast.framework.TextTracksManager を返します
TextTracksManager インスタンスを取得します。
- 戻り値
 - 
                  
non-null cast.framework.TextTracksManager 
getTimedMetadata
getTimedMetadata() returns Array of non-null cast.framework.TimedMetadata
マニフェストの解析中に検出されたタイムド メタデータを返します。これは、HLS では #EXT-X-DATERANGE、DASH では EventStream です。
- 戻り値
 - 
                  
non-null Array of non-null cast.framework.TimedMetadata 
load
load(loadRequest) returns Promise containing void
メディアを読み込むリクエストを開始します。
                      パラメータ | 
                  |
|---|---|
| 
                         loadRequest  | 
                      
                         cast.framework.messages.LoadRequestData メディアを読み込むリクエスト。 値を null にすることはできません。  | 
                    
- 戻り値
 - 
                  
non-null Promise containing voidオペレーションが成功したときに解決され、失敗したときに拒否される Promise。 
一時停止
pause()
現在再生中のメディアを一時停止します。
再生
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  | 
                      
                         省略可 ブール値 
  | 
                    
seek
seek(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)
ローカル メディア リクエストを送信します。
                      パラメータ | 
                  |
|---|---|
| 
                         リクエスト  | 
                      
                         cast.framework.messages.RequestData 値を null にすることはできません。  | 
                    
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
特定の送信者にメディア ステータス メッセージを送信します。
                      パラメータ | 
                  |
|---|---|
| 
                         senderId  | 
                      
                         文字列 送信者 ID。  | 
                    
| 
                         requestId  | 
                      
                         数値 このレスポンスの原因となった受信リクエストの ID。  | 
                    
| 
                         includeMedia  | 
                      
                         省略可 ブール値 
  | 
                    
| 
                         customData  | 
                      
                         省略可 オブジェクト ステータス メッセージのアプリケーション固有のカスタムデータ。 値は null でもかまいません。  | 
                    
| 
                         includeQueueItems  | 
                      
                         省略可 ブール値 ステータス メッセージにキューアイテムを含めるかどうか。デフォルトでは含まれません。  | 
                    
setIdleReason
setIdleReason(idleReason)
プレーヤーが IDLE 状態になっている理由を設定します。これにより、IDLE 状態を強制的に適用するアプリケーションは、その理由(カスタム エラーなど)を示すことができます。アイドル状態の理由は、次のステータス メッセージで送信されます。注 ほとんどのアプリケーションでは、この値を設定する必要はありません。これは、アプリが特別な状況で Player を IDLE 状態にする必要があり、デフォルトの idleReason が意図した動作を反映していない場合にのみ必要です。
                      パラメータ | 
                  |
|---|---|
| 
                         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  | 
                      
                         省略可 ブール値  | 
                    
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  | 
                      
                         省略可 ブール値 
  | 
                    
停止
stop()
現在再生中のメディアを停止します。