开启掘金成长之旅!这是我参与「掘金日新计划 · 12 月更文挑战」的第29天,点击查看活动详情
最近这几天阳了,一直都不是很舒服,只整理了一些图片的接口。!!!
my.chooseImage
my.chooseImage 是拍照或从本地相册中选择图片的 API。
使用限制
- 图片的路径数组在 IDE 上以 .png 为后缀,在真机预览上以 .image 为后缀。请以真机效果为准。
- 出于数据安全考虑, IoT 小程序禁止调用摄像头;请勿在 IoT 小程序上调用此 API,否则会造成小程序异常。
- 此 API 支持个人支付宝小程序、企业支付宝小程序使用。
该接口当中涉及的一些参数信息
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| count | Number | 否 | 最大可选照片数,默认为 1 张。 |
| sizeType | StringArray | 否 | 图片类型。 可选值:- original:原图。- compressed:压缩图。默认二者都有。 |
| sourceType | String Array | 否 | 相册选取或者拍照,默认 ['camera','album']。 |
| success | Function | 否 | 调用成功的回调函数。 |
| fail | Function | 否 | 调用失败的回调函数。 |
| complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行)。 |
success回调当中的参数
还可以把图片转为base64格式的照片。
具体实现代码
my.chooseImage({
success: res => {
const fs = my.getFileSystemManager();
fs.readFile({
filePath: `${res.apFilePaths[0]}`,
// readFile 不传入 encodding 参数,则以 ArrayBuffer 方式读取
success:({ data }) => {
const base64 = my.arrayBufferToBase64(data);
//
},
});
}
});
my.previewImage
my.previewImage 是预览图片的 API。
使用限制
- 此 API 支持个人支付宝小程序、企业支付宝小程序使用。
使用完该接口,上传完照片以后,会立刻看到预览的图片,同时还可以显示下载按钮。
my.getImageInfo
my.getImageInfo 是获取图片信息的 API。
使用限制
- 此 API 支持个人支付宝小程序、企业支付宝小程序使用。
该接口里面涉及到的一些参数如下
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| src | String | 是 | 图片路径,支持网络图片路径、本地临时文件、本地缓存文件、包文件路径、本地用户文件。其中本地用户文件路径客户端 10.2.70 开始支持,之前的客户端版本存在兼容性问题。 |
| success | Function | 否 | 调用成功的回调函数。 |
| fail | Function | 否 | 调用失败的回调函数。 |
| complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行)。 |
以下是自己写的示例代码
my.saveImageToPhotosAlbum
my.saveImageToPhotosAlbum 是保存图片到系统相册的 API。
该接口里面涉及到的参时是个Object,里面每一个键名如下:
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| filePath | String | - | 是 | 图片文件路径,支持网络地址、本地临时文件、本地缓存文件、本地用户文件、图片 base64 数据的 Data URL。 注意: |
| success | Function | - | 否 | 调用成功的回调函数。 |
| fail | Function | - | 否 | 调用失败的回调函数。 |
| complete | Function | - | 否 | 调用结束的回调函数(调用成功、失败都会执行)。 |
success回调的参数
| 属性 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 返回 true 则表示保存成功。 |