保存图片到系统相册。
参数
Object object
示例代码
在新页面中全屏预览图片。预览的过程中用户可以进行保存图片、发送给朋友等操作。
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
urls | Array.<string> | 是 | 需要预览的图片链接列表。 支持云文件ID。 | |
current | string | urls 的第一张 | 否 | 当前显示图片的链接 |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
获取图片信息。网络图片需先配置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 | 图片格式 |
值 | 说明 |
---|---|
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 |
示例代码
从客户端会话选择文件。
参数
Object object
object.type 的合法值
值 | 说明 |
---|---|
all | 从所有文件选择 |
video | 只能选择视频文件 |
image | 只能选择图片文件 |
file | 只能选择除图片和视频的文件 |
object.success 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
tempFiles | Array.<Object> | 返回选择的文件的本地临时文件对象数组 |
res.tempFiles 的结构
属性 | 类型 | 说明 |
---|---|---|
path | string | 本地临时文件路径 |
size | number | 本地临时文件大小,单位 B |
name | string | 选择的文件名称 |
type | string | 选择的文件类型 |
time | number | 选择的文件的会话发送时间,Unix时间戳,工具暂不支持此属性 |
值 | 说明 |
---|---|
video | 选择了视频文件 |
image | 选择了图片文件 |
file | 选择了除图片和视频的文件 |
示例代码
从本地相册选择图片或使用相机拍照。
参数
Object object
object.sizeType 的合法值
值 | 说明 |
---|---|
original | 原图 |
compressed | 压缩图 |
object.sourceType 的合法值
值 | 说明 |
---|---|
album | 从相册选图 |
camera | 使用相机 |
object.success 回调函数
参数
Object res
属性 | 类型 | 说明 | 最低版本 |
---|---|---|---|
tempFilePaths | Array.<string> | 图片的本地临时文件路径列表 | |
tempFiles | Array.<Object> | 图片的本地临时文件列表 |
属性 | 类型 | 说明 |
---|---|---|
path | string | 本地临时文件路径 |
size | number | 本地临时文件大小,单位 B |