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 政策
隐私协议
数据处理和安全协议
联系我们
文档腾讯特效 SDK旧版文档一分钟集成 TRTCAndroid（3.3.0及以前）

Android（3.3.0及以前）

PDF
聚焦模式
字号
最后更新时间： 2024-07-05 12:35:43

步骤一：解压 Demo 工程

1. 下载集成了腾讯特效 TE 的 TRTC Demo 工程。本 Demo 基于腾讯特效 SDK S1-04 套餐构建。
2. 替换资源。由于本 Demo 工程使用的 SDK 套餐未必与您实际的套餐一致，因此要将本 Demo 中的相关 SDK 文件替换为您实际使用的套餐的 SDK 文件。具体操作如下：
删除 xmagic 模块中 libs 目录下的 .aar文件，将 SDK 中 libs 目录下的 .aar 文件拷贝进 xmagic 模块中 libs 目录下。
删除 xmagic 模块中 assets 目录下的所有文件，将 SDK 中的 assets/ 目录下的全部资源拷贝到 xmagic 模块../src/main/assets 目录下，如果 SDK 包中的 MotionRes 文件夹内有资源，将此文件夹也拷贝到 ../src/main/assets 目录下 。
删除 xmagic 模块中 jniLibs 目录下的所有.so文件，在 SDK 包内的 jniLibs 中找到对应的.so文件（由于 SDK 中 jinLibs 文件夹下的 arm64-v8a 和 armeabi-v7a 的.so文件在压缩包中，所以需要先解压），拷贝到 xmagic 模块中的 ../src/main/jniLibs 目录下。
3. 将 Demo ⼯程中的 xmagic 模块引⼊到实际项⽬⼯程中。

步骤二：打开 app 模块的 build.gradle

1. 将 applicationId 修改成与申请的测试授权⼀致的包名。
2. 添加 gson 依赖设置。
configurations{
 all*.exclude group:'com.google.code.gson'
}

步骤三：SDK 接口集成

可参考 Demo⼯程的 ThirdBeautyActivity 类。
1. 授权：
  //鉴权注意事项及错误码详情，请参考 https://www.tencentcloud.com/document/product/616/65891?from_cn_redirect=1#.E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E9.89.B4.E6.9D.83
XMagicImpl.checkAuth((errorCode, msg) -> {
             if (errorCode == TELicenseCheck.ERROR_OK) {
                 showLoadResourceView();
             } else {
                 TXCLog.e(TAG, "鉴权失败，请检查鉴权url和key" + errorCode + " " + msg);
             }
         });
2. 初始化素材：
private void showLoadResourceView() {
     if (XmagicLoadAssetsView.isCopyedRes) {
         XmagicResParser.parseRes(getApplicationContext());
         initXMagic();
     } else {
         loadAssetsView = new XmagicLoadAssetsView(this);
         loadAssetsView.setOnAssetsLoadFinishListener(() -> {
             XmagicResParser.parseRes(getApplicationContext());
             initXMagic();
         });
     }
 }
3. 开启推流设置：
mTRTCCloud.setLocalVideoProcessListener(TRTCCloudDef.TRTC_VIDEO_PIXEL_FORMAT_Texture_2D, TRTCCloudDef.TRTC_VIDEO_BUFFER_TYPE_TEXTURE, new TRTCCloudListener.TRTCVideoFrameListener() {
 @Override
 public void onGLContextCreated() {
 }
 @Override
 public int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCVideoFrame dstFrame) {
 }
 @Override
 public void onGLContextDestory() {
 }
});
4. 将 textureId 传入到 SDK 内做渲染处理： 在 TRTCVideoFrameListener 接口的 onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCVideoFrame dstFrame) 方法内添加如下代码： 
dstFrame.texture.textureId = mXMagic.process(srcFrame.texture.textureId, srcFrame.width, srcFrame.height);
process 方法以及美颜 SDK 的各 API 的详细说明见 API 文档。
5. 暂停/关闭 SDK： onPause() 用于暂停美颜效果，可以在 Activity/Fragment 生命周期方法中执行，onDestroy 方法需要在 GL 线程调用（可以在 onTextureDestroyed 方法中调用 XMagicImpl 对象的 onDestroy()） ，更多使用请参考 Demo。
mXMagic.onPause();   //暂停，与Activity的onPause方法绑定
mXMagic.onDestroy();  //销毁，需要在GL线程中调用
6. 布局中添加 SDK 美颜面板：
 <RelativeLayout
     android:layout_above="@+id/ll_edit_info"
     android:id="@+id/livepusher_bp_beauty_pannel"
     android:layout_width="match_parent"
     android:layout_height="wrap_content" />
7. 初始化面板：
   private void initXMagic() {
       if (mXMagic == null) {
           mXMagic = new XMagicImpl(this, mBeautyPanelView);
       }else {
           mXMagic.onResume();
       }
   }
具体操作请参见 Demo ⼯程的 ThirdBeautyActivity.initXMagic();⽅法。
上一篇: iOS（3.3.0及以前）下一篇: iOS（3.3.0及以前）

帮助和支持

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

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

文档反馈