qq.saveImageToPhotosAlbum

qq.saveImageToPhotosAlbum(Object object)

调用前需要 用户授权 scope.writePhotosAlbum

保存图片到系统相册。

参数

Object object
属性类型默认值必填说明
filePathstring是图片文件路径，可以是临时文件路径或永久文件路径，不支持网络图片路径
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

  1. qq.saveImageToPhotosAlbum({
  2.   success(res) { }
  3. })

qq.previewImage

qq.previewImage(Object object)

在新页面中全屏预览图片。预览的过程中用户可以进行保存图片、发送给朋友等操作。

参数

Object object
属性类型默认值必填说明
urlsArray.<string>是需要预览的图片链接列表。 支持云文件ID。
currentstringurls 的第一张否当前显示图片的链接
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

  1. qq.previewImage({
  2.   current: '', // 当前显示图片的http链接
  3.   urls: [] // 需要预览的图片http链接列表
  4. })

qq.getImageInfo

qq.getImageInfo(Object object)

获取图片信息。网络图片需先配置download域名才能生效。

参数

Object object
属性类型默认值必填说明
srcstring是图片的路径，可以是相对路径、临时文件路径、存储文件路径、网络图片路径
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）
object.success 回调函数

参数

Object res

属性类型说明最低版本
widthnumber图片原始宽度，单位px。不考虑旋转。
heightnumber图片原始高度，单位px。不考虑旋转。
pathstring图片的本地路径
orientationstring拍照时设备方向图片 - 图1
typestring图片格式

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

示例代码

  1. qq.getImageInfo({
  2.   src: 'images/a.jpg',
  3.   success(res) {
  4.     console.log(res.width)
  5.     console.log(res.height)
  6.   }
  7. })
  9. qq.chooseImage({
  10.   success(res) {
  11.     qq.getImageInfo({
  12.       src: res.tempFilePaths[0],
  13.       success(res) {
  14.         console.log(res.width)
  15.         console.log(res.height)
  16.       }
  17.     })
  18.   }
  19. })

qq.chooseMessageFile

qq.chooseMessageFile(Object object)

从客户端会话选择文件。

参数

Object object
属性类型默认值必填说明最低版本
countnumber是最多可以选择的图片张数，可以 0～100
typestring'all'否所选的文件的类型
extensionArray.<string>否根据文件拓展名过滤，仅 type==file 时有效。每一项都不能是空字符串。默认不过滤。
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

object.type 的合法值

值说明
all从所有文件选择
video只能选择视频文件
image只能选择图片文件
file只能选择除图片和视频的文件
object.success 回调函数

参数

Object res

属性类型说明
tempFilesArray.<Object>返回选择的文件的本地临时文件对象数组

res.tempFiles 的结构

属性类型说明
pathstring本地临时文件路径
sizenumber本地临时文件大小，单位 B
namestring选择的文件名称
typestring选择的文件类型
timenumber选择的文件的会话发送时间，Unix时间戳，工具暂不支持此属性

type 的合法值

值说明
video选择了视频文件
image选择了图片文件
file选择了除图片和视频的文件

示例代码

  1. qq.chooseMessageFile({
  2.   count: 10,
  3.   type: 'image',
  4.   success(res) {
  5.     // tempFilePath可以作为img标签的src属性显示图片
  6.     const tempFilePaths = res.tempFilePaths
  7.   }
  8. })

qq.chooseImage

qq.chooseImage(Object object)

从本地相册选择图片或使用相机拍照。

参数

Object object
属性类型默认值必填说明
countnumber9否最多可以选择的图片张数
sizeTypeArray.<string>['original', 'compressed']否所选的图片的尺寸
sourceTypeArray.<string>['album', 'camera']否选择图片的来源
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

object.sizeType 的合法值

值说明
original原图
compressed压缩图

object.sourceType 的合法值

值说明
album从相册选图
camera使用相机
object.success 回调函数

参数

Object res

属性类型说明最低版本
tempFilePathsArray.<string>图片的本地临时文件路径列表
tempFilesArray.<Object>图片的本地临时文件列表

res.tempFiles 的结构

属性类型说明
pathstring本地临时文件路径
sizenumber本地临时文件大小，单位 B

示例代码

  1. qq.chooseImage({
  2.   count: 1,
  3.   sizeType: ['original', 'compressed'],
  4.   sourceType: ['album', 'camera'],
  5.   success(res) {
  6.     // tempFilePath可以作为img标签的src属性显示图片
  7.     const tempFilePaths = res.tempFilePaths
  8.   }
  9. })