专为以下场景打造:ANDROID
Android Beauty AR SDK
使用 Android Beauty AR SDK 为相机处理流程添加美颜控制和富有表现力的人脸特效。处理纹理,同时保留应用自己的设计。
开发者资源
Android Beauty AR SDK 文档与示例
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。
阅读文档BeautyControls.java
xmagicApi.setEffect(
XmagicConstant.EffectName.BEAUTY_WHITEN,
50,
null,
null
);特效素材
通过统一界面切换特效
将兼容的资源路径传入 Android Beauty AR SDK,并围绕它构建特效选择器。
阅读文档EffectAssets.java
// Select an asset from your licensed resource directory.
xmagicApi.setEffect(
effectName, effectValue, resourcePath, extraInfo
);开始使用
开始接入 Android Beauty AR SDK
- 01
- 02
- 03
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 的界面?
将受支持特效连接到自有预览和选择器。素材、功能支持与许可证范围必须匹配目标平台。

