短视频企业版迁移指引

最近更新时间:2022-05-12 10:59:23

目前,短视频企业版已经下线,其中美颜模块解耦升级成为腾讯特效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() {
         @Override
         public int onTextureCustomProcess(int textureId, int width, int height) {
                 if (isPause == 0 && mXMagic != null) {
                         return mXMagic.process(textureId, width, height);
                 }
                 return 0;
         }
    
         @Override
         public void onDetectFacePoints(float[] floats) {
         }
    
         @Override
         public 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 模块的依赖,编译项目将报错的代码注释掉即可。

目录