文档

# qq.saveImageToPhotosAlbum

QQ mac 版本：支持

QQ windows 版本：支持

# 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 mac 版本：支持

QQ windows 版本：支持

# 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 mac 版本：支持

QQ windows 版本：支持

# 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 mac 版本：支持

QQ windows 版本：支持

# 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 开始支持,低版本需做兼容处理

QQ mac 版本：暂不支持

QQ windows 版本：暂不支持

从客户端会话选择文件。

# 参数

# Object object

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

# object.type 的合法值

值 说明 最低版本
all 从所有文件选择
media 选择视频和音频文件
image 只能选择图片文件
file 支持常见格式的文档、演示文稿、电子表格和 PDF 类型

# 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

注意

从基础库 1.55.0 开始，本接口停止维护，请使用 qq.chooseMedia 代替。

QQ mac 版本：支持

QQ windows 版本：支持

# 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 开始支持,低版本需做兼容处理

QQ mac 版本：暂不支持

QQ windows 版本：暂不支持

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

# 参数

# 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 选择的文件类型

← 视频 →