VideoPlayer
简述
VideoPlayer是实现HTMLVideoElement接口的组件,该接口可扩展HTMLMediaElement接口。
备注
此项是一个typescript类,而非React Native组件。应用需要创建一个VideoPlayer实例,并使用它来开始缓冲内容,而无需在屏幕上呈现视频。默认情况下,它不会将视频呈现到屏幕上,也不会呈现媒体控件图形用户界面。应用需要构建自身的媒体控件用户界面并控制播放体验。当应用希望在屏幕上显示视频时,它必须将KeplerVideoSurfaceView React Native组件添加到呈现树中,接收onSurfaceViewCreated事件,并通过setSurfaceHandle API将事件回调中获得的表面句柄传递至VideoPlayer。
扩展
MediaPlayer
实现
构造函数
new VideoPlayer()
new VideoPlayer():
VideoPlayer
返回值
简述
用于创建视频播放器实例的构造函数
覆盖
MediaPlayer.constructor
属性
controls?
optionalcontrols:boolean
启用或禁用媒体控件的用户界面。有关更多信息,请参阅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>
待办事项
创建TextTrackManager和TextTrackRenderer。
继承自
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
方法
addCue()
addCue(
cue):void
TextTrackManager应该处理好这些
参数
cue
返回值
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
客户端设置的超时阈值,用于返回deinit控件。
返回值
MediaPlayerDeInitStatus
MediaPlayerDeInitStatus
简述
同步取消播放器初始化
覆盖
MediaPlayer.deinitializeSync
getVideoPlaybackQuality()
getVideoPlaybackQuality():
VideoPlaybackQuality
返回值
简述
获取视频播放质量属性。
实现
HTMLVideoElement.getVideoPlaybackQuality
initialize()
initialize():
Promise<void>
返回值
Promise<void>
将在播放器初始化时解析的Promise。
简述
初始化播放器。等待Promise履行,然后再调用任何其他函数。
覆盖
MediaPlayer.initialize
removeCue()
removeCue(
cue):void
参数
cue
返回值
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,以防客户端想要选择处理mediacontrol命令。
覆盖
MediaPlayer.setMediaControlFocus
setSurfaceHandle()
setSurfaceHandle(
surfaceHandle):void
参数
surfaceHandle
string
返回值
void
简述
设置渲染视频的表面句柄。@param[in] surfaceHandle由KeplerVideoSurfaceView组件发出的onSurfaceViewCreated事件返回的表面句柄。
triggerTMOAIfNeeded()
triggerTMOAIfNeeded(
cue):void
参数
cue
返回值
void
继承自
MediaPlayer.triggerTMOAIfNeeded
Last updated: 2025年10月2日

