6 月 21 日，腾讯云在 2017「云 未来」峰会上推出了战略新品——智能云，宣布将腾讯积累近 20 年的 AI 能力向政府、企业和开发者开放，其中首批开放计算机视觉、智能语音识别、自然语言处理的三大核心能力。腾讯云技术社区陆续推出了系列文章，向普通开发者分享如何快速接入并使用这三大 AI 能力，节省自身的开发成本，同时极大提升开发效率和用户体验。
本文将为广大云开发者介绍如何接入腾讯开放的计算机视觉能力，即万象优图。
1 基本架构及业务流程
1.1基本架构
数据安全是云存储的重中之重，为了保护开发者的数据安全，腾讯云·万象优图的上传、复制、删除和下载（如果设置了防盗链）服务需要鉴权签名；鉴权签名的生成需要用到SecretKey，所以签名的生成需要在可信任的环境中进行，绝不能在客户端进行，否则会带来密钥泄漏的风险，危害开发者数据。腾讯云·万象优图推荐使用以下的服务器架构设计：
主要包括三个部分：
1 腾讯云·万象优图
提供高成功率、高可靠、高速的图片存储服务，以及强大的图像处理技术；
2. 开发者服务器
开发者服务器至少提供如下3个功能：
1)、生成签名。签名的生成不能在终端上进行，否则会产生极大的安全隐患； 2)、使用数据库管理用户信息、图片资源信息； 3)、响应终端的业务请求；
另外，开发者服务器还可以直接与腾讯云·万象优图通信对图片进行管理操作。
3. 终端
通常既上传图片也下载图片。在展示图片前，通常先从开发者服务器获取要展示的图片信息，比如图片的url；在上传图片前，通常先从开发者服务器获取签名，然后带着签名请求腾讯云·万象优图。
1.2 业务流程
1.2.1 图片上传
终端上传图片前先请求开发者服务器获取上传签名，然后再请求腾讯云·万象优图，腾讯云·万象优图会对上传签名进行验证，无效的签名会返回签名认证错误等信息。图片上传流程根据开发者是否设置回调可分为两种方案。
方案一：无回调设置
上传流程主要包括三个步骤：
- 终端访问开发者服务器，获取签名（注意：签名的创建不能在终端上进行，否则可能会导致用户信息泄露等安全隐患）；
- 终端上传图片，腾讯云·万象优图验证签名、存储图片，生成文件ID，URL等信息返回给终端；
- 终端将图片信息和用户信息反馈给开发者服务器。
方案二：有回调设置
如果有设置回调，则上传完成时腾讯云·万象优图会自动向开发者服务器发起设置的回调url请求。
上传流程主要包括四个步骤：
- 终端访问开发者服务器，获取签名（注意：签名的创建不能在终端上进行，否则可能会导致用户信息泄露等安全隐患）；
- 终端上传图片，腾讯云·万象优图验证签名、存储图片，生成文件ID，URL等信息通过回调url传给开发者服务器；
- 业务服务存储相应的图片信息，并将处理结果返还给腾讯云·万象优图；
- 腾讯云·万象优图根据开发者服务器返回的处理信息返还给终端结果。
1.2.2 图片下载
图片下载使用图片上传成功后返回的的下载url直接访问，即直接访问download_url。
如果设置了Token防盗链，则使用下载url加签名的方式直接访问，即：download_url?sign=[签名]
2 接入服务
根据开发者业务的现有情况可将服务接入分为两种类型：回源镜像和一般接入。其中回源镜像适用于开发者的历史图片没有存储在腾讯云·万象优图，而要使用腾讯云·万象优图的下载（和其他服务，如果开发者希望接入）服务；一般接入是指开发者没有或者不考虑历史图片，使用腾讯云·万象优图对图片进行上传、下载和其他操作。
注：回源镜像可以用作开发者图片数据的灾备；也可以让开发者一键试用服务，方便快捷。
2.1 回源镜像
2.1.1 注册账号
前往腾讯云·万象优图控制台注册账号。
注：以下称图片空间为bucket。
2.1.2 场景接入
腾讯云·万象优图根据开发者的源站类型和所需服务，将回源镜像划分为四个场景。
注意： 腾讯云·万象优图针对四个场景分别进行了优化，请根据自身的情况选择合适场景接入，获取最优的服务体验。
场景一：使用万象优图下载，回源到其他云存储厂商
场景二：使用万象优图下载，回源到自己站点
场景三：使用万象优图上传和下载，历史图片回源到其他云存储厂商
场景四：使用万象优图上传和下载，历史图片回源到自己站点
2.2 一般接入
由2.1.1 基本架构章节可知，开发者如需接入腾讯云·万象优图服务，为了保护数据的安全，开发者需要在自己开发者服务器上面部署鉴权服务；终端需要向开发者服务器请求的签名，然后进行相应的服务操作，例如进行图片的上传，复制，删除，下载等。
2.2.1 接入流程
接入腾讯云·万象优图只需以下三步：
1 注册腾讯云·万象优图；
2 终端部署示例；
3 鉴权服务部署示例。
下面分别介绍终端部署简单示例，鉴权服务部署简单示例，以及终端和开发者服务器交互签名的过程。
说明：
- 文档中终端和开发者服务器的签名交互过程只是一个简单的例子，开发者需要根据自己业务需求开发交互过程。
- 如果开发者想使用本文档提供的例子进行简单测试，请确保终端和服务端的项目信息一致，如项目ID，空间名称，SecretID和SecretKey等。
2.2.1.1 注册腾讯云·万象优图
- 前往腾讯云·万象优图控制台注册账号；如果已经注册账号，请跳过此步骤；
- 在腾讯云·万象优图控制台创建一个图片空间，获取空间名称（bucket）和项目ID；如果已创建过图片空间，请跳过此步骤；
- 在腾讯云·万象优图控制台项目设置中添加密钥，获取SecretID和SecretKey；如果已经添加过密钥，请跳过此步骤。
2.2.1.2 终端部署示例
腾讯云·万象优图提供了丰富的Restful API接口，开发者可以参考Restful API部署和开发终端。
同时腾讯云·万象优图还为开发者提供了功能丰富的移动端SDK，以及web端部署示例。开发者也可是使用移动端SDK开发自己的服务，下面简单介绍使用终端SDK部署服务的简单示例，开发者需要根据自身业务情况开发相应的代码：
终端部署示例-Android
终端部署示例-iOS
web端部署示例
移动端SDK的详细文档说明请参见移动端SDK文档。
2.2.1.3 鉴权服务部署示例
以下为鉴权服务部署的简单示例(使用了服务端SDK)，开发者可以简单参考，开发自身业务鉴权服务，并集成到自身服务器中：
注意：下面的文档只是简单的示例，展示了服务端为终端提供签名的简单用法，开发者务必根据自身业务开发相应的鉴权服务逻辑，并集成到自身服务器中。
鉴权服务部署示例-Java
鉴权服务部署示例-PHP
鉴权服务部署示例-Python
鉴权服务部署示例-Nodejs
鉴权服务部署示例-GO
如需使用服务端更多功能，请参见服务端SDK文档。
