tencent cloud

Tencent Effect SDK

製品紹介
製品概要
製品機能
基本概念
製品のメリット
ユースケース
購入ガイド
価格一覧
購入プロセス
支払い遅滞・払い戻しの説明
Demo 体験
無料テスト
License案内
モバイル版Licenseの追加と更新
PC版Licenseの追加と更新
Web版Licenseの追加と更新
よくある質問
SDK ダウンロード
機能説明
SDK ダウンロード
バージョン履歴
SDK統合ガイド
Tencent Effect SDKの独立した統合
アトミック機能統合ガイド
APIドキュメント
iOS
Android
Flutter
機能の実践
SDKパッケージの簡素化
美顔シーン推奨パラメータ
ショート動画(エンタープライズ版)の移行ガイド
サードパーティプッシュによる美顔の接続(Flutter)
コンテンツ作成ツールの活用
Web美顔エフェクト
製品概要
クイックスタート
SDKへのアクセス
APIドキュメント
体験版
よくあるご質問
よくある質問
一般関連
技術系関連
License関連
TE SDK ポリシー
プライバシーポリシー
データ処理とセキュリティ契約

Flutter

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-07-15 10:30:31
Tencent Effect SDK Flutter版のコアインターフェースクラスTencentEffectApiは、美顔数値の更新、動的エフェクト呼び出しなどの機能に用いられます。

Publicメンバー関数

API
説明
美顔データを初期化します。美顔の使用前に必ずこのメソッドを呼び出してください
美顔権限の承認を行います
SDKのログレベルを設定します。 開発デバッグの際はLog.DEBUGに、正式リリースの際はLog.WARNにそれぞれ設定することをお勧めします。正式リリースの際にLog.DEBUGに設定していると、大量のログがパフォーマンスに影響する場合があります
レンダリングを再開します。ページが表示されている場合に呼び出します
レンダリングを一時停止します。ページが非表示の場合に呼び出します
美顔属性を更新します。任意のスレッドで呼び出せます
美顔オブジェクト作成時のコールバックインターフェースを設定します(エラー発生時にこのインターフェースを呼び出します)
動的エフェクトプロンプトのコールバック関数を設定します。プロンプトをフロントエンドのページ上に表示するために用いられます
顔の特徴点位置情報などのデータのコールバックを設定します(S1-05およびS1-06パッケージのみコールバックあり)
顔、ジェスチャー、体の検出状態のコールバックを設定します
現在のlic権限がどの美顔をサポートしているかを判断します。 BEAUTYおよびBODY_BEAUTYタイプの美顔項目のチェックのみサポートします。チェックの結果は各美顔オブジェクトのXmagicProperty.isAuthフィールドに割り当てられます
現在のモデルが美顔機能をサポートしているかどうかを判断します(OpenGL3.0)
現在のデバイスでサポートされているアトミック機能のテーブルを返します
動的エフェクトリソースリストをSDKのチェック用に渡します。実行後、XmagicProperty.isSupportフィールドは、そのアトミック機能が利用可能かどうかを表します。XmagicProperty.isSupportによってUIレイヤーのクリック制限を制御することや、リソースリストから直接削除することができます
動的エフェクトリソースリストを渡し、各リソースが使用できるSDKアトミック機能のリストを返します

メンバー関数の説明

initXmagic

初期化メソッドです。
void initXmagic(String xmagicResDir,InitXmagicCallBack callBack);

typedef InitXmagicCallBack = void Function(bool reslut);

パラメータ

パラメータ
意味
String xmagicResDir
リソースファイルを配置したディレクトリ
InitXmagicCallBack callBack
コールバックインターフェースの初期化

setLicense

認証データを設定し、美顔権限の承認を行います
///美顔認証処理の実行
void setLicense(String licenseKey, String licenseUrl, LicenseCheckListener checkListener);
///権限承認検証結果のコールバックメソッド
typedef LicenseCheckListener = void Function(int errorCode, String msg);

パラメータ

パラメータ
意味
String licenseKey
認証LicenseKey
String licenseUrl
認証LicenseUrl
LicenseCheckListener checkListener
権限承認結果のコールバックインターフェース

setXmagicLogLevel

SDKのログレベルを設定します
void setXmagicLogLevel(int logLevel);

パラメータ

パラメータ
意味
int logLevel
LogLevelを使用して定義可能なタイプを設定します

onResume

美顔処理を再開します
void onResume();

onPause

美顔処理を一時停止します
void onPause();

