1.3.11.1 QN.image

优质
小牛编辑
127浏览
2023-12-01

1.1. API 调用

1.1.1. QN.image.get(options)

通过拍照、相册等方式获取图片

注意: 该接口获取的图片的原始数据,很可能超过2M,这时如果直接进行图片上传可能导致失败。这种情况下,可以调用 compressImage 通用协议接口对图片进行压缩后再上传。

API 调用入参

参数名类型是否可选默认值含义
optionsObject选项
options.queryObject请求参数
options.query.sourceStringcamera,gallery获取图片的方式,camera(拍照) gallery(相册),如果未指定或指定两者则会提供界面给用户进行选择
options.query.limitNumner不限制最多允许选择的图片数量

API 响应结果

参数名类型是否必须返回含义
resultObject响应对象
result.codeString错误码,成功为 QAP_SUCCESS;失败为其他
result.msgString错误信息
result.dataArray获得的图片数据
result.data[].pathString图片本地路径
result.data[].localURLString图片本地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 调用入参

参数名类型是否可选默认值含义
optionsObject选项
options.queryObject请求参数
options.query.imagesArray需要预览的图片URL列表
options.query.startIndexNumber0从图片列表中哪一张开始预览

API 响应结果

参数名类型是否必须返回含义
resultObject响应对象
result.codeString错误码,成功为 QAP_SUCCESS;失败为其他
result.msgString错误信息

调用示例

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);
    }
});