人脸核身 License 申请和配置，别再走弯路了

摘要：

License 是人脸核身 SDK 正常运行的必备文件，也是集成时最容易卡住的一环。本文讲清楚 License 是什么、各端怎么配置、常见问题怎么处理。

一、License 是什么

License 是 SDK 运行所需的授权文件。它由服务方签发，用于确认集成方具备使用 SDK 的权限。

SDK 不会自动携带 License，需要集成方主动申请。

二、怎么申请

在服务开通并通过审核后，联系服务方申请对应版本的 License 文件。

需要注意：

• 申请时需要提供正确的应用信息
• 不同平台需要的 License 形式可能不同
• 更换应用包名或签名后，可能需要重新申请

三、Android 端配置

将申请到的 License 文件放入 module 的 assets 目录。

启动核身前，在配置对象中设置 License 的文件名，名称需要与实际文件一致。配置示意：

AuthConfig authConfig = new AuthConfig();
// License 文件存放在 assets 目录下
authConfig.setAuthLicense("YTFaceSDK.license");
// 设置核身凭证，由业务服务端申请后下发
authConfig.setSdkToken(token);

四、iOS 端配置

将 License 文件加入工程的资源文件（Copy Bundle Resources）。

启动核身前，通过配置文件路径的方式指定 License 位置：

AuthConfig *config = [[AuthConfig alloc] init];
config.token = @"";
// 从 Bundle 中读取 License 路径
config.licencePath = [[NSBundle mainBundle] pathForResource:@"FaceSDK" ofType:@"license"];

五、Harmony 端配置

将申请到的授权文件放入 module 的 rawfile 目录，在配置对象中设置授权文件的名称。

启动核身前，通过配置文件路径的方式指定 License 位置：

let config = new AuthConfig();
config.token = "";
// 从 rawfile 目录读取 License 路径
config.licencePath = resourceManager.getRawFileContentSync("FaceSDK.license");

六、常见问题

七、几个注意点

• License 文件不要放在工程根目录，应按各端要求放入指定目录
• 不要在代码中硬编码 License 内容，使用文件方式引用
• 上线前在各个渠道都验证一遍，避免某个渠道漏配
• 妥善保管 License 文件，不要外传

腾讯云慧眼人脸核身提供各端的 License 申请与配置指引，配套集成文档中有详细说明。该系列产品正在限时特惠活动中，低至3.3折：https://cloud.tencent.com/act/pro/happynewyears