updateProperty

ある項目の美顔数値または動的エフェクト、フィルターを設定します。任意のスレッドで呼び出せます。
void updateProperty(XmagicProperty xmagicProperty);

パラメータ

パラメータ
意味
XmagicProperty xmagicProperty
美顔属性パッケージ化オブジェクト

setOnCreateXmagicApiErrorListener

美顔オブジェクト作成時のエラーコールバックインターフェースを設定します
void setOnCreateXmagicApiErrorListener(OnCreateXmagicApiErrorListener? errorListener);
///美顔インスタンス作成時のエラーコールバックメソッド
typedef OnCreateXmagicApiErrorListener = void Function(String errorMsg, int code);

パラメータ

パラメータ
意味
OnCreateXmagicApiErrorListener? errorListener
美顔オブジェクト作成時のエラーメッセージコールバックインターフェース
返されるエラーコードの意味対照表:
エラーコード
意味
-1
不明なエラー
-100
3Dエンジンリソースの初期化に失敗しました
-200
GAN素材をサポートしていません
-300
デバイスがこの素材コンポーネントをサポートしていません
-400
テンプレートのJSONの内容が空です
-500
SDKのバージョンが低すぎます
-600
分割をサポートしていません
-700
OpenGLをサポートしていません
-800
スクリプトをサポートしていません
5000
分割背景画像の解像度が2160×3840を超えています
5001
分割背景画像に必要なメモリが不足しています
5002
分割背景ビデオの解析に失敗しました。
5003
分割背景ビデオが200秒を超えています
5004
分割背景ビデオのフォーマットをサポートしていません

setTipsListener

動的エフェクトプロンプトのコールバック関数を設定します。プロンプトをフロントエンドのページ上に表示するために用いられます。例えば素材の中には、ユーザーに、うなずく、手を伸ばす、指ハートなどを促すものがあります。
void setTipsListener(XmagicTipsListener? xmagicTipsListener);

abstract class XmagicTipsListener {
/// tipsを表示します。Show the tip.
/// @param tips tips文字列。Tip's content
/// @param tipsIcon tipsのicon。Tip's icon
/// @param type tipsタイプ。0は文字列とiconの両方を表示することを表し、1はpag素材がiconのみを表示することを表します。tips category, 0 means that both strings and icons are displayed, 1 means that only the icon is displayed for the pag material
/// @param duration tipsは時間(ミリ秒)を表示します。Tips display duration, milliseconds
void tipsNeedShow(String tips, String tipsIcon, int type, int duration);

/// *
/// tipsを非表示にします。Hide the tip.
/// @param tips tips文字列。Tip's content
/// @param tipsIcon tipsのicon。Tip's icon
/// @param type tipsタイプ。0は文字列とiconの両方を表示することを表し、1はpag素材がiconのみを表示することを表します。tips category, 0 means that both strings and icons are displayed, 1 means that only the icon is displayed for the pag material
void tipsNeedHide(String tips, String tipsIcon, int type);
}

パラメータ

パラメータ
意味
XmagicTipsListener xmagicTipsListener
コールバック関数実装クラス

setYTDataListener

顔の特徴点位置情報などのデータのコールバックを設定します。
///顔の特徴点位置情報などのデータコールバックを設定します(S1-05およびS1-06パッケージのみコールバックあり)
void setYTDataListener(XmagicYTDataListener? xmagicYTDataListener);
顔の情報などのデータのコールバックを設定します

abstract class XmagicYTDataListener {
//Youtu AIデータコールバック。
void onYTDataUpdate(String data);
}
onYTDataUpdateはJSON string構造を返します。最大で5つの顔の情報を返します。
{
"face_info":[{
"trace_id":5,
"face_256_point":[
180.0,
112.2,
...
],
"face_256_visible":[
0.85,
...
],
"out_of_screen":true,
"left_eye_high_vis_ratio:1.0,
"right_eye_high_vis_ratio":1.0,
"left_eyebrow_high_vis_ratio":1.0,
"right_eyebrow_high_vis_ratio":1.0,
"mouth_high_vis_ratio":1.0
},
...
]
}

フィールドの意味

