跳到主要内容
版本:4.x

VideoContext

VideoContext 实例,可通过 Taro.createVideoContext 获取。

VideoContext 通过 id 跟一个 video 组件绑定,操作对应的 video 组件。

支持情况:

参考文档

方法

exitBackgroundPlayback

退出后台音频播放模式。

支持情况:

参考文档

() => void

exitFullScreen

退出全屏

支持情况:

参考文档

() => void

exitPictureInPicture

退出小窗,该方法可在任意页面调用

支持情况:

参考文档

(option: ExitPictureInPictureOption) => void
参数类型
optionExitPictureInPictureOption

hideStatusBar

隐藏状态栏,仅在iOS全屏下有效

支持情况:

参考文档

() => void

pause

暂停视频

支持情况:

参考文档

() => void

play

播放视频

支持情况:

参考文档

() => void

playbackRate

设置倍速播放

支持情况:

参考文档

(rate: number) => void
参数类型说明
ratenumber倍率,支持 0.5/0.8/1.0/1.25/1.5,2.6.3 起支持 2.0 倍速

requestBackgroundPlayback

进入后台音频播放模式。

支持情况:

参考文档

() => void

requestFullScreen

进入全屏

支持情况:

参考文档

(option: RequestFullScreenOption) => void
参数类型
optionRequestFullScreenOption

seek

跳转到指定位置

支持情况:

参考文档

(position: number) => void
参数类型说明
positionnumber跳转到的位置,单位 s

sendDanmu

发送弹幕

支持情况:

参考文档

(data: Danmu) => void
参数类型说明
dataDanmu弹幕内容

showStatusBar

显示状态栏,仅在iOS全屏下有效

支持情况:

参考文档

() => void

stop

停止视频

支持情况:

参考文档

() => void

参数

ExitPictureInPictureOption

参数类型必填说明
success(result: TaroGeneral.CallbackResult) => void接口调用成功的回调函数
fail(res: TaroGeneral.CallbackResult) => void接口调用失败的回调函数
complete(res: TaroGeneral.CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)

RequestFullScreenOption

参数类型必填说明
direction0 or 90 or -90设置全屏时视频的方向,不指定则根据宽高比自动判断。

可选值:
- 0: 正常竖向;
- 90: 屏幕逆时针90度;
- -90: 屏幕顺时针90度;

Danmu

弹幕内容

参数类型必填说明
textstring弹幕文字
colorstring弹幕颜色

API 支持度

API微信小程序H5React NativeHarmonyHarmony hybrid
VideoContext✔️✔️✔️✔️
VideoContext.exitBackgroundPlayback✔️
VideoContext.exitFullScreen✔️✔️✔️✔️
VideoContext.exitPictureInPicture✔️
VideoContext.hideStatusBar✔️
VideoContext.pause✔️✔️✔️✔️
VideoContext.play✔️✔️✔️✔️
VideoContext.playbackRate✔️✔️✔️✔️
VideoContext.requestBackgroundPlayback✔️
VideoContext.requestFullScreen✔️✔️✔️✔️
VideoContext.seek✔️✔️✔️✔️
VideoContext.sendDanmu✔️
VideoContext.showStatusBar✔️
VideoContext.stop✔️✔️✔️✔️