VideoPlayer
* VideoPlayer是实现HTMLVideoElement接口的组件，该接口可扩展HTMLMediaElement接口。
此项是一个typescript类，而非React Native组件。应用需要创建一个VideoPlayer实例，并使用它来开始缓冲内容，而无需在屏幕上呈现视频。默认情况下，它不会将视频呈现到屏幕上，也不会呈现媒体控件图形用户界面。应用需要构建自身的媒体控件用户界面并控制播放体验。当应用希望在屏幕上显示视频时，它必须将KeplerVideoSurfaceView React Native组件添加到呈现树中，接收onSurfaceViewCreated事件，并通过setSurfaceHandle API将事件回调中获得的表面句柄传递至VideoPlayer。
扩展
MediaPlayer
实现
构造函数
new VideoPlayer()
new VideoPlayer(): VideoPlayer
返回值
方法
clearSurfaceHandle()
clearSurfaceHandle(surfaceHandle:
string):void
设置渲染视频的表面句柄。param[in] surfaceHandle 由KeplerVideoSurfaceView组件发出的onSurfaceViewCreated事件返回的表面句柄。
参数
surfaceHandle
string
deinitialize()
deinitialize():
Promise<void>
取消播放器初始化。
返回值
Promise<void>
将在播放器取消初始化时解析的Promise。
deinitializeSync()
deinitializeSync(timeoutInMs:
number):NativeInterfaces.MediaPlayerDeInitStatus
同步取消播放器初始化
参数
timeoutInMs
number
客户端设置的超时阈值，用于返回deinit控件。
返回值
NativeInterfaces.MediaPlayerDeInitStatus
MediaPlayerDeInitStatus
getVideoPlaybackQuality()
getVideoPlaybackQuality():
VideoPlaybackQuality
获取视频播放质量属性。
返回值
VideoPlaybackQuality
handleEvent()
handleEvent(event:
NativeInterfaces.NativeMediaElementEvent):void
参数
event
NativeInterfaces.NativeMediaElementEvent
initialize()
initialize():
Promise<void>
初始化播放器。等待Promise履行，然后再调用任何其他函数。
返回值
Promise<void>
将在播放器初始化时解析的Promise。
setMediaControlFocus()
setMediaControlFocus(componentInstance:
IComponentInstance, mediaControlHandler?:any):Promise<void>
使用当前正在使用的媒体播放器设置组件实例，然后传递mediaControlHandler，以防客户端想要选择处理mediacontrol命令。
参数
componentInstance
IComponentInstance
mediaControlHandler?
any
返回值
Promise<void>
setSurfaceHandle()
setSurfaceHandle(surfaceHandle:
string):void
设置渲染视频的表面句柄。param[in] surfaceHandle 由KeplerVideoSurfaceView组件发出的onSurfaceViewCreated事件返回的表面句柄。
参数
surfaceHandle
string
Last updated: 2026年7月31日
