VideoPlayer
概要
VideoPlayerは、HTMLMediaElementインターフェイスを拡張するHTMLVideoElementインターフェイスを実装するコンポーネントです。
注釈
これはTypeScriptクラスであり、React Nativeコンポーネントではありません。アプリでは、VideoPlayerのインスタンスを作成し、それを使用して、画面上にビデオをレンダリングせずにコンテンツのバッファリングを開始する必要があります。デフォルトでは、ビデオは画面上にレンダリングされず、メディアコントロールのGUIも表示されません。アプリには、独自のメディアコントロールUIを構築し、再生エクスペリエンスを制御することが求められます。アプリで画面上にビデオを表示するときは、React NativeのKeplerVideoSurfaceViewコンポーネントをレンダーツリーに追加し、onSurfaceViewCreatedイベントを受け取って、イベントコールバックで取得したサーフェスハンドルをsetSurfaceHandle APIを通じてVideoPlayerに渡す必要があります。
拡張
MediaPlayer
実装
コンストラクタ
new VideoPlayer()
new VideoPlayer():
VideoPlayer
戻り値
概要
ビデオプレーヤーインスタンスを作成するコンストラクタ
オーバーライド
MediaPlayer.constructor
プロパティ
controls?
optionalcontrols:boolean
メディアコントロールのUIを有効または無効にします。詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-controls（英語のみ）を参照してください。
以下の実装
継承元
MediaPlayer.controls
mediaControlHandler
mediaControlHandler:
KeplerMediaControlHandler=null
継承元
MediaPlayer.mediaControlHandler
mediaControlServer
mediaControlServer:
IMediaControlServerAsync
継承元
MediaPlayer.mediaControlServer
mediaControlStateUtil
mediaControlStateUtil:
MediaControlStateUtil=null
継承元
MediaPlayer.mediaControlStateUtil
mediaKeys?
optionalmediaKeys:MediaKeys
概要
DRMで保護されたコンテンツの復号化に使用するメディアキーです。詳細については、https://www.w3.org/TR/encrypted-media/#dom-htmlmediaelement-mediakeys（英語のみ）を参照してください。
以下の実装
継承元
MediaPlayer.mediaKeys
mSessionId
mSessionId:
IMediaSessionId
継承元
MediaPlayer.mSessionId
newlyIntroducedCues
newlyIntroducedCues:
Set<VTTCue>
TODO
テキストトラックマネージャーとテキストトラックレンダラーを作成します。
継承元
MediaPlayer.newlyIntroducedCues
seekIntervalInSec_
seekIntervalInSec_:
number=DEFAULT_SEEK_SECONDS
継承元
MediaPlayer.seekIntervalInSec_
tmoa?
optionaltmoa:TimeMarchesOnAlgo=null
継承元
MediaPlayer.tmoa
HAVE_CURRENT_DATA
readonlystaticHAVE_CURRENT_DATA:number=2
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_current_data（英語のみ）を参照してください。
以下の実装
HTMLVideoElement.HAVE_CURRENT_DATA
継承元
MediaPlayer.HAVE_CURRENT_DATA
HAVE_ENOUGH_DATA
readonlystaticHAVE_ENOUGH_DATA:number=4
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_enough_data（英語のみ）を参照してください。
以下の実装
HTMLVideoElement.HAVE_ENOUGH_DATA
継承元
MediaPlayer.HAVE_ENOUGH_DATA
HAVE_FUTURE_DATA
readonlystaticHAVE_FUTURE_DATA:number=3
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_future_data（英語のみ）を参照してください。
以下の実装
HTMLVideoElement.HAVE_FUTURE_DATA
継承元
MediaPlayer.HAVE_FUTURE_DATA
HAVE_METADATA
readonlystaticHAVE_METADATA:number=1
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_metadata（英語のみ）を参照してください。
以下の実装
HTMLVideoElement.HAVE_METADATA
継承元
MediaPlayer.HAVE_METADATA
HAVE_NOTHING
readonlystaticHAVE_NOTHING:number=0
詳細については、https://html.spec.whatwg.org/multipage/media.html#dom-media-have_nothing（英語のみ）を参照してください。
以下の実装
継承元
MediaPlayer.HAVE_NOTHING
isAppManifestParsed
staticisAppManifestParsed:boolean=false
継承元
MediaPlayer.isAppManifestParsed
isPlayerSessionEnabled
staticisPlayerSessionEnabled:boolean=true
継承元
MediaPlayer.isPlayerSessionEnabled
mediaSessionID_
staticmediaSessionID_:number=0
継承元
MediaPlayer.mediaSessionID_
playerSessionClient
staticplayerSessionClient:PlayerSessionClient=null
継承元
MediaPlayer.playerSessionClient
メソッド
キューを追加 ()
追加キュー (
キュー): 無効
これらはTextTrackManagerによって処理される必要があります
パラメーター
キュー
戻り値
void
継承元
MediaPlayer.addCue
clearCaptionViewHandle()
clearCaptionViewHandle(
captionViewHandle):void
パラメーター
captionViewHandle
string
戻り値
void
概要
プレーヤーのキャプションビューハンドルをクリアします。@param [in] CaptionViewHandle キャプションビューへのハンドル。
継承元
MediaPlayer.clearCaptionViewHandle
clearSurfaceHandle()
clearSurfaceHandle(
surfaceHandle):void
パラメーター
surfaceHandle
string
戻り値
void
概要
ビデオのレンダリング先となるサーフェスハンドルを設定します。@param[in]surfaceHandle：KeplerVideoSurfaceViewコンポーネントによって発行されたonSurfaceViewCreatedイベントから返されたサーフェスハンドル。
deinitialize()
deinitialize():
Promise<void>
戻り値
Promise<void>
プレーヤーの初期化が解除されたときに解決されるPromise。
概要
プレーヤーの初期化を解除します。
オーバーライド
MediaPlayer.deinitialize
deinitializeSync()
deinitializeSync(
timeoutInMs):MediaPlayerDeInitStatus
パラメーター
timeoutInMs
number
初期化解除制御から戻るまでの、クライアントが設定したタイムアウトしきい値。
戻り値
MediaPlayerDeInitStatus
MediaPlayerDeInitStatus
概要
プレーヤーを同期的に初期化解除します
オーバーライド
MediaPlayer.deinitializeSync
getVideoPlaybackQuality()
getVideoPlaybackQuality():
VideoPlaybackQuality
戻り値
概要
ビデオの再生品質属性を取得します。
以下の実装
HTMLVideoElement.getVideoPlaybackQuality
initialize()
initialize():
Promise<void>
戻り値
Promise<void>
プレーヤーが初期化されたときに解決されるPromise。
概要
プレーヤーを初期化します。他の関数を呼び出す前に、Promiseが解決されるまで待機します。
オーバーライド
MediaPlayer.initialize
removeCue()
キューを削除
(キュー): 無効
パラメーター
キュー
戻り値
void
継承元
MediaPlayer.removeCue
runTMOAlgo()
runTMOAlgo():
void
戻り値
void
継承元
MediaPlayer.runTMOAlgo
setCaptionViewHandle()
setCaptionViewHandle(
captionViewHandle):void
パラメーター
captionViewHandle
string
戻り値
void
概要
プレーヤーのキャプションビューハンドルを設定します。@param[in] captionViewHandle：キャプションビューへのハンドル。
継承元
MediaPlayer.setCaptionViewHandle
setMediaControlFocus()
setMediaControlFocus(
componentInstance,mediaControlHandler?):Promise<void>
パラメーター
componentInstance
IComponentInstance
mediaControlHandler?
IMediaControlHandlerAsync
戻り値
Promise<void>
概要
現在使用されているメディアプレーヤーを使用してコンポーネントインスタンスをセットアップし、クライアントがメディアコントロールコマンドの処理を選択する場合に備えてmediaControlHandlerを渡します。
オーバーライド
MediaPlayer.setMediaControlFocus
setSurfaceHandle()
setSurfaceHandle(
surfaceHandle):void
パラメーター
surfaceHandle
string
戻り値
void
概要
ビデオのレンダリング先となるサーフェスハンドルを設定します。@param[in] surfaceHandle：KeplerVideoSurfaceViewコンポーネントによって発行されたonSurfaceViewCreatedイベントから返されたサーフェスハンドル。
triggerTMOAIfNeeded()
triggerTMOAIfNeeded(
cue):void
パラメーター
キュー
戻り値
void
継承元
MediaPlayer.triggerTMOAIfNeeded
Last updated: 2025年10月2日
