tencent cloud

腾讯云超级应用服务

图片

下载
聚焦模式
字号
最后更新时间: 2025-04-10 18:18:35

chooseImage

该 API 使用方法为 wx.chooseImage(Object object)
功能说明:从本地相册选择图片或使用相机拍照。
参数及说明:Object object。
属性
类型
合法值及说明
默认值
必填
说明
count
number
-
9
否
最多可以选择的图片张数
sizeType
Array.<string>
original:原图
compressed:压缩图
['original', 'compressed']
否
所选的图片的尺寸
sourceType
Array.<string>
album:从相册选图
camera:使用相机
['album', 'camera']
否
选择图片的来源
success
function
-
-
否
接口调用成功的回调函数
fail
function
-
-
否
接口调用失败的回调函数
complete
function
-
-
否
接口调用结束的回调函数(调用成功、失败都会执行)
object.success 回调函数参数:Object res。
属性
类型
说明
tempFilePaths
Array.<string>
图片的本地临时文件路径列表 (本地路径)
tempFiles
Array.<Object>
图片的本地临时文件列表
res.tempFiles 的结构
属性
类型
说明
path
string
本地临时文件路径
size
number
本地临时文件大小,单位 B
示例代码:
wx.chooseImage({
count: 1,
sizeType: ['original', 'compressed'],
sourceType: ['album', 'camera'],
success (res) {
// tempFilePath可以作为 img 标签的 src 属性显示图片
const tempFilePaths = res.tempFilePaths
}
})

compressImage

该 API 使用方法为 wx.compressImage(Object object)
说明:
该API 小程序支持,小游戏暂不支持。
功能说明:压缩图片接口,可选压缩质量。
参数及说明:Object object。
属性
类型
默认值
必填
说明
src
string
-
是
图片的路径,支持本地路径、代码包路径
quality
number
80
否
压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对 jpg 有效)
compressedWidth
number
-
否
压缩后图片的宽度,单位为px,若不填写则默认以 compressedHeight 为准等比缩放
compressedHeight
number
-
否
压缩后图片的高度,单位为px,若不填写则默认以compressedWidth为准等比缩放
success
function
-
否
接口调用成功的回调函数
fail
function
-
否
接口调用失败的回调函数
complete
function
-
否
接口调用结束的回调函数(调用成功、失败都会执行)
object.success 回调函数参数:Object res。
属性
类型
说明
tempFilePath
string
压缩后图片的临时文件路径 (本地路径)
示例代码:
wx.compressImage({
src: '', // 图片路径
quality: 80 // 压缩质量
})

getImageInfo

该 API 使用方法为 wx.getImageInfo(Object object)
说明:
该API 小程序支持,小游戏不支持。
功能说明:获取图片信息。网络图片需先配置 download 域名才能生效。
参数及说明:Object object。
属性
类型
默认值
必填
说明
src
string
-
是
图片的路径,可以是相对路径、临时文件路径、存储文件路径、网络图片路径
success
function
-
否
接口调用成功的回调函数
fail
function
-
否
接口调用失败的回调函数
complete
function
-
否
接口调用结束的回调函数(调用成功、失败都会执行)
object.success 回调函数参数:Object res。
属性
类型
说明
width
number
图片原始宽度,单位 px。不考虑旋转
height
number
图片原始高度,单位 px。不考虑旋转
path
string
图片的本地路径
orientation
string
type
string
图片格式
res.orientation 的合法值
值
说明
up
默认方向(手机横持拍照),对应 Exif 中的 1,或无 orientation 信息
up-mirrored
同 up,但镜像翻转,对应 Exif 中的2
down
旋转180度,对应 Exif 中的3
down-mirrored
同 down,但镜像翻转,对应 Exif 中的4
left-mirrored
同 left,但镜像翻转,对应 Exif 中的5
right
顺时针旋转90度,对应 Exif 中的6
right-mirrored
同 right,但镜像翻转,对应 Exif 中的7
left
逆时针旋转90度,对应 Exif 中的8
res.type 的合法值
合法值
说明
unknown
未知格式
jpeg
jpeg压缩格式
png
png压缩格式
gif
gif压缩格式
tiff
tiff压缩格式
示例代码:
wx.getImageInfo({
src: 'images/a.jpg',
success(res) {
console.log(res.width)
console.log(res.height)
},
})

wx.chooseImage({
success(res) {
wx.getImageInfo({
src: res.tempFilePaths[0],
success(res) {
console.log(res.width)
console.log(res.height)
},
})
},
})

previewImage

该 API 使用方法为 wx.previewImage(Object object)
说明:
该API 小程序支持,小游戏暂不支持。
功能说明:在新页面中全屏预览图片。预览的过程中用户可以进行保存图片、发送给朋友等操作。
参数及说明:Object object。
属性
类型
默认值
必填
说明
urls
Array.<string>
-
是
需要预览的图片链接列表。 支持云文件 ID
current
string
urls 的第一张
否
当前显示图片的链接
success
function
-
否
接口调用成功的回调函数
fail
function
-
否
接口调用失败的回调函数
complete
function
-
否
接口调用结束的回调函数(调用成功、失败都会执行)
示例代码:
wx.previewImage({
current: '', // 当前显示图片的http链接
urls: [], // 需要预览的图片http链接列表
})

previewMedia

该 API 使用方法为 wx.previewMedia(Object object)
说明:
该API 小程序支持,小游戏不支持。
功能说明:预览图片和视频。
参数及说明:Object object。
属性
类型
默认值
必填
说明
sources
Array.<Object>

是
需要预览的资源列表
current
number
0
否
当前显示的资源序号
success
function

否
接口调用成功的回调函数
fail
function

否
接口调用失败的回调函数
complete
function

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

saveImageToPhotosAlbum

该 API 使用方法为 wx.saveImageToPhotosAlbum(Object object)
说明:
该API 小程序支持,小游戏暂不支持。
调用前需要“用户授权” scope.writePhotosAlbum。
功能说明:保存图片到系统相册。
参数及说明:Object object。
属性
类型
默认值
必填
说明
filePath
string
-
是
图片文件路径,可以是临时文件路径或永久文件路径 (本地路径),不支持网络图片路径
success
function
-
否
接口调用成功的回调函数
fail
function
-
否
接口调用失败的回调函数
complete
function
-
否
接口调用结束的回调函数(调用成功、失败都会执行)
示例代码:
wx.saveImageToPhotosAlbum({
success(res) {},
})


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