tencent cloud

フィードバック

ショート動画(エンタープライズ版)の移行ガイド

最終更新日:2022-07-18 10:06:18
    現在、ショート動画のエンタープライズ版はサポートが終了しています。そのうち、美顔モジュールはデカップリングおよびアップグレードされ、Tencent Effect SDKになりました。Tencent Effect SDKの美顔効果はより自然であるほか、製品の機能はより強力であり、統合方法はより柔軟です。このドキュメントは、ショート動画のエンタープライズ版をTencent Effect SDK(美顔エフェクト)にアップグレードするための移行ガイドです。

    注意事項

    1. xmagicモジュールのglideライブラリのバージョン番号を変更して、実際に使用するものと一致させます。
    2. xmagicモジュールの最小バージョン番号を変更して、実際に使用するものと一致させます。

    統合の手順

    手順1:Demoプロジェクトの解凍

    1. Tencent Effect TEを統合したUGSV Demoプロジェクトをダウンロードします。このDemoは、Tencent Effect 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モジュールを実際のプロジェクトにインポートします。

    手順2:SDKバージョンのアップグレード

    SDKをEnterprise版からProfessional版にアップグレードします。
    置換前implementation 'com.tencent.liteav:LiteAVSDK_Enterprise:latest.release'
    置換後implementation 'com.tencent.liteav:LiteAVSDK_Professional:latest.release'

    手順3:美顔Licenseの設定

    1. プロジェクトのapplicationのoncreateメソッドで以下のメソッドを呼び出します:
    XMagicImpl.init(this);
    XMagicImpl.checkAuth(null);
    2. XMagicImpl型で、申請したTencent EffectのLicense URLとKeyに置き換えます。

    手順4:コードの実装

    ショート動画のレコーディングインターフェース(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. このデータ型の最後に以下の2つのメソッドを追加します:
    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();
    }
    }

    手順5:その他のデータ型の変更

    1. AbsVideoRecordUI型のmBeautyPanel型をRelativeLayout型に変更し、getBeautyPanel()メソッドの戻り型をRelativeLayoutに変更します。同時に、対応するXMLの構成を変更し、エラーコードをコメントアウトします。
    2. UGCKitVideoRecord型のエラーコードをコメントアウトします。
    3. ScrollFilterView型のコードを変更し、mBeautyPanel変数を削除して、エラーコードをコメントアウトします。

    手順6:beautysettingkitモジュールへの依存関係の削除

    ugckitモジュールのbuild.gradleファイルで、beautysettingkitモジュールへの依存関係を削除し、プロジェクトをコンパイルして、エラーコードをコメントアウトしてください。
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)