tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Tencent Effect SDK
    Documentation
    Download PDF

    Android(V3.3.0 and prior)

    Last updated: 2024-02-02 17:59:50
    Download PDF

      Step 1. Replace resources

      1. Download the MLVB demo which has integrated the Tencent Effect SDK. This demo is built based on the Tencent Effect SDK S1-04 edition.
      2. Replace resources. As the SDK edition used by the demo project may be different from the SDK edition you actually use, you need to replace the different SDK files in the demo with the files in the SDK edition you actually use as follows:
      Replace the .aar file in the libs directory of the Xmagic module with the .aar file in libs of your SDK.
      Replace all the files in ../src/main/assets of the Xmagic module with those in assets/ of your SDK. If there are files in the MotionRes folder of your SDK package, also copy them to the ../src/main/assets directory.
      Replace all the .so files in ../src/main/jniLibs of the Xmagic module with the .so files in jniLibs of your SDK package (you need to decompress the ZIP files in the jinLibs folder to get the .so files for arm64-v8a and armeabi-v7a).
      3. Import the Xmagic module from the demo into your actual project.

      Step 2. Open build.gradle in app and do the following:

      1. Replace the applicationId with the package name under the obtained trial license.
      2. Add Gson dependency settings.
      configurations  {
      all*.exclude  group:  'com.google.code.gson'
      }

      Step 3. Integrate the SDK APIs

      You can refer to the ThirdBeautyActivity class of the demo.
      1. Authorize:
       // For details about authentication and error codes, see 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, "Authentication failed. Check the authentication URL and key" + errorCode + " " + msg);
               }
           });
      2. Initialize the material:
      private void showLoadResourceView() {
           if (XmagicLoadAssetsView.isCopyedRes) {
               XmagicResParser.parseRes(getApplicationContext());
               initXMagic();
           } else {
               XmagicLoadAssetsView loadAssetsView = new XmagicLoadAssetsView(this);
               loadAssetsView.setOnAssetsLoadFinishListener(() -> {
                   XmagicResParser.parseRes(getApplicationContext());
                   initXMagic();
               });
           }
       }
      3. Enable publishing settings:
      String userId = String.valueOf(new Random().nextInt(10000));
      String pushUrl = AddressUtils.generatePushUrl(streamId, userId, 0);
      mLivePusher = new V2TXLivePusherImpl(this, V2TXLiveDef.V2TXLiveMode.TXLiveMode_RTC);
      mLivePusher.enableCustomVideoProcess(true, V2TXLivePixelFormatTexture2D, V2TXLiveBufferTypeTexture);
      mLivePusher.setObserver(new V2TXLivePusherObserver() {
       @Override
       public void onGLContextCreated() {
       }
      
       @Override
       public int onProcessVideoFrame(V2TXLiveDef.V2TXLiveVideoFrame srcFrame, V2TXLiveDef.V2TXLiveVideoFrame dstFrame) {
           if (mXMagic != null) {
               dstFrame.texture.textureId = mXMagic.process(srcFrame.texture.textureId, srcFrame.width, srcFrame.height);
           }
           return srcFrame.texture.textureId;
           }
      
           @Override
           public void onGLContextDestroyed() {
           if (mXMagic != null) {
               mXMagic.onDestroy();
           }
       }
      });
      mLivePusher.setRenderView(mPushRenderView);
      mLivePusher.startCamera(true);
      int ret = mLivePusher.startPush(pushUrl);
      mLivePusher.startMicrophone();
      4. Pass textureId to the SDK for rendering:
      In the onProcessVideoFrame(V2TXLiveDef.V2TXLiveVideoFrame srcFrame, V2TXLiveDef.V2TXLiveVideoFrame dstFrame) method of the V2TXLivePusherObserver API, add the following code:
      if (mXMagic != null) {
       dstFrame.texture.textureId = mXMagic.process(srcFrame.texture.textureId, srcFrame.width,srcFrame.height);
      }
      return srcFrame.texture.textureId;
      5. Pause/Terminate the SDK:
      onPause() is used to pause the beauty filter effect, which can be executed in the Activity/Fragment lifecycle method. The onDestroy method needs to be called in the GL thread (the onDestroy() of the XMagicImpl object can be called in the onTextureDestroyed method). For more information, see the demo.
      mXMagic.onPause();   // Pause, which is bound to the `onPause` method of `Activity`
      mXMagic.onDestroy();  // // Terminate, which needs to be called in the GL thread
      6. Add the SDK beauty filter panel to the layout:
       <RelativeLayout
           android:id="@+id/livepusher_bp_beauty_pannel"
           android:layout_width="match_parent"
           android:layout_height="wrap_content"
           android:layout_above="@+id/ll_edit_info" />
      7. Initialize the panel:
        private void initXMagic() {
             if (mXMagic == null) {
                 mXMagic = new XMagicImpl(this, mBeautyPanelView);
             }else{
                 mXMagic.onResume();
             }
         }
      See the ThirdBeautyActivity.initXMagic(); method of the demo for details.
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy