qq.saveImageToPhotosAlbum

qq.saveImageToPhotosAlbum(Object object)

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

保存图片到系统相册。

参数

Object object
属性 类型 默认值 必填 说明
filePath string 图片文件路径,可以是临时文件路径或永久文件路径,不支持网络图片路径
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

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

qq.previewImage

qq.previewImage(Object object)

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

参数

Object object
属性 类型 默认值 必填 说明
urls Array.<string> 需要预览的图片链接列表。 支持云文件ID。
current string urls 的第一张 当前显示图片的链接
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

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

qq.getImageInfo

qq.getImageInfo(Object object)

获取图片信息。网络图片需先配置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

示例代码

qq.getImageInfo({
  src: 'images/a.jpg',
  success(res) {
    console.log(res.width)
    console.log(res.height)
  }
})

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

qq.compressImage

qq.compressImage(Object object)

压缩图片接口,可选压缩质量

参数

Object object

属性 类型 默认值 必填 说明
src string 图片路径,图片的路径,支持本地路径、代码包路径
quality number 80 压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对jpg有效)。
destWidth number 压缩目标宽度(基础库1.17.0开始支持)
destHeight number 压缩目标高度(基础库1.17.0开始支持)
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性 类型 说明
tempFilePath string 压缩后图片的临时文件路径 (本地路径)

示例代码

qq.compressImage({
  src: '', // 图片路径
  quality: 80 // 压缩质量
})
1
2
3
4

qq.chooseMessageFile

qq.chooseMessageFile(Object object)

| 基础库从1.18.0开始支持,低版本需做兼容处理

从客户端会话选择文件。

参数

Object object

属性 类型 默认值 必填 说明 最低版本
count number 100 最多可以选择的文件个数,可以 1~100
type string 'all' 所选的文件的类型
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数

object.type 的合法值

说明 最低版本
all 从所有文件选择
media 选择视频和音频文件
image 只能选择图片文件
file 可以选择除了图片,视频,音频,txt文本之外的其它的文件

object.success 回调函数

参数
Object res
属性 类型 说明
tempFiles Array.<Object> 返回选择的文件的本地临时文件对象数组
res.tempFiles 的结构
属性 类型 说明
path string 本地临时文件路径 (本地路径)
size number 本地临时文件大小,单位 B
name string 选择的文件名称
type string 选择的文件类型
time number 选择的文件的会话发送时间,Unix时间戳,工具暂不支持此属性
type 的合法值
说明 最低版本
media 选择了视频或音频文件
image 选择了图片文件
file 选择了除图片,视频,音频的文件

示例

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

qq.chooseImage

qq.chooseImage(Object object)

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

参数

Object object
属性 类型 默认值 必填 说明
count number 9 最多可以选择的图片张数
sizeType Array.<string> ['original', 'compressed'] 所选的图片的尺寸
sourceType Array.<string> ['album', 'camera'] 选择图片的来源
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.sizeType 的合法值

说明
original 原图
compressed 压缩图

object.sourceType 的合法值

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

参数

Object res

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

res.tempFiles 的结构

属性 类型 说明
path string 本地临时文件路径
size number 本地临时文件大小,单位 B

示例代码

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

qq.chooseExternalFile

qq.chooseExternalFile(Object object)

| 基础库1.19.0 开始支持,低版本需做兼容处理

从指定外部小程序中(如微云,腾讯文档)选取文件.

参数

Object object
属性 类型 默认值 必填 说明
from string 指定从哪个小程序获取文件
count number 100 最多可以选择的文件个数,可以 1~100
onStatusChange function 选择文件结束时,及各文件下载状态变更时触发的回调函数,可用户更新页面状态
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
  • 特殊说明: 从外部小程序选择文件后, 会自动先把文件下载到本地,再返回临时文件路径. 为了能选择文件后, 立刻显示选择结果, 会先回调onStatusChange函数,(后续每个文件下载完成,也会回调一次onStatusChange). 等所有文件都下载完才会回调succee函数.
object.from 合法值
说明
TencentDocs 腾讯文档小程序
Weiyun 微云小程序
object.onStatusChange 回调函数

参数

Object res
属性 类型 说明
files Array.<FileInfo> 返回选择的文件的本地临时文件对象数组
object.success 回调函数

参数

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

FileInfo数据结构

属性 类型 说明
tempFilePath string 本地临时文件路径 (本地路径),仅成功下载到本地的文件此属性
status string 文件下载状态, downloading, success, error
size number 文件大小,单位 KB
name string 选择的文件名称
type string 选择的文件类型