tencent cloud

腾讯特效 SDK

文档腾讯特效 SDKSDK 集成指引（含 UI）TRTC SDK 集成腾讯特效Android

Android

Download
聚焦模式
字号
最后更新时间： 2026-05-15 16:13:51

SDK 集成

1. 集成腾讯特效
集成 SDK
集成素材
2. 集成 TEBeautyKit
添加 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 文件

添加美颜面板对应的 JSON 文件，详细请参考 TEBeautyKit 的集成和使用。
注意：
如果您不使用提供的美颜面板，请忽略这步操作。

第二步：鉴权和资源复制

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，美颜属性调用 TEBeautyKit 的 setEffect 设置美颜属性。

第四步：绑定美颜

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()
上一篇: iOS下一篇: Flutter

帮助和支持

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

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

文档反馈