程序之美

前言

人脸识别服务（Face Recognition Service，简称FRS），是基于人的脸部特征信息，利用计算机对人脸图像进行处理、分析和理解，进行身份识别的一种智能服务。人脸识别以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等，打造智能化业务系统，提升业务效率。

通常人脸识别都包含有人脸检测、人脸比对、人脸搜索、活体检测等服务，这里我们以人脸检测为例，体验下华为云的人脸识别服务。
先看下识别结果，如下图：
从上面的结果来看，华为云人脸识别算法还是挺优秀的，大概识别时间为151毫秒(从发起到收到结果，包括识别时间和来回的网络时间)

操作流程

很多刚注册平台的小伙伴们，可能感觉一头雾水，根本不知道如何操作，这里我就将整个操作流程记录下来，以便于小伙伴们查阅和使用。

首先注册和登录这里就不说了，我相信这个难不倒我们的小伙伴，当我们注册和登录完成后，点击右上角的控制台，进入到如下页面：

这里要留意上图中的控制台旁边的区域，此时为北京四，后面有涉及到。
按照如何使用API调用人脸识别服务进行一步一步操作即可。

下面我们说下统一身份认证，如下图所示，点击统一身份认证的菜单，进入统一身份认证的页面，可按照https://support.huaweicloud.com/face_faq/face_06_0053.html 页面进行IAM帐户的创建。

另外有一个值得说地方，这个在华为云文档中并未涉及到，刚注册的小伙伴可能对其不了解，所以肯定感觉一头雾水，就是区域点要一致，如下图所示。

如图中的所属区域为“北京四”，那么云上服务订阅-人脸识别服务中的所属区域也应该是“北京四”，即开通人脸检测的服务的所属区域应该是“北京四”，还有作为网络请求参数的"我的凭证"中的相应的参数也应该使用“北京四”的参数，我就是在这里没有对应上，所以耽误了半天时间，希望小伙伴们，不要在这里再走弯路。

所遇问题

1、用户名密码错误

"error": {
        "code": 401,
        "message": "The username or password is wrong.",
        "title": "Unauthorized"
    }
}

解决方案：
https://support.huaweicloud.com/face_faq/face_06_0053.html

2、API不存在或者没有部署

{
    "error_msg": "The API does not exist or has not been published in the environment",
    "error_code": "APIG.0101",
    "request_id": "0b363c83d94bc8b5a3c938d279ccbc9d"
}

解决方案：
https://support.huaweicloud.com/face_faq/face_06_0026.html

参照视频：
https://bbs.huaweicloud.com/videos/102987

结束语

好了先说到这里吧，后续我会进一步把人脸服务体验的相关结果进行展示，也希望有条件的小伙伴和我一起来体验华为云人脸服务的强大与震撼，小伙伴们如果有什么疑问和建议都可以和我联系，共同 学习，共同进步，共同成长。也希望华为云能够不忘初心，砥砺前行，服务于大众，恩施于苍穹。

最近公司要接入华为的人脸识别api这是前提，看了一天手册跟着文档做下来有问题的地方不少，就以demo为例子写一写经验吧

先给上SDK介绍 https://support.huaweicloud.com/sdkreference-face/face_04_0016.html
华为云的SDK是放在GitHub上的 https://github.com/huaweicloud/huaweicloud-sdk-csharp-frs
有了SDK后就开始吧。

这就是SDK的全部了 需要使用者自己添加到项目中去，这里我先用demo来测试的需要先建个工程，把文件添加到项目中去

打开demo.cs 初始化配置

AuthInfo authInfo = new AuthInfo("https://face.cn-north-1.myhuaweicloud.com", "ak", "sk");
//区域这里只有这两个地区开通了人脸识别接口，其他地方没有，只能在这两个里面选一个，注意填的时候只需要改cn-north-1就可以了，楼主第一次就把uri给覆盖了，导致初始化失败
//ak和sk是在华为云控制台的个人凭证中生成了秘钥，需要自己去手动新增
FrsClient frsClient = new FrsClient(authInfo, "项目ID"); //项目ID是和区域对应的

在添加common文件后会报个错，就是缺少json包，因为接口返回的数据格式是json的，
转：
c#添加json包
点击工具 - NuGet包管理器 - 程序包管理控制台，输入下面命令:
Install-Package Newtonsoft.Json
引用的 https://blog.csdn.net/u011720560/article/details/80402357

这些步骤昨晚就可以调试了，如果错误的话可以参照api文档的错误码说明，也可以访问 https://support.huaweicloud.com/api-face/face_02_0045.html，查看原因。
大部分是都是uri的问题，后续的操作后面再说明了

最后我想说的是 在网上基本搜不到华为云人脸识别SDK相关的，可能是因为我用的是C#的，而我又是做C++的，很少人用，资料有点少，最让人无语的是我头天给华为的人联系，说了问题但回复我的时候六点过了（五点半下班）就没细说，说第二天再说，然而第二天凌晨就更新了SDK文档，说之前有些地方不够完善，让我不得不佩服的是华为解决问题的速度，还是很快的

摘要：程序猿小Hi入职公司不到三个月，就被老板单独叫到了办公室……

初创公司R：刚刚创立，致力于通过信息化技术，帮助中小企业数字化转型，华丽转身。

公司成员：老板、程序猿小Hi、… …

