专为以下场景打造:ANDROID

Android Beauty AR SDK

使用 Android Beauty AR SDK 为相机处理流程添加美颜控制和富有表现力的人脸特效。处理纹理,同时保留应用自己的设计。

开发者资源

Android Beauty AR SDK 文档与示例

为创作者视频打造独特风格

让用户在 Android 相机中调节外观和滤镜。

让注意力集中在讲话者身上

使用合适的特效资源,在相机预览中提供背景模糊。

ANDROID BEAUTY AR 功能

构建应用所需的相机体验

纹理处理流程

  • 处理相机纹理
  • 返回处理后的纹理 ID

特效选择

  • 调节美颜参数
  • 加载授权特效素材

原生接入

  • Maven 包选择
  • GL 线程生命周期控制

探索 Android Beauty AR SDK

将 API 接入你的相机、控制项和特效素材。

纹理输入

为相机处理流程加入特效

在纹理处理回调中使用 Android Beauty AR SDK,保持帧尺寸与输入一致。

阅读文档
CameraProcessor.java
@Override
public int onCustomProcessTexture(
    int textureId, int width, int height) {
  return xmagicApi.process(textureId, width, height);
}

个性化定制

你的界面,你的风格。

让体验与你的应用保持一致。

让控制项融入原生体验

围绕 Android Beauty AR SDK 设计美颜控制项,并在不同主题间保持相同的特效设置。

阅读文档

开始使用

开始接入 Android Beauty AR SDK

  1. 01

    准备许可证

    使许可证与 应用标识符 匹配。

    打开 Beauty AR 控制台
  2. 02

    添加 Android Beauty AR SDK

    按照平台指南连接您的项目。

    按照集成指南操作
  3. 03

    处理第一帧画面

    为 Android Beauty AR SDK 完成认证、复制资源,并处理第一帧相机纹理。

    配置许可证
Android Beauty AR SDK
build.gradle
// Use your licensed package and a pinned release version.
implementation "com.tencent.mediacloud:TencentEffect_S1-04:${beautySdkVersion}"
LicenseSetup.java
// Authenticate before creating XmagicApi.
TELicenseCheck.getInstance().setTELicense(
    context, licenseURL, licenseKey,
    new TELicenseCheckListener() {
      @Override
      public void onLicenseCheckFinish(int code, String message) {
        if (code == TELicenseCheck.ERROR_OK) {
          // Initialize with your copied resource directory.
        }
      }
    });

Android Beauty AR SDK 常见问题

如何添加 Android Beauty AR SDK?

添加与许可证匹配的 Maven 包并固定版本。复制所需模型和特效资源,遵循文档中的 ABI 与 release 构建规则。

Android Beauty AR SDK 应面向哪些设备?

当前指南建议 Android 7.0 或更高版本,并列出 ARMv7 和 ARM64 支持。请在用户实际使用的设备上测试所选特效。

Android Beauty AR SDK 会替我采集相机帧吗?

Core SDK 接入处理的是应用提供的帧。官方示例包含相机组件,构建采集体验时可参考。

如何清理 Android Beauty AR SDK?

在 GL 上下文终止前,于 GL 线程调用 onDestroy。遵循文档中的暂停与恢复生命周期;在主线程销毁可能造成资源泄漏。

每个套餐都包含全部特效吗?

不包含。不同套餐的权益和所需素材文件不同。请选择所需授权特效,并在应用开放前核验对应资源。

如何通过 Kotlin 或 Java 接入 Android Beauty AR SDK?

按指南配置 Android 项目和 manifest,然后按需处理运行时权限及 Activity 清理。在真实设备上测试,包括应用后台与前台切换。

发布应用前如何测试 Android Beauty AR SDK?

测试许可证授权范围内的输入与特效处理,包括使用相机时的权限和退出预览后的清理。

如何定制 Android Beauty AR SDK 的界面?

将受支持特效连接到自有预览和选择器。素材、功能支持与许可证范围必须匹配目标平台。

Android Beauty AR 集成支持

让相机体验开始运行

使用 Android Beauty AR SDK 和适合应用的许可证开始构建。