uni.saveVideoToPhotosAlbum(options) @saveVideoToPhotosAlbum

# uni.saveVideoToPhotosAlbum(options)

保存视频到系统相册

# saveVideoToPhotosAlbum 兼容性

Web	Android	iOS
x	4.18	4.18

# 参数

名称

类型

必填

默认值

兼容性

描述

options

SaveVideoToPhotosAlbumOptions

是

名称	类型	必备	默认值	兼容性	描述
filePath	string.VideoURIString	是	-	-	视频文件路径，可以是临时文件路径也可以是永久文件路径
success	(callback: SaveVideoToPhotosAlbumSuccess) => void	否	-	-	接口调用成功的回调函数
fail	(callback: IMediaError) => void	否	-	-	接口调用失败的回调函数
complete	(callback: any) => void	否	-	-	接口调用结束的回调函数（调用成功、失败都会执行）

# IMediaError 的属性值

名称

类型

必备

默认值

兼容性

描述

errCode

number

是

错误码

合法值	兼容性	描述
1101001	-	用户取消
1101002	-	urls至少包含一张图片地址
1101003	-	文件不存在
1101004	-	图片加载失败
1101005	-	未获取权限
1101006	-	图片或视频保存失败
1101007	-	图片裁剪失败
1101008	-	拍照或录像失败
1101009	-	图片压缩失败
1101010	-	其他错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# 参见

# 示例

hello uni-app x

该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验

<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"></video>
      <button type="primary" class="margin-top-10" @click="saveVideo">将视频保存到手机相册</button>
    </view>
  <!-- #ifdef APP -->
  </scroll-view>
  <!-- #endif -->
</template>

<script>
  export default {
    data() {
      return {
        title: 'saveVideoToPhotosAlbum',
        src: '/static/test-video/10second-demo.mp4',
        // 自动化测试
        success: false
      }
    },
    methods: {
      saveVideo() {
        uni.saveVideoToPhotosAlbum({
          filePath: this.src,
          success: (_) => {
            console.log("saveVideoToPhotosAlbum success");
            uni.showToast({
              position: "center",
              icon: "none",
              title: "视频保存成功，请到手机相册查看"
            });
            this.success = true;
          },
          fail: (err) => {
            uni.showModal({
              title: "保存视频到相册失败",
              content: JSON.stringify(err),
              showCancel: false
            });
            this.success = false;
          }
        });
      }
    }
  }
</script>

<style>
  .video {
    align-self: center;
  }

  .margin-top-10 {
    margin-top: 10px;
  }
</style>