小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
图片
地图
视频
createVideoContext
VideoContext
chooseVideo
chooseMedia
saveVideoToPhotosAlbum
compressVideo
getVideoInfo
富文本
位置
开放接口
设备
XHSML
性能
第三方平台
文件
数据分析
画布

xhs.VideoContext

开发
>
JS API
>
媒体
>
视频
>
VideoContext
>
更新时间:2025-04-10 16:20:10

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

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

VideoContext.play()

播放视频

VideoContext.pause()

暂停视频

VideoContext.stop()

停止视频

VideoContext.seek(number position)

跳转到指定位置

参数

number position 跳转到的位置,单位 s

实例代码

播放视频

// 创建 VideoContext 实例
const videoContext = xhs.createVideoContext('myVideo'); // 'myVideo' 是 video 组件的 id

// 播放视频
videoContext.play({
  success: () => {
    console.log('视频播放成功');
  },
  fail: (err) => {
    console.error('视频播放失败:', err.errMsg);
  }
});

暂停视频

// 暂停视频
videoContext.pause({
  success: () => {
    console.log('视频暂停成功');
  },
  fail: (err) => {
    console.error('视频暂停失败:', err.errMsg);
  }
});

停止视频

// 停止视频
videoContext.stop({
  success: () => {
    console.log('视频停止成功');
  },
  fail: (err) => {
    console.error('视频停止失败:', err.errMsg);
  }
});

跳转到指定位置

// 跳转到指定时间(单位:秒)
videoContext.seek({
  position: 15, // 跳转到 15 秒
  success: () => {
    console.log('跳转成功');
  },
  fail: (err) => {
    console.error('跳转失败:', err.errMsg);
  }
});