title: VideoContext

sidebar_label: VideoContext

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

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

支持情况:VideoContext - 图1 VideoContext - 图2 VideoContext - 图3

参考文档

方法

exitBackgroundPlayback

退出后台音频播放模式。

支持情况:VideoContext - 图4 VideoContext - 图5 VideoContext - 图6

参考文档

  1. () => void

exitFullScreen

退出全屏

支持情况:VideoContext - 图7 VideoContext - 图8 VideoContext - 图9

参考文档

  1. () => void

exitPictureInPicture

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

支持情况:VideoContext - 图10 VideoContext - 图11 VideoContext - 图12

参考文档

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

hideStatusBar

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

支持情况:VideoContext - 图13 VideoContext - 图14 VideoContext - 图15

参考文档

  1. () => void

pause

暂停视频

支持情况:VideoContext - 图16 VideoContext - 图17 VideoContext - 图18

参考文档

  1. () => void

play

播放视频

支持情况:VideoContext - 图19 VideoContext - 图20 VideoContext - 图21

参考文档

  1. () => void

playbackRate

设置倍速播放

支持情况:VideoContext - 图22 VideoContext - 图23 VideoContext - 图24

参考文档

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

requestBackgroundPlayback

进入后台音频播放模式。

支持情况:VideoContext - 图25 VideoContext - 图26 VideoContext - 图27

参考文档

  1. () => void

requestFullScreen

进入全屏

支持情况:VideoContext - 图28 VideoContext - 图29 VideoContext - 图30

参考文档

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

seek

跳转到指定位置

支持情况:VideoContext - 图31 VideoContext - 图32 VideoContext - 图33

参考文档

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

sendDanmu

发送弹幕

支持情况:VideoContext - 图34 VideoContext - 图35 VideoContext - 图36

参考文档

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

showStatusBar

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

支持情况:VideoContext - 图37 VideoContext - 图38 VideoContext - 图39

参考文档

  1. () => void

stop

停止视频

支持情况:VideoContext - 图40 VideoContext - 图41 VideoContext - 图42

参考文档

  1. () => void

参数

ExitPictureInPictureOption

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

RequestFullScreenOption

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

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

Danmu

弹幕内容

参数 类型 必填 说明
text string 弹幕文字
color string 弹幕颜色

API 支持度

API 微信小程序 H5 React Native
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 ✔️ ✔️ ✔️