人脸识别服务 FRS-Go SDK:开始使用
开始使用
在开始使用之前,请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以通过运行以下命令来检查并更新SDK至最新版本。
go list -m all | grep huaweicloud-sdk-go-v3go get -u github.com/huaweicloud/huaweicloud-sdk-go-v3
详细的SDK介绍请参见 SDK中心 、Go SDK使用指导、Go SDK使用视频。
- 导入依赖模块
import ("fmt" "os""github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" // 导入v2版本sdk frs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/frs/v2""github.com/huaweicloud/huaweicloud-sdk-go-v3/services/frs/v2/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/frs/v2/region")
- 配置认证信息
配置AK、SK信息。华为云通过AK识别用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK获取方法请参见准备工作。
func GetCredential(ak, sk string) basic.Credentials {// Init Auth Inforeturn basic.NewCredentialsBuilder().WithAk(ak).WithSk(sk).Build()}
初始化认证信息:
ak := os.Getenv("HUAWEICLOUD_SDK_AK")sk := os.Getenv("HUAWEICLOUD_SDK_SK")client := GetCredential(ak, sk)
- 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。
- 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
图3 Windows环境新建环境变量 - 初始化客户端
指定region方式
// # 初始化 人脸识别服务 的客户端,并选择服务部署区域func GetClient(auth basic.Credentials) *frs.FrsClient {client := frs.NewFrsClient(frs.FrsClientBuilder().WithRegion(region.ValueOf('cn-north-4')).WithCredential(auth).Build()) return client}
服务部署区域请参见终端节点。
- 发送请求并查看下响应
request := &model.DetectFaceByBase64Request{}request.Body = &model.FaceDetectBase64Req{ImageBase64: "/9j/4AAQSkZJRgABAQAAAQABAAD...",}response, err := client.DetectFaceByBase64(request)if err == nil { fmt.Printf("%+v\n", response)} else { fmt.Println(err)}
使用人脸比对SDK时,image1、image2参数需为相同类型,即同为url、base64或file。
- 异常处理
表1 异常处理 一级分类
一级分类说明
ServiceResponseError
服务响应异常
url.Error
url异常
// 捕获和处理不同类型的异常response, err := client.DetectFaceByBase64(request)if err == nil { fmt.Printf("%+v\n", response)} else { fmt.Println(err)}