Image 图片/照片
 
API 调用
 
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);
    },
}); 
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);
    }
});
						
					FAQ
						                        	关于此文档暂时还没有FAQ