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

現在、ショート動画のエンタープライズ版はサポートが終了しています。そのうち、美顔モジュールはデカップリングおよびアップグレードされ、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モジュールへの依存関係を削除し、プロジェクトをコンパイルして、エラーコードをコメントアウトしてください。