知晓程序注:
很多小程序都为用户提供图片上传功能。这时候,使用一些「对象存储」云服务,也许是最快、最经济的选择。
那么,小程序该如何使用这类服务呢?使用的时候,又应该注意哪些问题呢?
知晓程序(微信号 zxcx0101)今天分享的这篇文章,会以腾讯云的对象存储服务为例,教大家将小程序接入对象存储服务。
关注「知晓程序」微信公众号,回复「开发」,获取小程序开发全套经验。
准备工作
上传图片,主要是将图片上传到腾讯云对象存储(COS)。
要使用对象存储 API,需要先执行以下步骤:
所以,我们要做的准备工作有:
这些配置过程这里就不做说明了,接下来主要介绍步骤 4 和 5。
小程序上传图片到 COS 的流程图,如下:
在这个过程中我们需要实现的是,鉴权服务器返回签名的步骤,以及小程序处理图片的相关步骤。
COS 鉴权服务
使用对象存储服务 COS 时,可通过 RESTful API,对 COS 发起 HTTP 匿名请求或签名请求。
对于签名请求,COS 服务器端将会进行对请求发起者的身份验证。
腾讯云 COS 对象存储,基于密钥 HMAC(Hash Message Authentication Code)的自定义 HTTP 方案,进行身份验证。
在此例中,上传图片是一个签名请求,需要进行签名验证。
1. 签名流程
客户通过对 HTTP 请求进行签名,并将签名后的请求发送至腾讯云进行签名验证,具体流程如下图所示:
我们使用 SDK 开发,只需要大致了解这个流程就行。在 SDK 中已包含签名的实现,我们只需要调用 SDK 中的方法即可。
通过签名流程我们可以知道,签名需要 SecretId
和 SecretKey
,这两个信息不适合存放在客户端中,这也是我们单独部署一个鉴权服务器的主要原因。
2. 生成签名的接口
在之前的文章中,我介绍过,我在服务端使用 sanic
框架和 swagger_py_codegen
生成 Rest API。
为了完成签名生成 API,我们需要先在文档中添加 API 的相关描述。
这个接口我们要求登录才能调用。
文档定义完成之后,调用 swagger_py_codegen -s docs/v1.yml . -p apis -tlp sanic
生成代码模板。API 代码实现如下:
由于腾讯云 COS v4 的 Python SDK 只支持 Python 2,而 sanic 需要 Python 3.5+,所以,这里我 fork 出来一份添加了 Python 3 的支持,使用 Python 3 的开发者,可以使用它。
关注「知晓程序」微信公众号,回复「源码」,获取该框架下载地址。
在小程序上传图片
1. 选择图片
wx.chooseImage(OBJECT)
从本地相册选择图片或使用相机拍照。
调用这个方法,小程序会把选择的图片放到临时路径,在小程序本次启动期间可以正常使用。
如需持久保存,需再调用 wx.saveFile
,在小程序下次启动时才能访问。
在小程序中,我们只能上传临时路径的文件。
核心代码如下:
这里图片选择成功后,我们取原图上传到 COS。
2. 上传图片
COS 上传图片的 URL,由 cos_region
,appid
,bucket_name
和 cos_dir_name
等参数拼接而成。
把以下字段配置成自己的 COS 相关信息(详情可看 API 文档):
REGION
:COS 上传的地区APPID
:账号的 AppIdBUCKET_NAME
:COS Bucket 的名字DIR_NAME
:上传的文件目录小程序提供了 uploadTask.onProgressUpdate()
来获取图片的上传进度,所以在这里,我将图片的上传进度显示了出来。
原文地址: https://juejin.im/post/59a23fff518825244d204d9e