1. Image 图片/照片
1.1. API 调用
1.1.1. QN.image.get(options)
通过拍照、相册等方式获取图片
注意： 该接口获取的图片的原始数据，很可能超过2M，这时如果直接进行图片上传可能导致失败。这种情况下，可以调用 compressImage 通用协议接口对图片进行压缩后再上传。
API 调用入参
| 参数名 |
类型 |
是否可选 |
默认值 |
含义 |
options |
Object |
|
|
选项 |
options.query |
Object |
|
|
请求参数 |
options.query.source |
String |
|
camera,gallery |
获取图片的方式，camera（拍照） gallery（相册），如果未指定或指定两者则会提供界面给用户进行选择 |
options.query.limit |
Numner |
|
不限制 |
最多允许选择的图片数量 |
API 响应结果
| 参数名 |
类型 |
是否必须返回 |
含义 |
result |
Object |
|
响应对象 |
result.code |
String |
|
错误码，成功为 QAP_SUCCESS；失败为其他 |
result.msg |
String |
|
错误信息 |
result.data |
Array |
|
获得的图片数据 |
result.data[].path |
String |
|
图片本地路径 |
result.data[].localURL |
String |
|
图片本地URL，可用于预览 |
调用示例
QN.image.get({
query: {
source: 'gallery',
limit: 9,
}
}).then((result) => {
console.log(result);
}, (error) => {
console.log(error);
});
QN.image.get({
query: {
source: 'gallery',
limit: 9,
},
success(result) {
console.log(result);
},
error(error) {
console.log(error);
},
});
1.1.2. QN.image.preview(options)
API 调用入参
| 参数名 |
类型 |
是否可选 |
默认值 |
含义 |
options |
Object |
|
|
选项 |
options.query |
Object |
|
|
请求参数 |
options.query.images |
Array |
|
|
需要预览的图片URL列表 |
options.query.startIndex |
Number |
|
0 |
从图片列表中哪一张开始预览 |
API 响应结果
| 参数名 |
类型 |
是否必须返回 |
含义 |
result |
Object |
|
响应对象 |
result.code |
String |
|
错误码，成功为 QAP_SUCCESS；失败为其他 |
result.msg |
String |
|
错误信息 |
调用示例
QN.image.preview({
query: {
images: [
'https://gw.alicdn.com/tps/TB12TMIPXXXXXbyXpXXXXXXXXXX-750-400.jpg',
'https://gw.alicdn.com/tps/TB1kUcYPXXXXXa7XpXXXXXXXXXX-750-580.jpg',
'https://gw.alicdn.com/tps/TB1pn7NPXXXXXbpXFXXXXXXXXXX-750-511.jpg',
'https://gw.alicdn.com/tps/TB1C5kOPXXXXXbkXFXXXXXXXXXX-750-580.jpg',
'https://gw.alicdn.com/tps/TB1pn7NPXXXXXbpXFXXXXXXXXXX-750-511.jpg',
],
startIndex: 0,
}
}).then((result) => {
console.log(result);
}, (error) => {
console.log(error);
});
QN.image.preview({
query: {
images: [
'https://gw.alicdn.com/tps/TB12TMIPXXXXXbyXpXXXXXXXXXX-750-400.jpg',
'https://gw.alicdn.com/tps/TB1kUcYPXXXXXa7XpXXXXXXXXXX-750-580.jpg',
'https://gw.alicdn.com/tps/TB1pn7NPXXXXXbpXFXXXXXXXXXX-750-511.jpg',
'https://gw.alicdn.com/tps/TB1C5kOPXXXXXbkXFXXXXXXXXXX-750-580.jpg',
'https://gw.alicdn.com/tps/TB1pn7NPXXXXXbpXFXXXXXXXXXX-750-511.jpg',
],
startIndex: 0,
},
success(result) {
console.log(result);
},
error(error) {
console.log(error);
}
});