qg.chooseImage

基础信息说明

功能概述：从本地相册选择图片或使用相机拍照

项目	说明
版本要求	无
前提条件	无
使用限制	无
相关教程	无

参数说明

qg.chooseImage(option)

属性名	类型	默认值	必填	说明
success	Function(Object)	-	否	成功回调
fail	Function	-	否	失败回调
complete	Function	-	否	执行结束后的回调
count	Number	9	否	最多选择的图片张数
sizeType	Array <String>	['original','compressed']	否	所选图片的尺寸
sourceType	Array <String>	['album','camera']	否	图片来源

sizeType 取值说明

值	说明
original	原图
compressed	压缩图

sourceType 取值说明

值	说明
album	从相册选图
camera	使用相机

回调结果说明

回调	触发时机（旧接口预期）	回调参数
success	选择或拍照成功后	Object res（见下表）
fail	选择或拍照失败时	使用形参接收，比如err，返回错误信息
complete	接口调用结束（成功/失败皆触发）	同入参

回调成功

属性名	类型	说明
tempFilePaths	Array <String>	图片本地临时文件路径列表
tempFiles	Array <Object>	图片本地临时文件信息

tempFiles 元素结构

属性名	类型	说明
name	String	文件名（示例：photoxxxxxxxxxx.jpg）
size	Number	文件大小，单位 B
url	String	文件 URI（示例：internal://cache/...）

示例代码

qg.chooseImage({
  count: 3,
  sourceType: ['album', 'camera'],
  sizeType: ['original', 'compressed'],
  success(res) {
    console.log('选择成功', res)
  },
    fail(err) {
    console.log('选择失败', res)
  },
complete(res) {
    console.log('执行完成', res)
  },
})

qg.previewImage

基础信息说明

功能概述：全屏预览图片

项目	说明
版本要求	无
前提条件	需确保图片 URI 可访问
使用限制	无
相关教程	无

参数说明

qg.previewImage(option)

属性名	类型	默认值	必填	说明
urls	Array <String>	-	是	源文件的url列表，可为 internal 路径或网络 url
current	String	urls 的第一张	否	当前显示图片的链接
success	Function	-	否	成功回调，透传底层结果
fail	Function	-	否	失败回调，透传底层结果
complete	Function	-	否	接口调用结束回调（成功或失败都会执行）

回调结果说明

回调	触发时机	回调参数
success	预览请求成功时	使用形参接收即可，非必传，默认返回值为字符串 'success'
fail	调用失败时	使用形参接收，比如err，返回字符串类型的错误信息
complete	调用结束时（成功或失败都会执行）	同success

示例代码

// 全屏预览多张图片，并查看回调参数
qg.previewImage({
  urls: [
    'https://example1.png',
    'https://example2.png'
  ],
  success(res) {
    console.log('预览成功', res) //  res 为 'success'
  },
  fail(err) {
    console.error('预览失败', err) // err为 Parameter of 'uris' error.
  },
  complete(res) {
    console.log('预览完成', res) //  res 为 'success'
  }
})

qg.saveImageToPhotosAlbum

基础信息说明

功能概述：将指定图片保存到系统相册

项目	说明
版本要求	无
前提条件	需具备读取图片源文件与写入系统相册的权限
使用限制	不支持网络图片路径
相关教程	无

参数说明

qg.saveImageToPhotosAlbum(option)

属性名	类型	默认值	必填	说明
filePath	String	-	是	图片文件路径，可以是临时文件路径或永久文件路径，不支持网络图片路径
success	Function	-	否	成功回调
fail	Function	-	否	失败回调
complete	Function	-	否	完成回调

回调结果说明

回调	触发时机	回调参数
success	保存成功时触发	使用形参接收即可，非必传
fail	保存失败时触发	使用形参接收，比如err，返回错误信息
complete	请求结束时触发（成功/失败皆执行）	同success

示例代码

// 保存图片到系统相册
qg.saveImageToPhotosAlbum({
  filePath: '/data/local/tmp/screenshot.png',
  success(res) {
    console.log('保存成功', res)
  },
  fail(err) {
    console.error('保存失败', err)
  },
complete(res) {
    console.log('执行完成', res)
  },
})

注意事项

不支持网络图片路径

上一篇:音频

下一篇:文件管理器

文档内容是否有帮助？

有帮助

无帮助