跳到主要内容
版本: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 hybridASCF元服务
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✔️✔️✔️✔️✔️