jd.chooseImage(OBJECT)
从本地相册选择图片或使用相机拍照。
OBJECT 参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
count | Number | 否 | 最多可以选择的图片张数,默认 9 |
sizeType | StringArray | 否 | original 原图,compressed 压缩图,默认二者都有 |
sourceType | StringArray | 否 | album 从相册选图,camera 使用相机,默认二者都有 |
success | Function | 是 | 成功则返回图片的本地文件路径列表 tempFilePaths |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
tempFilePaths | StringArray | 图片的本地文件路径列表 |
tempFiles | ObjectArray | 图片的本地文件列表,每一项是一个 File 对象 |
File 对象结构如下:
字段 | 类型 | 说明 |
---|---|---|
path | String | 本地文件路径 |
size | Number | 本地文件大小,单位:B |
示例代码
jd.chooseImage({
count: 2, // 默认9
sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图,默认二者都有
sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机,默认二者都有
success: function (res) {
// 返回选定照片的本地文件路径列表,tempFilePath可以作为img标签的src属性显示图片
var tempFilePaths = res.tempFilePaths
}
})
jd.previewImage(OBJECT)
预览图片。
OBJECT参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
current | String | 否 | 当前显示图片的链接,不填则默认为 urls 的第一张 |
urls | StringArray | 是 | 需要预览的图片链接列表 |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
jd.previewImage({
current: '', // 当前显示图片的http链接
urls: [] // 需要预览的图片http链接列表
})
jd.getImageInfo(OBJECT)
获取图片信息,倘若为网络图片,需先配置download域名才能生效。
OBJECT 参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
src | String | 是 | 图片的路径,可以是相对路径,临时文件路径,存储文件路径,网络图片路径 |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success 返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
width | Number | 图片宽度,单位 px |
height | Number | 图片高度,单位 px |
path | String | 返回图片的本地路径 |
orientation | String | 返回图片的方向,有效值见下表 |
type | String | 返回图片的格式 |
orientation 参数说明:
枚举值 | 说明 |
---|---|
up | 默认 |
down | 180 度旋转 |
left | 逆时针旋转 90 度 |
right | 顺时针旋转 90 度 |
up-mirrored | 同 up,但水平翻转 |
down-mirrored | 同 down,但水平翻转 |
left-mirrored | 同 left,但垂直翻转 |
right-mirrored | 同 right,但垂直翻转 |
示例代码
jd.getImageInfo({
src: 'images/name.jpg',
success: function (res) {
console.log(res)
}
})
jd.chooseImage({
success: function (res) {
jd.getImageInfo({
src: res.tempFilePaths[0],
success: function (res) {
console.log(res.width)
}
})
}
})
jd.saveImageToPhotosAlbum(OBJECT)
保存图片到系统相册。需要用户授权 scope.writePhotosAlbum
OBJECT 参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
filePath | String | 是 | 图片文件路径,可以是临时文件路径也可以是永久文件路径,不支持网络图片路径 |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success 返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
errMsg | String | 调用结果 |
示例代码
jd.saveImageToPhotosAlbum({
success(res) {
console.log(res)
}
})