授权认证

SDK 支持两种授权方式，创建引擎时二选一即可：

方式	配置字段	适用场景
在线授权	appId + appKey	设备可访问网络
离线 License	licenseJson	无网 / 弱网、内网部署

优先级：若提供了 licenseJson，将优先走本地校验，不再请求网络，也无需再配 appId / appKey。

TIP

接入前请先完成 订阅服务：绑定平台应用标识（Bundle ID / 包名等），并开通对应订阅。

在线授权

在控制台复制 AppID / AppKey，创建引擎时传入即可。各平台示例见对应「快速开始」文档。

离线 License

下载

1. 登录 控制台
2. 选择项目，在 AppID & AppKey 卡片中点击 下载 离线 License
3. 得到文件：facebetter-offline-license.json

有效期与当前订阅的 expires_at 一致；订阅续期或变更套餐后，请重新下载。

接入

将文件内容（整段 JSON 字符串）赋给配置中的 licenseJson。全端共用同一套校验逻辑。

iOS / macOS

FBEngineConfig *config = [[FBEngineConfig alloc] init];
config.licenseJson = @"/* 文件全文 */";
self.beautyEffectEngine = [FBBeautyEffectEngine createEngineWithConfig:config];

Android

BeautyEffectEngine.EngineConfig config = new BeautyEffectEngine.EngineConfig();
config.licenseJson = "/* 文件全文 */";
mBeautyEngine = new BeautyEffectEngine(this, config);

Web

const config = new EngineConfig({
  licenseJson: '/* 文件全文 */',
});

Flutter

await FBBeautyEffectEngine.init(
  FBEngineConfig(licenseJson: '/* 文件全文 */'),
);

也可把 JSON 放进应用资源，启动时读入字符串再赋值，不必硬编码在源码里。

行为说明

• 签名校验、平台列表、platform_identifiers（包名等）与在线授权一致；标识不匹配会失败。
• 未过期：按 License 中的 plan 开通能力。
• 已过期：鉴权仍成功，但能力降为 free；请续订后重新下载。
• 请使用支持离线 License 的 SDK 版本（含 expires_at 校验）。