程序猿小Hi入职公司不到三个月，就被老板单独叫到了办公室。小Hi心情既激动又不安，激动的是老板是不是要给自己升职加薪，不安的是不是自己表现不好，老板要炒鱿鱼，毕竟疫情是一个很好的借口。

来到了老板的办公室，不等小Hi说话，就单刀直入，说：小Hi啊，你来公司挺长时间了（还没到三个月，老板健忘？），你的工作做得挺好（心里开始爽歪歪），今天有个重要任务要交给你（凉了一半，升职加薪忘了吧）。

小Hi：好的，老板你有啥就直接吩咐，保证高效完成（心里开始有点忐忑）。

老板：昨天有个新客户，提了个需求，他们是在XX高新区，公司多切人员杂，在目前疫情情况下，想在门岗处增加门禁，识别外来人员，加强疫情管控。这是他们的需求文档，公司的其他人都出差了，这个任务就交给你了。记住，要做成模块化，方便后续客户应用。

小Hi：是，老板，我好好看看他们的需求文档。

……

小Hi离开老板办公室，打开需求文档一看，六个大字映入眼帘：我们要人脸识别（不对，是七个），心里翻滚着五味杂陈，“模块化”和“人脸识别”，这就是需求。

第一次接到了老板的任务，小Hi陷入了“深思”（吃鸡游戏中…）

第一个需求是“模块化”，模块化就是要求封装内部细节，精简对外交互，实现高内聚低耦合。小Hi第一时间就想到了通过提供API来保障自身的独立性，以及清晰化的对外交互界面，大学里学的那点API相关的知识开始在脑海里迸发：

API的定义：

应用程序接口（Application Programming Interface）是一组定义、程序及协议的集合，通过 API 接口实现计算机软件之间的相互通信。用来提供应用程序与开发人员基于某软件或硬件得以访问的一组例程，而又无需访问源码，或理解内部工作机制的细节。

常见的API类型有：

1）RESTful API：基于HTTP、URI和XML等的常见的Web服务接口标准，描述了一个架构样式的网络系统，其核心是面向资源的。

2）SOAP接口：简单对象访问协议，简单对象访问协议（SOAP）是一种轻量的、简单的、基于 XML 的协议，它被设计成在 WEB 上交换结构化的和固化的信息。

3）RPC接口：远程过程调用 (RPC) 是一种协议，程序可使用这种协议向网络中的另一台计算机上的程序请求服务。

4）RMI接口：远程方法调用RMI是针对于java语言的， RMI 允许您使用Java编写分布式对象。

API的设计原则，好API的6个特质：

1）极简：极简的API是指对外暴露的尽可能少，这样的API更易理解、记忆、调试和变更。

2）完备：完备的API是指用户期望有的功能都包含了，满足用户的需求，是完备的。

3）语义清晰简单：接口、参数、帮助等的语义清晰简单，使用常用语和缩略语，不适用生僻语，尽量减少意外。

4）符合直觉：经验不很丰富的用户不用阅读API文档就能搞懂API，而且程序员不用了解API就能看明白使用API的代码。

5）易于记忆：为使API易于记忆，API的命名约定应该具有一致性和精确性。使用易于识别的模式和概念，并且避免用缩写。

6）引导API使用者写出可读代码：代码只写一次，却要多次的阅读（还有调试和修改）。写出可读性好的代码有时候要花费更多的时间，但对于产品的整个生命周期来说是节省了时间的。

注：源自Qt的API设计原则，详见https://github.com/oldratlee/translations/blob/master/api-design-principles-from-qt/README.md

API相关概念

1）API网关：服务与服务之间通信的中介或桥梁，提供服务接入和鉴权、API注册、流控、管理等API托管服务。

2）API全生命周期管理：覆盖了API的设计、开发、测试、发布、订阅、使用和分析的端到端、全流程的管理。

第二个需求是“人脸识别”，小Hi没有AI相关技术积累，开始捉急，忽然灵光一闪，想起来前两天华为云专家过来交流，有提到华为云的AI能力，于是激动的打开了浏览器。

输入https://www.huaweicloud.com/，打开华为云，选择“开发者”=>“资源工具”下的API Explorer，查看华为云所有开放API：

在API Explorer上面，可以快速查看对应云服务的开放API：

在搜索框输入人脸识别，搜索相关的云服务：

打开人脸识别服务，有人脸比对、人脸检测、人脸搜索、人脸资源管理、人脸库资源管理等，挺多API的，太棒了。

迫不及待调试一把，登录华为云（没注册的赶紧注册下），选择到人脸识别控制台页面（https://console.huaweicloud.com/frs/?region=cn-north-1#/frs/home），开通人脸比对服务：

在API Explorer上选择人脸比对API（FaceCompareByFile），查看此API详细介绍信息，包括接口说明、请求参数、示例、返回参数、错误码等，此API支持对比两张人脸图片信息，判断是否同一个人的置信度：

我们直接可以选择要比对的图片，在API Explorer上点击调试按钮来在线调试这个API：

点击调试后，可以得到比对结果，相似度94.699%（代表同一个人的概率很大）：

再调试了多个API接口，查阅了人脸识别服务介绍后，小Hi心里有着落了，一张“蓝图”在脑海中绘制：

小Hi顿时信心爆棚起来，这下可以在老板面前好好表现下了。

你以为这就结束了吗？

图样图森破，小Hi还是太年轻，按以往经验，蓝图和落地至少还差个银河的距离，等待小Hi的是怎么快速实现这个公共服务，未完待续 ……

点击关注，第一时间了解华为云新鲜技术~