1.3.11.1 QN.image

优质

小牛编辑

124浏览

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