uni-app
uni-app x
uniCloud
HBuilder
uni 小程序 sdk
uni-app x
uni-app
uni-app x
uniCloud
HBuilder
uni 小程序 sdk
简体中文
API
chooseVideo 兼容性
参数
ChooseVideoSuccess 的属性值
IMediaError 的属性值
参见
示例
通用类型
GeneralCallbackResult
Tips

# uni.chooseVideo(options) GitCode GitHub

拍摄视频或从手机相册中选视频，返回视频的临时文件路径。

# chooseVideo 兼容性

Web 微信小程序 Android iOS HarmonyOS
4.0 4.41 4.18 4.18 4.61

# 参数

名称 类型 必填 默认值 兼容性 描述
options ChooseVideoOptions 是 -
-
名称 类型 必备 默认值 兼容性 描述
pageOrientation string 否 -
屏幕方向。默认为page.json中的pageOrientation。
合法值 兼容性 描述
auto
-
自动
portrait
-
竖屏显示
landscape
-
横屏显示
sourceType Array<string> 否 -
album 从相册选视频，camera 使用相机拍摄，默认为：['album', 'camera']
maxDuration number 否 -
拍摄视频最长拍摄时间，单位秒。最长支持 60 秒
camera string 否 -
摄像切换
合法值 兼容性 描述
front
-
前置摄像头
back
-
后置摄像头
extension Array<string> 否 -
根据文件拓展名过滤，每一项都不能是空字符串。默认不过滤。
success (callback: ChooseVideoSuccess) => void 否 -
接口调用成功，返回视频文件的临时文件路径，详见返回参数说明
fail (callback: IMediaError) => void 否 -
接口调用失败的回调函数
complete (callback: any) => void 否 -
接口调用结束的回调函数（调用成功、失败都会执行）
compressed boolean 否 true
是否压缩所选的视频源文件，默认值为true，需要压缩 已废弃，仅为了向下兼容保留
albumMode string 否 "custom"
视频选择模式 已废弃，仅为了向下兼容保留
合法值 兼容性 描述
custom
-
自定义媒体选择器
system
-
系统媒体选择器

# ChooseVideoSuccess 的属性值

名称 类型 必备 默认值 兼容性 描述
tempFilePath string 是 -
选定视频的临时文件路径
duration number 是 -
选定视频的时间长度
size number 是 -
选定视频的数据量大小
height number 是 -
返回选定视频的长
width number 是 -
返回选定视频的宽

# IMediaError 的属性值

名称 类型 必备 默认值 兼容性 描述
errCode number 是 -
-
错误码
合法值 兼容性 描述
1101001
-
用户取消
1101002
-
urls至少包含一张图片地址
1101003
-
文件不存在
1101004
-
图片加载失败
1101005
-
未获取权限
1101006
-
图片或视频保存失败
1101007
-
图片裁剪失败
1101008
-
拍照或录像失败
1101009
-
图片压缩失败
1101010
-
其他错误
errSubject string 是 -
-
统一错误主题（模块）名称
data any 否 -
-
错误信息中包含的数据
cause Error 否 -
-
源错误信息，可以包含多个错误，详见SourceError
errMsg string 是 -
-

# 参见

# 示例

示例为 alpha 分支：hello uni-app x（alpha）

master 分支：hello uni-app x（master）

扫码体验（手机浏览器跳转到App直达页）

Template

Script

<template>
  <!-- #ifdef APP -->
  <scroll-view style="flex:1">
  <!-- #endif -->
    <page-head :title="title"></page-head>
    <view class="uni-padding-wrap">
      <video class="video" :src="src" :controls="true" :poster="videoCoverImage"></video>
      <view class="uni-title">
        <text class="uni-subtitle-text">视频信息</text>
      </view>
      <text>{{videoInfo}}</text>
      <view class="uni-btn-v">
        <button type="primary" @click="chooseVideo">选取视频</button>
      </view>
      <enum-data title="视频来源" :items="sourceTypeItemTypes" @change="onSourceTypeChange"></enum-data>
      <!-- #ifdef APP -->
      <enum-data title="屏幕方向" :items="orientationTypeItemTypes" @change="onOrientationTypeChange"></enum-data>
      <!-- #endif -->
      <enum-data title="摄像头" :items="cameraItemTypes" @change="onCameraChange"></enum-data>
      <!-- #ifdef APP-ANDROID -->
      <enum-data title="相册模式" :items="albumModeTypes" @change="onAlbumModeChange"></enum-data>
      <!-- #endif -->
    </view>
    <input-data title="最长拍摄时间，单位秒" defaultValue="60" type="number" @confirm="onMaxDurationConfirm"></input-data>
    <!-- #ifdef APP -->
    <view class="uni-padding-wrap">
      <boolean-data title="是否压缩（HamonyOS 不支持，推荐使用 uni.compressVideo 进行压缩）" :defaultValue="true" @change="onCompressedChange"></boolean-data>
    </view>
    <!-- #endif -->
  <!-- #ifdef APP -->
  </scroll-view>
  <!-- #endif -->
</template>



<style>
  .video {
    align-self: center;
    width: 300px;
    height: 225px;
  }
</style>

# 通用类型

# GeneralCallbackResult

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

# Tips

  • 视频选择的相册，在入参option中，推荐设置albumMode为system，即选择系统相册来选择视频。这样可以避免权限问题，并且google play上架也有要求。google play 照片和视频权限政策。后续会废弃custom方式。
  • 当设置albumMode为system时，可以正常上架google play。同时需要注意在manifest.json中将<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />和<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />权限移除。配置方式参考移除Android权限.
  • 系统相册选择界面的主题和国际化，跟随手机rom，而不是跟随app。
  • 不推荐使用本API的压缩参数，大视频选择时，会卡在视频选择页面很久。应该在选择完毕视频后，自行择机（比如上传视频时）调用uni.compressVideo来压缩视频。
  • 本API会自动申请摄像头，如需手动获取app是否拥有摄像头，参考 uni.getAppAuthorizeSetting。（如使用system方式的相册选择，则不需要权限）
  • app端拍摄会在应用沙盒目录的cache目录产生临时文件，位置详见。如需主动删除临时文件，使用uni.getFileSystemManager。
  • android端由于系统或ROM的限制，拍照的maxDuration和camera属性在部分手机上不生效。
  • 从HBuilderX4.41版起，uni.chooseVideo在sourceType为['album']、albumMode为system、compressed为true时，支持返回Uri地址。
  • 系统视频选择器的sizeType仅支持设置['original']或['compressed']。在Android 11及以上的系统中，设置system调用的是系统的视频选择器，低于android 11的系统中会调用系统的文件选择器。
本页导读
chooseVideo 兼容性
参数
ChooseVideoSuccess 的属性值
IMediaError 的属性值
参见
示例
通用类型
GeneralCallbackResult
Tips