# uni.createVideoContext(videoId, component?)
创建并返回 video 上下文 videoContext 对象
参考：video组件
# createVideoContext 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | √ | 4.11 | 4.61 |
# 参数
| 名称 | 类型 | 必填 |
|---|---|---|
| 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 播放
# play 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
# pause(): void;
pause 暂停
# pause 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
# seek(position: number): void;
seek 跳转到指定位置
# seek 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
# 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| position | number | 是 | 跳转到指定位置(秒) |
# stop(): void;
stop 停止视频
# stop 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
# sendDanmu(danmu: Danmu): void;
sendDanmu 发送弹幕
# sendDanmu 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
# 参数
| 名称 | 类型 | 必填 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| danmu | Danmu | 是 | ||||||||||||||||
| ||||||||||||||||||
# playbackRate(rate: number): void;
playbackRate 设置倍速播放，支持倍率 0.5/0.8/1.0/1.25/1.5。(5.25 起支持有效区间任意值)
HarmonyOS 平台各 API 版本对于倍速支持情况 (异常值时按 1.0 处理)
- API 7 ~ 21： 0.75、1.0、1.25、1.75、2.0
- API 22 ~ 25： 0.125、0.25、0.5、0.75、1.0、1.25、1.5、1.75、2.0、3.0
- API 26.0.0+： [0.125, 8] 任意值
iOS 平台对于倍速支持情况 (异常值时按 1.0 处理, 低于0.125取下限、高于8取上限)
- [0.125, 8] 任意值
Android 平台
- [0.1, 8] 任意值（异常值时按 1.0 处理）
# playbackRate 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
# 参数
| 名称 | 类型 | 必填 |
|---|---|---|
| rate | number | 是 |
# requestFullScreen(direction?: RequestFullScreenOptions): void;
requestFullScreen 进入全屏
# requestFullScreen 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
# 参数
| 名称 | 类型 | 必填 | 描述 | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| direction | RequestFullScreenOptions | 否 | 0|正常竖向, 90|屏幕逆时针90度, -90|屏幕顺时针90度 | |||||||||||||||||||||||
| ||||||||||||||||||||||||||
# exitFullScreen(): void;
exitFullScreen 退出全屏
# exitFullScreen 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 3.9.0 | 4.11 | 4.61 |
# 参见
- 相关 Bug
- 参见uni-app相关文档
- 微信小程序文档
- 支付宝小程序文档
- 百度小程序文档
- 抖音小程序文档
- 飞书小程序文档
- 钉钉小程序文档
- QQ小程序文档
- 快手小程序文档
- 京东小程序文档
- 华为快应用文档
- 360小程序文档
# 通用类型
# GeneralCallbackResult
| 名称 | 类型 | 必备 | 描述 |
|---|---|---|---|
| errMsg | string | 是 | 错误信息 |
示例代码另见video组件
本页导读
