# uni.createVideoContext(videoId, component?)

创建并返回 video 上下文 videoContext 对象

参考:video组件

# createVideoContext 兼容性

Web 微信小程序 Android iOS
4.0 4.41 4.11

# 参数

名称 类型 必填 默认值 兼容性 描述
videoId string.VideoIdString - - -
component ComponentPublicInstance - -

在video组件上设置id属性,即可通过本API获取该组件的上下文对象(videoContext )。

在不传入第2个component参数时,默认从页面栈顶的页面来查找这个video。

let v1 = uni.createVideoContext("video1")

但在页面、组件,可能出现id重复的情况,还可能因为调用时机的不同,想定位不同页面的video id。此时就需要传入第2个参数component。

所有vue组件都有ComponentPublicInstance实例,页面上也有组件实例。

如果传入组件实例,就从这个组件中查询指定的id。这样查找范围更小、查找速度也更快。

在选项式和组合式中,获取组件实例略有差别。

  • 选项式中,this代表当前vue实例。如果是在页面的export default内、函数外使用this,即代表该页面的组件实例。
let v1 = uni.createVideoContext("video1", this)
  • 组合式中,通过getCurrentInstance()!.proxy! 获取当前页面的组件实例。
let v1 = uni.createVideoContext("video1", getCurrentInstance()!.proxy!)

# 返回值

类型 描述 必备
VideoContext video组件上下文对象

# VideoContext 的方法

# play(): void;

播放

# play 兼容性
Web 微信小程序 Android iOS
4.0 4.41 3.9.0 4.11

# pause(): void;

暂停

# pause 兼容性
Web 微信小程序 Android iOS
4.0 4.41 3.9.0 4.11

# seek(position: number): void;

跳转到指定位置

# seek 兼容性
Web 微信小程序 Android iOS
4.0 4.41 3.9.0 4.11
# 参数
名称 类型 必填 默认值 兼容性 描述
position number - - 跳转到指定位置(秒)

# stop(): void;

停止视频

# stop 兼容性
Web 微信小程序 Android iOS
4.0 4.41 3.9.0 4.11

# sendDanmu(danmu: Danmu): void;

发送弹幕

# sendDanmu 兼容性
Web 微信小程序 Android iOS
4.0 4.41 3.9.0 4.11
# 参数
名称 类型 必填 默认值 兼容性 描述
danmu Danmu - - text, color
名称 类型 必备 默认值 兼容性 描述
text string - - 弹幕文字
color string - - 弹幕颜色
time number - - 显示时刻

# playbackRate(rate: number): void;

设置倍速播放

# playbackRate 兼容性
Web 微信小程序 Android iOS
4.0 4.41 3.9.0 4.11
# 参数
名称 类型 必填 默认值 兼容性 描述
rate number - - , 支持倍率 0.5/0.8/1.0/1.25/1.5

# requestFullScreen(direction?: RequestFullScreenOptions | null): void;

进入全屏

# requestFullScreen 兼容性
Web 微信小程序 Android iOS
4.0 4.41 3.9.0 4.11
# 参数
名称 类型 必填 默认值 兼容性 描述
direction RequestFullScreenOptions - - , 0|正常竖向, 90|屏幕逆时针90度, -90|屏幕顺时针90度
名称 类型 必备 默认值 兼容性 描述
direction number -
direction
- 0: 正常竖向
- 90: 屏幕逆时针90度
- -90: 屏幕顺时针90度

# exitFullScreen(): void;

退出全屏

# exitFullScreen 兼容性
Web 微信小程序 Android iOS
4.0 4.41 3.9.0 4.11

# 参见

# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 兼容性 描述
errMsg string -
错误信息

示例代码另见video组件