tencent cloud

腾讯特效 SDK

动态与公告
产品动态
关于腾讯特效 SDK V3.5 版本更新公告
关于腾讯特效 SDK V3.0 版本相关接口及素材变更公告
产品简介
产品概述
产品功能
基本概念
产品优势
应用场景
购买指南
价格总览
购买流程
欠费退费说明
新手指引
Demo 体验
免费测试
License 指引
移动端 License 新增与续期
PC 端 License 新增与续期
Web端 License 新增与续期
常见问题
SDK 下载
功能说明
SDK 下载
版本历史
SDK 集成指引(无 UI)
通用集成腾讯特效
原子能力集成指引
SDK 集成指引(含 UI)
通用集成腾讯特效
直播 SDK 集成腾讯特效
TRTC SDK 集成腾讯特效
短视频 SDK 集成腾讯特效
Avatar 虚拟人集成指引
API 文档
iOS
Android
Flutter
Web
功能实践
SDK 包瘦身
SDK 集成问题排查
性能调优
效果调优
素材使用
美颜参数说明
美颜场景推荐参数
短视频企业版迁移指引
第三方推流接入美颜(Flutter)
小程序美颜特效实践
素材制作工具使用
Web 美颜特效
产品概述
快速上手
SDK 接入
API 文档
控制台指南
Demo 体验
内置素材总览
实践教程
常见问题
常见问题
通用类相关
技术类相关
License 相关
旧版文档
美颜场景推荐参数
美颜参数表
一分钟集成 TRTC
一分钟集成直播
TE SDK 政策
隐私协议
数据处理和安全协议
联系我们

Android

PDF
聚焦模式
字号
最后更新时间: 2025-06-05 10:51:02

SDK 集成

1. 集成腾讯特效
集成SDK
2. 集成TEBeautyKit
添加面板JSON文件(如果不使用默认面板可以不添加)
3. 集成te_adapter_trtc
Maven依赖
aar依赖
在 dependencies 中添加 te_adapter_trtc库的依赖
dependencies{
...
implementation 'com.tencent.mediacloud:te_adapter_trtc:版本号'
}
下载 aar 文件(下载的是一个 zip 文件,解压即可得到 aar 文件)。
添加下载的 te_adapter_trtc_xxxx.aar 文件到 app 工程 libs 目录下。
打开 app 模块的 build.gradle 添加依赖引用:
dependencies{
...
implementation fileTree(dir: 'libs', include: ['*.jar','*.aar']) //添加 *.aar
}
Demo 工程请参考 TRTC Demo工程。
注意:
运行代码需要在com.tencent.thirdbeauty.xmagic.LicenseConstant.java文件中添加您申请的License信息,并将App module 下的build.gradle中的applicationId 修改为您申请License时填写的包名。
由于依赖TRTC能力,所以需要在Debug module下找到 com.tencent.trtc.debug.GenerateTestUserSig.java文件,并添加对应的APPID,SDKAPPID,SECRETKEY
美颜集成的主要代码参考:com.tencent.trtc.thirdbeauty.ThirdBeautyActivity.java文件。

SDK 使用

第一步:设置面板 JSON 文件

请添加您在 TEBeautyKit 集成中的第三步中添加到您工程中的 JSON 文件的路径,没有的 JSON 文件则将路径设置为 null。
TEPanelViewResModel resModel = new TEPanelViewResModel();
String combo = "S1_07"; //根据您的套餐进行设置,如果您的套餐没有包含某项功能,客户设置为null
resModel.beauty = "beauty_panel/"+combo+"/beauty.json";
resModel.lut = "beauty_panel/"+combo+"/lut.json";
resModel.beautyBody = "beauty_panel/"+combo+"/beauty_body.json";
resModel.motion = "beauty_panel/"+combo+"/motions.json";
resModel.lightMakeup = "beauty_panel/"+combo+"/light_makeup.json";
resModel.segmentation = "beauty_panel/"+combo+"/segmentation.json";
TEUIConfig.getInstance().setTEPanelViewRes(resModel);
注意:如果您不使用提供的美颜面板,请忽略这步操作。