フィールド
タイプ
値の範囲
説明
trace_id
int
[1,INF)
顔ID。連続ストリーム取得の過程で、IDが同一であれば同じ顔であると認識できます
face_256_point
float
[0,screenWidth]または[0,screenHeight]
計512個。顔の256個の重要特徴点であり、画面左上隅が(0,0)です
face_256_visible
float
[0,1]
顔の256個の重要特徴点の視認度
out_of_screen
bool
true/false
顔が枠外に出ていないか
left_eye_high_vis_ratio
float
[0,1]
左目の特徴点のうち高視認度のものが占める割合
right_eye_high_vis_ratio
float
[0,1]
右目の特徴点のうち高視認度のものが占める割合
left_eyebrow_high_vis_ratio
float
[0,1]
左眉の特徴点のうち高視認度のものが占める割合
right_eyebrow_high_vis_ratio
float
[0,1]
右眉の特徴点のうち高視認度のものが占める割合
mouth_high_vis_ratio
float
[0,1]
口の特徴点のうち高視認度のものが占める割合

パラメータ

パラメータ
意味
XmagicYTDataListener xmagicYTDataListener
コールバック関数実装クラス

setAIDataListener

顔、体、ジェスチャーを検出した際、これらの部位の特徴点位置情報をコールバックします
void setAIDataListener(XmagicAIDataListener? aiDataListener);

abstract class XmagicAIDataListener {
void onFaceDataUpdated(String faceDataList);

void onHandDataUpdated(String handDataList);

void onBodyDataUpdated(String bodyDataList);
}

isBeautyAuthorized

現在のLicense権限がどの美顔または美ボディをサポートしているかを判断します。 BEAUTYおよびBODY_BEAUTYタイプの美顔項目のチェックのみサポートします。チェックの結果は各美顔オブジェクトのXmagicProperty.isAuthフィールドに割り当てられます。isAuthフィールドがfalseの場合は、UI上でこれらの項目へのエントリーをブロックすることができます。
Future<List<XmagicProperty>> isBeautyAuthorized(
List<XmagicProperty> properties);

パラメータ

パラメータ
意味
List<XmagicProperty> properties
チェックする必要がある美顔項目

isSupportBeauty

現在のモデルが美顔(OpenGL3.0)をサポートしているかどうかを判断します。
Future<bool> isSupportBeauty();

戻り値

戻り値bool:美顔をサポートしているかどうか。

getDeviceAbilities

現在のデバイスがサポートするアトミック機能のテーブルを返します。getPropertyRequiredAbilitiesメソッドと合わせて使用します。
Future<Map<String, bool>> getDeviceAbilities();

戻り値

戻り値Map<String,bool>
key:アトミック機能名(素材の機能名に対応)。
value:現在のデバイスがサポートしているかどうか。

getPropertyRequiredAbilities

動的エフェクトリソースリストを渡し、各リソースが使用できるSDKアトミック機能のリストを返します。
メソッドのユースケースは次のとおりです。
いくつかの動的エフェクト素材を購入または制作し、このメソッドを呼び出すと、各素材が使用する必要があるアトミック機能のリストが返されます。例えば、素材1は機能A、B、Cを使用する必要があり、素材2は機能B、C、Dを使用する必要があるなどです。これらの機能リストをサーバー上で保持します。その後、ユーザーがサーバーから動的エフェクト素材をダウンロードしたい場合、先にgetDeviceAbilitiesメソッドによって、スマートフォンが備えるアトミック機能のリスト(このスマートフォンは機能A、B、Cを備えているが、機能Dは備えていないなど)を取得し、その機能リストをサーバーに渡すことで、サーバーがそのデバイスに機能Dが備わっていないと判断し、ユーザーに素材2を送信しないということが可能になります。
Future<Map<XmagicProperty, List<String>?>> getPropertyRequiredAbilities(
List<XmagicProperty> assetsList);

パラメータ

パラメータ
意味
List<XmagicProperty> assetsList
アトミック機能をチェックする必要がある動的エフェクトリソースリスト

戻り値

戻り値Map<XmagicProperty, List<String>?> :
key:動的エフェクトリソース素材のエンティティクラス。
value:使用するアトミック機能のリスト。

isDeviceSupport

動的エフェクトリソースリストをSDKのチェック用に渡します。実行後、XmagicProperty.isSupportフィールドは、その素材が利用可能かどうかを表します。XmagicProperty.isSupportによってUIレイヤーのクリック制限を制御することや、直接リソースリストから削除することができます。
Future<List<XmagicProperty>> isDeviceSupport(List<XmagicProperty> assetsList);

パラメータ

パラメータ
意味
List<XmagicProperty> assetsList
チェックする必要がある動的エフェクト素材リスト

ヘルプとサポート

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

フィードバック