目前，短视频企业版已经下线，其中美颜模块解耦升级成为腾讯特效 SDK。腾讯特效 SDK 美颜效果更加自然，产品功能更加强大，集成方式更加灵活。本文是短视频企业版升级为腾讯特效（美颜特效）的迁移指引。
注意事项
1. 修改 xmagic 模块中的 glide 库的版本号，与实际使用保持一致。
2. 修改 xmagic 模块中的最低版本号，与实际使用保持一致。
集成步骤
步骤一：解压 Demo 工程
1. 下载集成了腾讯特效 TE 的 UGSV 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 模块引⼊到实际项⽬⼯程中。
步骤二：SDK 版本升级
将 SDK 从 Enterprise 版本升级为 Professional 版本。
替换前：
implementation 'com.tencent.liteav:LiteAVSDK_Enterprise:latest.release'替换后：
implementation 'com.tencent.liteav:LiteAVSDK_Professional:latest.release'步骤三：设置美颜 License
1. 在项目中的 application 的 oncreate 方法中调用如下方法：
XMagicImpl.init(this);XMagicImpl.checkAuth(null);
2. 在 XMagicImpl 类中替换成您申请的腾讯特效 License URL 和 Key。
步骤四：代码实现
以小视频录制界面（TCVideoRecordActivity.java）为例。
1. 在
TCVideoRecordActivity.java类中添加如下变量代码。private XMagicImpl mXMagic;private int isPause = 0;//0 非暂停，1暂停，2暂停中 3.表示要销毁
2. 在
TCVideoRecordActivity.java类 onCreate 方法后边添加如下代码。TXUGCRecord instance = TXUGCRecord.getInstance(this);instance.setVideoProcessListener(new TXUGCRecord.VideoCustomProcessListener() {@Overridepublic int onTextureCustomProcess(int textureId, int width, int height) {if (isPause == 0 && mXMagic != null) {return mXMagic.process(textureId, width, height);}return 0;}@Overridepublic void onDetectFacePoints(float[] floats) {}@Overridepublic void onTextureDestroyed() {if (Looper.getMainLooper() != Looper.myLooper()) { //非主线程if (isPause == 1) {isPause = 2;if (mXMagic != null) {mXMagic.onDestroy();}initXMagic();isPause = 0;} else if (isPause == 3) {if (mXMagic != null) {mXMagic.onDestroy();}}}}});XMagicImpl.checkAuth((errorCode, msg) -> {if (errorCode == TELicenseCheck.ERROR_OK) {loadXmagicRes();} else {TXCLog.e("TAG", "鉴权失败，请检查鉴权url和key" + errorCode + " " + msg);}});
3. 在 onStop 方法中添加如下代码：
isPause = 1;if (mXMagic != null) {mXMagic.onPause();}
4. 在 onDestroy 方法中添加如下代码：
isPause = 3;XmagicPanelDataManager.getInstance().clearData();
5. 在 onActivityResult 方法最前边添加如下代码：
if (mXMagic != null) {mXMagic.onActivityResult(requestCode, resultCode, data);}
6. 在此类的最后添加如下两个方法：
private void loadXmagicRes() {if (XMagicImpl.isLoadedRes) {XmagicResParser.parseRes(getApplicationContext());initXMagic();return;}new Thread(() -> {XmagicResParser.setResPath(new File(getFilesDir(), "xmagic").getAbsolutePath());XmagicResParser.copyRes(getApplicationContext());XmagicResParser.parseRes(getApplicationContext());XMagicImpl.isLoadedRes = true;new Handler(Looper.getMainLooper()).post(() -> {initXMagic();});}).start();}/*** 初始化美颜SDK*/private void initXMagic() {if (mXMagic == null) {mXMagic = new XMagicImpl(this, mUGCKitVideoRecord.getBeautyPanel());}else {mXMagic.onResume();}}
步骤五：对其他类的修改
1. 将 AbsVideoRecordUI 类的 mBeautyPanel 类型修改为 RelativeLayout 类型，getBeautyPanel() 方法返回类型也修改为 RelativeLayout，同时修改对应 XML 中的配置，注掉报错的代码。
2. 注释掉 UGCKitVideoRecord 类中报错的代码。
3. 修改 ScrollFilterView 类中的代码，删除 mBeautyPanel 变量，注释掉报错的代码。
步骤六：删除对 beautysettingkit 模块的依赖
在 ugckit 模块的 build.gradle 文件中删除对 beautysettingkit 模块的依赖，编译项目将报错的代码注释掉即可。