第二步:鉴权和资源复制

TEBeautyKit.setupSDK(this.getApplicationContext(),LicenseConstant.mXMagicLicenceUrl,LicenseConstant.mXMagicKey, (i, s) -> { if (i == LicenseConstant.AUTH_STATE_SUCCEED) {
runOnUiThread(() -> { Intent intent = new Intent(MainActivity.this, ThirdBeautyActivity.class); startActivity(intent);
}
} else {
Log.e(TAG, "te license check is failed,please checke ");
}
});
注意:
资源复制是根据 SDK 的版本号进行的,所以同一个版本号的 SDK 只会成功复制一次资源。

第三步:初始化 adapter 和添加面板

this.beautyAdapter = new TEBeautyTRTCAdapter(XmagicConstant.EffectMode.PRO, TEBeautyKit.getResPath());
//设置手机朝向 this.beautyAdapter.notifyScreenOrientationChanged(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
//设置相机是前置摄像头还是后置摄像头,以及是否编码镜像 this.beautyAdapter.notifyCameraChanged(isFront, this.isEncoderMirror);
//初始化面板代码
private void initBeautyPanelView() { RelativeLayout panelLayout = findViewById(R.id.live_pusher_bp_beauty_panel); this.tePanelView = new TEPanelView(this); if (lastParamList != null) { //用于恢复美颜上次效果 this.tePanelView.setLastParamList(lastParamList); } this.tePanelView.showView(this); panelLayout.addView(this.tePanelView); }
注意:如果您不使用提供的面板,可以不创建TEPanelView,美颜属性调用TEBeautyKitsetEffect 设置美颜属性。

第四步:绑定美颜

V3.9.0之后
V3.9.0及之前
this.beautyAdapter.bind(this, this.mTRTCCloud, new ITEBeautyAdapter.CallBack() {
@Override
public void onCreatedTEBeautyApi(XmagicApi xmagicApi) {
Log.e(TAG, "onCreatedTEBeautyApi ");
mBeautyKit = new TEBeautyKit(xmagicApi);
mPanelView.setupWithTEBeautyKit(mBeautyKit);
setTipListener(mBeautyKit);
setLastParam(mBeautyKit);
}

@Override
public void onDestroyTEBeautyApi() {
Log.e(TAG, "onDestroyTEBeautyApi ");
mBeautyKit = null;
}
});
this.beautyAdapter.bind(this, this.mTRTCCloud, new ITEBeautyAdapter.CallBack() {
@Override
public void onCreatedTEBeautyKit(TEBeautyKit beautyKit) {
mBeautyKit = beautyKit;
//将mBeautyKit和美颜面板进行绑定
tePanelView.setupWithTEBeautyKit(mBeautyKit);
setTipListener(mBeautyKit);
setLastParam(mBeautyKit);
Log.e("beautyLiveAdapter", "onCreatedTEBeautyKit");
}

@Override
public void onDestroyTEBeautyKit() {
mBeautyKit = null;
Log.e("beautyLiveAdapter", "onDestroyTEBeautyKit");
}
});

第五步:参数变化通知 adapter

//当相机或画面镜像变化时需要调用notifyCameraChanged告诉adapter 最新的状态 this.beautyAdapter.notifyCameraChanged(isFront, this.isEncoderMirror);
//当屏幕方向变化的时候 需要调用 notifyScreenOrientationChange方法
this.beautyAdapter.notifyScreenOrientationChanged(orientation);


第六步:销毁美颜

//当不再需要美颜时可以调用unbind方法解除绑定关系 this.beautyAdapter.unbind();

第七步:恢复声音

/** * 用于恢复贴纸中的声音 * 恢复陀螺仪传感器,一般在Activity的onResume方法中调用 */ this.mBeautyKit.onResume()

第八步:暂停声音

/** * 用于暂停贴纸中的声音 * 暂停陀螺仪传感器,一般在Activity的onPause方法中调用 */ this.mBeautyKit.onPause()

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