uni 获取本地文件_第17讲 : uni-app 接口 - 从本地相册选择图片或使

最新推荐文章于 2025-10-16 17:22:44 发布

原创最新推荐文章于 2025-10-16 17:22:44 发布 · 530 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#uni 获取本地文件

这篇博客介绍了uni-app中处理图片的接口，包括uni.chooseImage用于从相册选择或拍照获取图片，uni.previewImage用于预览图片，uni.getImageInfo用于获取图片的尺寸和方向信息，以及uni.saveImageToPhotosAlbum用于将图片保存到系统相册。每个接口的参数、使用示例和返回值都进行了详细说明。

uni.chooseImage(OBJECT) 从本地相册选择图片或使用相机拍照。

count Number 否最多可以选择的图片张数，默认9

sizeType StringArray 否 original 原图，compressed 压缩图，默认二者都有

sourceType StringArray 否 album 从相册选图，camera 使用相机，默认二者都有

success Function 是成功则返回图片的本地文件路径列表 tempFilePaths

fail Function 否接口调用失败的回调函数

complete Function 否接口调用结束的回调函数(调用成功、失败都会执行)

注：文件的临时路径，在应用本次启动期间可以正常使用，如需持久保存，需在主动调用 uni.saveFile，在应用下次启动时才能访问得到。

success 返回参数说明

参数类型说明

tempFilePaths StringArray 图片的本地文件路径列表

tempFiles ObjectArray 图片的本地文件列表，每一项是一个 File 对象

File 对象结构如下

path String 本地文件路径

size Number 本地文件大小，单位：B

示例

uni.chooseImage({

sizeType: ['original', 'compressed'], //可以指定是原图还是压缩图，默认二者都有

sourceType: ['album'], //从相册选择

success: function (res) {

console.log(JSON.stringify(res.tempFilePaths));

}

});

uni.previewImage(OBJECT)

预览图片

OBJECT 参数说明

current String 否当前显示图片的链接，不填则默认为 urls 的第一张

urls StringArray 是需要预览的图片链接列表

success Function 否接口调用成功的回调函数

fail Function 否接口调用失败的回调函数

complete Function 否接口调用结束的回调函数(调用成功、失败都会执行)

示例

uni.chooseImage({

sizeType: ['original', 'compressed'],

sourceType: ['album'],

success: function (res) {

// 预览图片

uni.previewImage({

urls: res.tempFilePaths

});

}

});

uni.getImageInfo(OBJECT) 获取图片信息

OBJECT 参数说明

参数名类型必填说明

src String 是图片的路径，可以是相对路径，临时文件路径，存储文件路径，网络图片路径

success Function 否接口调用成功的回调函数

fail Function 否接口调用失败的回调函数

complete Function 否接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明

参数名类型说明最低版本

width Number 图片宽度，单位px *

height Number 图片高度，单位px *

path String 返回图片的本地路径 *

orientation String 返回图片的方向，有效值见下表 *

type String 返回图片的格式 *

orientation 参数说明

枚举值说明

up 默认

down 180度旋转

left 逆时针旋转90度

right 顺时针旋转90度

up-mirrored 同up，但水平翻转

down-mirrored 同down，但水平翻转

left-mirrored 同left，但垂直翻转

right-mirrored 同right，但垂直翻转

示例

uni.chooseImage({

sourceType: ['album'],

success: function (res) {

uni.getImageInfo({

src: res.tempFilePaths[0],

success: function (image) {

console.log(image.width);

console.log(image.height);

}

});

}

});

uni.saveImageToPhotosAlbum(OBJECT)

保存图片到系统相册

参数名类型必填说明

filePath String 是图片文件路径，可以是临时文件路径也可以是永久文件路径，不支持网络图片路径

success Function 否接口调用成功的回调函数

fail Function 否接口调用失败的回调函数

complete Function 否接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明

参数名类型说明

errMsg String 调用结果

示例代码：

uni.chooseImage({

sourceType: ['camera'],

success: function (res) {

uni.saveImageToPhotosAlbum({

filePath: res.tempFilePaths[0],

success: function () {

console.log('save success');

}

});

}

});