小程序开放平台

文档中心
基础
界面
网络
数据缓存
媒体
图片
地图
视频
createVideoContext
VideoContext
chooseVideo
chooseMedia
saveVideoToPhotosAlbum
compressVideo
getVideoInfo
富文本
位置
开放接口
设备
XHSML
性能
文件
数据分析
画布

xhs.getVideoInfo

开发
>
JS API
>
媒体
>
视频
>
getVideoInfo
>
更新时间:2025-04-10 18:01:56

以Promise风格调用: 支持

获取图片信息

参数

Object object

属性
类型
默认值
必填
说明
srcstring视频文件路径,可以是临时文件路径也可以是永久文件路径
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
errMsgstring
orientationstring画面方向
typestring视频格式
durationnumber视频长度
sizenumber视频大小, 单位 kB
heightnumber视频的长,单位 px
widthnumber视频的宽,单位 px
fpsnumber视频帧率
bitratenumber视频码率,单位 kbps
orientation 的合法值
合法值
说明
up默认
down180度旋转
left逆时针旋转90度
right顺时针旋转90度
up-mirrored同up,但水平翻转
down-mirrored同down,但水平翻转
left-mirrored同left,但垂直翻转
right-mirrored同right,但垂直翻转

实例代码

function getVideoInfo(src) {
  return new Promise((resolve, reject) => {
    xhs.getVideoInfo({
      src, // 视频文件路径
      success: (res) => resolve(res),
      fail: (err) => reject(err),
    });
  });
}

// 调用示例
const videoPath = '/path/to/video.mp4'; // 替换为实际的视频文件路径

getVideoInfo(videoPath)
  .then((res) => {
    console.log('视频信息获取成功:');
    console.log('视频格式:', res.type);
    console.log('视频长度:', res.duration, '秒');
    console.log('视频大小:', res.size, 'kB');
    console.log('视频宽度:', res.width, 'px');
    console.log('视频高度:', res.height, 'px');
    console.log('视频帧率:', res.fps);
    console.log('视频码率:', res.bitrate, 'kbps');
    console.log('画面方向:', res.orientation);
  })
  .catch((err) => {
    console.error('视频信息获取失败:', err);
  });