tencent cloud

文档反馈

短视频企业版迁移指引

最后更新时间:2022-07-18 10:06:18

    目前,短视频企业版已经下线,其中美颜模块解耦升级成为腾讯特效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 = <span class="hljs-keyword">new</span> XMagicImpl(<span class="hljs-keyword">this</span>, mUGCKitVideoRecord.getBeautyPanel());
      
      }else {
          mXMagic.onResume();
      
      }
      }

    步骤五:对其他类的修改

    1. 将 AbsVideoRecordUI 类的 mBeautyPanel 类型修改为 RelativeLayout 类型,getBeautyPanel() 方法返回类型也修改为 RelativeLayout,同时修改对应 XML 中的配置,注掉报错的代码。
    2. 注释掉 UGCKitVideoRecord 类中报错的代码。
    3. 修改 ScrollFilterView 类中的代码,删除 mBeautyPanel 变量,注释掉报错的代码。

    步骤六:删除对 beautysettingkit 模块的依赖

    在 ugckit 模块的 build.gradle 文件中删除对 beautysettingkit 模块的依赖,编译项目将报错的代码注释掉即可。

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持