对接OCR识别图片中文字

前提条件

• 已申请身份证识别服务，具体操作请参见开通文字识别服务。
  图1 已申请身份证识别服务
  
• 已获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对，具体操作请参见获取AK/SK。
• 已将身份证照片上传到华为云的OBS存储桶，并获取到图片的URL，具体操作请参见如何上传文件。
• 已将身份证图片转换为base64编码，具体操作请参见如何获取图片base64编码。

新建OCR连接器

1. 参考登录AstroZero新版应用设计器中操作，进入应用设计器。
2. 在左侧导航栏中，选择“集成”。
3. 单击“连接器”中的“ 连接器实例”，进入连接器实例页面。
4. 在左侧导航栏中，选择“AI > OCR”。
5. 在右侧页面单击“+”，设置OCR对接信息。
   图2 创建OCR
   

   表1 创建OCR连接器参数说明

   参数	说明
   名称	新建连接器的名称。命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 说明： 名称前的内容为命名空间，在AstroZero中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。
   区域	OCR服务的区域。
   访问密钥ID	访问密钥ID，与私有访问密钥关联的唯一标识符，访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。配置为前提条件中的“AK”的值。
   访问密钥	私有访问密钥，与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被篡改。请与前提条件中的“SK”的值。
   打包当前配置	选中该选项后，应用打包时会将当前配置的连接器信息一并打出。例如，如果应用包发布到运行环境，当前配置默认会被同步到运行环境中。如果不勾选，则内容不会打包发布到运行环境，此时需要您参考管理应用中的连接器中操作，创建对应的连接器。 默认为选中，对信息敏感的场景，建议不勾选。

6. 设置完成后，单击“保存”。
7. （可选）测试是否能识别身份证照片。
   1. 在连接器详情页面，单击“测试”。
   2. “选择类型”配置为“图片URL”或“图片文件”，输入图片URL或选择身份证图片，单击“测试”。
      图3 配置身份证
      

      提示如下信息，表明成功识别身份证信息。

      图4 测试成功
      

在脚本中调用连接器

在脚本中，调用连接器实现与OCR的对接。

1. 参考创建空白AstroZero脚本中操作，创建一个空白脚本。
2. 在脚本编辑器中，输入如下代码。
   通过脚本中的如下代码，可基于已上传身份证的URL，调用OCR接口进行识别，并输出识别的基本信息。

   //导入该事件所依赖的标准库文件。ocr是系统预置的标准库。
   import * as ocr from 'ocr';
    
   let cli = ocr.newClient("OCR_Test");
   try {
       let url = "https://obs-example.com:443/1.PNG?AccessKeyId=ZK87UUIONJF5ZHWBINUO&Expires=1556001233&Signature=DOwO6djb4Q3EBvCieQFaO3T2GKU%3D&x-obs-security-token=gQpjbi1ub3J0aC0xipYOeC2mcbefHh5I_aMr6DEWQ8-iFyxqatavdiFtYowH-lpJCcxeTynsV_4PTJe9QIx85mlDIDo3sU9PUv3hFtRjQORjGE2PqA4hEtozvMuWxXb5b6RKiFT37-z7NoI4R85XmlTmZGQ6OUZ92bercG5DWEBTDVd3I_UYuNGzF20q6S2COP__Z-uqkhhw8nATd3k6GaIfCqxjcOih_juHBBoM1ON74vpKxCl1sJxnEYbZfkf6FO_xuGaJD7-J7OzD8tsSmFf4jR1TqZF******vQPpSZe6cYyplNuJoY05VLd8tLZMy_bR8Dmf1kArQaSquBzw2eDCfJAazjA4wTnkbccr38k7eM%3D"
       let resp = cli.idCardWithURL(url, "front");
       console.log(resp);
   } catch (e) {
       console.log("error: ", e)
   }

   其中，ocr.newClient("OCR_Test")中，“OCR_Test”为连接器的名称，“url”取值是图片的URL， “front”表示识别的是身份证正面。

3. 单击脚本编辑器页面上方的，保存脚本。
4. 保存成功后，单击，运行脚本。
5. 不用设置输入参数，直接单击测试窗口右上角的。
6. 在输出参数页签，检查是否识别出身份证上文字信息。

   识别出身份证上的文字信息，表明成功调用连接器。

7. 单击脚本编辑器页面上方的，启用脚本。

在服务编排中调用连接器

在服务编排中，调用连接器实现与OCR的对接。

1. 参考创建空白AstroZero服务编排中操作，创建一个空白服务编排。
2. 在服务编排设计页面，从左侧“连接器 > AI”中，拖拽“OCR”图元至画布中。

   OCR是系统预置的，与OCR对接的接口。

   图5 拖拽OCR图元到画布中
   

3. 选中组件，单击，设置OCR对接信息。
   图6 设置基本信息
   

   表2 OCR图元基本信息参数说明

   参数	说明
   标签	图元在页面显示的名称。
   名称	图元在系统中的唯一标识，不能和其他图元相同。命名要求如下： 长度不能超过80个字符。 必须以英文字母开头，只能由英文字母，数字或下划线组成，且不能以下划线结尾。
   描述	根据实际需求，输入连接器的描述信息。
   连接器	在下拉框中，选择连接器的名称，即新建OCR连接器中创建连接器的名称。

4. 单击，设置动作参数。
   图7 设置动作参数
   

   表3 OCR图元动作参数说明

   参数	说明
   动作	系统提供了如下两个动作，按需进行选择。 id_card_with_url：根据图片的URL路径，识别身份证。目前仅支持华为云上，OBS提供的临时授权或匿名公开授权访问的URL。 id_card_with_image：根据base64编码后的图像数据，识别身份证。要求base64编码后大小不超过10MB，图像各边的像素大小在15到8000之间，图片格式为JPG、PNG、BMP或TIFF。
   输入参数	当动作为“id_card_with_url”时，输入参数说明如下： “目标”取值为“url”时：请在“源”中，配置图片的URL路径，目前仅支持华为云上OBS提供的临时授权或者匿名公开授权访问的URL。 “目标”取值为“side”时：请在“源”中，配置身份证正面还是反面，“源”配置为“front”，表示为身份证正面；配置为“back”，表示为身份证背面。 当动作为“id_card_with_image”时，输入参数说明如下： “目标”取值为“image”时：请在“源”中，配置base64编码后的图像数据。要求base64编码后大小不超过10MB，图像各边的像素大小在15到8000之间，图片格式为JPG、PNG、BMP或TIFF。 “目标”取值为“side”时：请在“源”中，配置身份证正面还是反面；“源”配置为“front”，表示为身份证正面，配置为“back”，表示为身份证背面。
   输出参数	源”设置为“result”，“目标”用于调用成功时的调用结果。必须定义一个如下表所示的结构变量，来进行接收。result结构体成员变量说明，如表4所示。 如何在服务编排中创建变量，请参见创建空白AstroZero服务编排。 “源”设置为“error”，“目标”用于调用失败时的错误码。

   表4 result结构体成员变量说明

   名称	类型	说明
   name	String	姓名。
   gender	String	性别。
   birth	String	出生日期。
   ethnicity	String	民族。
   address	String	地址。
   number	String	身份证号。
   issue	String	发证机关。
   valid_from	String	有效起始日期。
   valid_to	String	有效结束日期。

5. 连接开始图元和OCR图元。
   图8 连接图元
   

6. 单击页面上方的，保存服务编排。
7. 保存成功后，单击，运行服务编排。

   若输出身份证识别信息，表示成功调用连接器。

8. 单击页面上方的，启用服务编排。