as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持

VideoPlayer

VideoPlayer

简述

VideoPlayer是实现HTMLVideoElement接口的组件,该接口可扩展HTMLMediaElement接口。

备注

此项是一个typescript类,而非React Native组件。应用需要创建一个VideoPlayer实例,并使用它来开始缓冲内容,而无需在屏幕上呈现视频。默认情况下,它不会将视频呈现到屏幕上,也不会呈现媒体控件图形用户界面。应用需要构建自身的媒体控件用户界面并控制播放体验。当应用希望在屏幕上显示视频时,它必须将KeplerVideoSurfaceView React Native组件添加到呈现树中,接收onSurfaceViewCreated事件,并通过setSurfaceHandle API将事件回调中获得的表面句柄传递至VideoPlayer

扩展

  • MediaPlayer

实现

构造函数

new VideoPlayer()

new VideoPlayer(): VideoPlayer

返回值

VideoPlayer

简述

用于创建视频播放器实例的构造函数

覆盖

MediaPlayer.constructor

属性

controls?

optional controls: boolean

启用或禁用媒体控件的用户界面。有关更多信息,请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-controls。

实现

HTMLVideoElement.controls

继承自

MediaPlayer.controls


mediaControlHandler

mediaControlHandler: KeplerMediaControlHandler = null

继承自

MediaPlayer.mediaControlHandler


mediaControlServer

mediaControlServer: IMediaControlServerAsync

继承自

MediaPlayer.mediaControlServer


mediaControlStateUtil

mediaControlStateUtil: MediaControlStateUtil = null

继承自

MediaPlayer.mediaControlStateUtil


mediaKeys?

optional mediaKeys: MediaKeys

简述

用于解密受DRM保护的内容的媒体密钥。有关更多信息,请参阅https://www.w3.org/TR/encrypted-media/#dom-htmlmediaelement-mediakeys。

实现

HTMLVideoElement.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?

optional tmoa: TimeMarchesOnAlgo = null

继承自

MediaPlayer.tmoa


HAVE_CURRENT_DATA

readonly static HAVE_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

readonly static HAVE_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

readonly static HAVE_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

readonly static HAVE_METADATA: number = 1

有关更多信息,请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_metadata。

实现

HTMLVideoElement.HAVE_METADATA

继承自

MediaPlayer.HAVE_METADATA


HAVE_NOTHING

readonly static HAVE_NOTHING: number = 0

有关更多信息,请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_nothing。

实现

HTMLVideoElement.HAVE_NOTHING

继承自

MediaPlayer.HAVE_NOTHING


isAppManifestParsed

static isAppManifestParsed: boolean = false

继承自

MediaPlayer.isAppManifestParsed


isPlayerSessionEnabled

static isPlayerSessionEnabled: boolean = true

继承自

MediaPlayer.isPlayerSessionEnabled


mediaSessionID_

static mediaSessionID_: number = 0

继承自

MediaPlayer.mediaSessionID_


playerSessionClient

static playerSessionClient: PlayerSessionClient = null

继承自

MediaPlayer.playerSessionClient

方法

addCue()

addCue(cue): void

TextTrackManager应该处理好这些

参数

cue

TextTrackCue

返回值

void

继承自

MediaPlayer.addCue


clearCaptionViewHandle()

clearCaptionViewHandle(captionViewHandle): void

参数

captionViewHandle

string

返回值

void

简述

清除播放器的字幕视图句柄。@param[in] captionViewHandle字幕视图的句柄。

继承自

MediaPlayer.clearCaptionViewHandle


clearSurfaceHandle()

clearSurfaceHandle(surfaceHandle): void

参数

surfaceHandle

string

返回值

void

简述

设置渲染视频的表面句柄。@param[in] surfaceHandleKeplerVideoSurfaceView组件发出的onSurfaceViewCreated事件返回的表面句柄。


deinitialize()

deinitialize(): Promise<void>

返回值

Promise<void>

将在播放器取消初始化时解析的Promise。

简述

取消播放器初始化。

覆盖

MediaPlayer.deinitialize


deinitializeSync()

deinitializeSync(timeoutInMs): MediaPlayerDeInitStatus

参数

timeoutInMs

number

客户端设置的超时阈值,用于返回deinit控件。

返回值

MediaPlayerDeInitStatus

MediaPlayerDeInitStatus

简述

同步取消播放器初始化

覆盖

MediaPlayer.deinitializeSync


getVideoPlaybackQuality()

getVideoPlaybackQuality(): VideoPlaybackQuality

返回值

VideoPlaybackQuality

简述

获取视频播放质量属性。

实现

HTMLVideoElement.getVideoPlaybackQuality


initialize()

initialize(): Promise<void>

返回值

Promise<void>

将在播放器初始化时解析的Promise。

简述

初始化播放器。等待Promise履行,然后再调用任何其他函数。

覆盖

MediaPlayer.initialize


removeCue()

removeCue(cue): void

参数

cue

TextTrackCue

返回值

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] surfaceHandleKeplerVideoSurfaceView组件发出的onSurfaceViewCreated事件返回的表面句柄。


triggerTMOAIfNeeded()

triggerTMOAIfNeeded(cue): void

参数

cue

TextTrackCue

返回值

void

继承自

MediaPlayer.triggerTMOAIfNeeded


Last updated: 2025年10月2日