tencent cloud

User Generated Short Video SDK

ドキュメントUser Generated Short Video SDKUI 統合ソリューションを含まないTencent Effect SDKSDK Integration GuideAndroid

Android

PDF
フォーカスモード
フォントサイズ
最終更新日: 2022-11-14 18:18:58

Step 1. Replace resources

1. Download the UGSV demo which has been integrated with 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:
In the build.gradle file of the xmagickit module, find the following:
api 'com.tencent.mediacloud:TencentEffect_S1-04:latest.release'
Replace it with the SDK edition you purchased as described in Integrating the Tencent Effect SDK (Android).
If your edition contains animated effects and filters, you need to download the corresponding resources on the Tencent Effect SDK download page and put them in the following directories of the xmagickit module respectively:
Animated effects: ../assets/MotionRes.
Filters: ../assets/lut.
3. Import the xmagickit module from the demo into your actual project.

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

Replace the applicationId with the package name under the obtained trial license.

Step 3. Integrate the SDK APIs

You can refer to the UGCKitVideoRecord class of the demo.
1. Authorize:
 // For details about authentication and error codes, see https://www.tencentcloud.com/document/product/1143/45385#.E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E9.89.B4.E6.9D.83
 XMagicImpl.checkAuth(new TELicenseCheck.TELicenseCheckListener() {
         @Override
         public void onLicenseCheckFinish(int errorCode, String msg) {
             if (errorCode == TELicenseCheck.ERROR_OK) {
                 loadXmagicRes();
             } else {
                 Log.e("TAG", "auth fail, please check auth url and key" + errorCode + " " + msg);
             }
         }
     });
2. Initialize the material:
 private void loadXmagicRes() {
     if (XMagicImpl.isLoadedRes) {
         XmagicResParser.parseRes(mActivity.getApplicationContext());
         initXMagic();
         return;
     }
     new Thread(new Runnable() {
         @Override
         public void run() {
             XmagicResParser.copyRes(mActivity.getApplicationContext());
             XmagicResParser.parseRes(mActivity.getApplicationContext());
             XMagicImpl.isLoadedRes = true;
             new Handler(Looper.getMainLooper()).post(new Runnable() {
                 @Override
                 public void run() {
                     initXMagic();
                 }
             });
         }
     }).start();
 }
3. Bind beauty filters to UGSV:
 private void initBeauty() {
     TXUGCRecord instance = TXUGCRecord.getInstance(UGCKit.getAppContext());
     instance.setVideoProcessListener(new TXUGCRecord.VideoCustomProcessListener() {
         @Override
         public int onTextureCustomProcess(int textureId, int width, int height) {
             if (xmagicState == XMagicImpl.XmagicState.STARTED && mXMagic != null) {
                 return mXMagic.process(textureId, width, height);
             }
             return textureId;
         }

         @Override
         public void onDetectFacePoints(float[] floats) {
         }

         @Override
         public void onTextureDestroyed() {
             if (Looper.getMainLooper() != Looper.myLooper()) {  // Not the main thread
                 boolean stopped = xmagicState == XMagicImpl.XmagicState.STOPPED;
                 if (stopped || xmagicState == XMagicImpl.XmagicState.DESTROYED) {
                     if (mXMagic != null) {
                         mXMagic.onDestroy();
                     }
                 }
                 if (xmagicState == XMagicImpl.XmagicState.DESTROYED) {
                     TXUGCRecord.getInstance(UGCKit.getAppContext()).setVideoProcessListener(null);
                 }
             }
         }
     });
 }
4. 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 onTextureDestroyed method in the sample code.
         @Override
         public void onTextureDestroyed() {
             if (Looper.getMainLooper() != Looper.myLooper()) {  // Not the main thread
                 boolean stopped = xmagicState == XMagicImpl.XmagicState.STOPPED;
                 if (stopped || xmagicState == XMagicImpl.XmagicState.DESTROYED) {
                     if (mXMagic != null) {
                         mXMagic.onDestroy();
                     }
                 }
                 if (xmagicState == XMagicImpl.XmagicState.DESTROYED) {
                     TXUGCRecord.getInstance(UGCKit.getAppContext()).setVideoProcessListener(null);
                 }
             }
         }
5. Add the beauty filter panel to the layout:
 <RelativeLayout
     android:id="@+id/panel_layout"
     android:layout_width="match_parent"
     android:layout_height="wrap_content"
     android:layout_alignParentBottom="true"
     android:visibility="gone"/>
6. Create a beauty filter object and add the beauty filter panel.
private void initXMagic() {
    if (mXMagic == null) {
        mXMagic = new XMagicImpl(mActivity, getBeautyPanel());
    } else {
        mXMagic.onResume();
    }
}
For detailed directions, see the UGCKitVideoRecord class of the demo.
前の記事へ: iOS次の記事へ: Migrating from UGSV Enterprise

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック