1.3.11.1 QN.image
优质
小牛编辑
127浏览
2023-12-01
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);
}
});