以下の用途向け:ANDROID
Android 向け Beauty AR SDK
Android 向け Beauty AR SDK でカメラ処理に美顔調整と表情豊かなフェイスエフェクトを追加。アプリ独自のデザインを保ちながらテクスチャを処理できます。
開発者向けリソース
Android 向け Beauty AR SDKのドキュメントとサンプル
ANDROID BEAUTY AR の機能
アプリに必要なカメラ体験を構築
テクスチャ処理パイプライン
- カメラテクスチャを処理
- 処理済みテクスチャ ID を返す
エフェクトの選択
- 美顔パラメータを調整
- ライセンス取得済み素材を読み込む
ネイティブ統合
- Maven パッケージの選択
- GL スレッドのライフサイクル制御
Android 向け Beauty AR SDK を見る
API をカメラ、操作 UI、エフェクト素材に接続します。
カメラ処理にエフェクトを追加
テクスチャ処理コールバック内で Android 向け Beauty AR SDK を使用し、フレームサイズを入力に合わせてください。
ドキュメントを読む@Override
public int onCustomProcessTexture(
int textureId, int width, int height) {
return xmagicApi.process(textureId, width, height);
}すべての調整をすぐに反映
文書記載のエフェクト名と範囲を使い、美顔パネルを Android 向け Beauty AR SDK に接続します。
ドキュメントを読むxmagicApi.setEffect(
XmagicConstant.EffectName.BEAUTY_WHITEN,
50,
null,
null
);ひとつの画面でエフェクトを切り替える
互換性のある素材パスを Android 向け Beauty AR SDK に渡し、エフェクト選択 UI を構築します。
ドキュメントを読む// Select an asset from your licensed resource directory.
xmagicApi.setEffect(
effectName, effectValue, resourcePath, extraInfo
);始める
Android 向け Beauty AR SDK を導入する
- 01
- 02
- 03
// Use your licensed package and a pinned release version.
implementation "com.tencent.mediacloud:TencentEffect_S1-04:${beautySdkVersion}"// Authenticate before creating XmagicApi.
TELicenseCheck.getInstance().setTELicense(
context, licenseURL, licenseKey,
new TELicenseCheckListener() {
@Override
public void onLicenseCheckFinish(int code, String message) {
if (code == TELicenseCheck.ERROR_OK) {
// Initialize with your copied resource directory.
}
}
});Android 向け Beauty AR SDK のよくある質問
Android 向け Beauty AR SDK を追加するには?
ライセンスに合う Maven パッケージを追加し、バージョンを固定します。必要なモデルとエフェクト素材をコピーし、文書の ABI と release ビルドのルールに従ってください。
Android 向け Beauty AR SDK ではどのデバイスを対象にすべきですか?
現行ガイドは Android 7.0 以降を推奨し、ARMv7 と ARM64 の対応を記載しています。利用者が実際に使うデバイスで選択したエフェクトをテストしてください。
Android 向け Beauty AR SDK がカメラフレームを取得しますか?
Core SDK はアプリが渡すフレームを処理します。公式サンプルにはカメラコンポーネントがあり、キャプチャ体験の構築時に参考にできます。
Android 向け Beauty AR SDK のリソースを解放するには?
GL コンテキストの終了前に GL スレッドで onDestroy を呼びます。文書の pause/resume ライフサイクルに従ってください。メインスレッドで破棄するとリソースがリークする場合があります。
すべてのパッケージに全エフェクトが含まれますか?
いいえ。パッケージごとに利用権と必要な素材ファイルが異なります。必要なライセンス取得済みエフェクトを選び、アプリで公開する前に素材を確認してください。
Kotlin または Java で Android 向け Beauty AR SDK を統合するには?
Android プロジェクトと manifest の設定に従い、必要に応じて実行時権限と Activity の解放を処理します。バックグラウンドとフォアグラウンドの切り替えも含め、実機でテストしてください。
アプリ公開前に Android 向け Beauty AR SDK をテストするには?
ライセンス対象の入力とエフェクト処理をテストします。カメラ使用時の権限とプレビュー終了後の解放も確認してください。
Android 向け Beauty AR SDK の画面をカスタマイズするには?
対応するエフェクトを独自のプレビューと選択 UI に接続します。素材、機能対応、ライセンス範囲は対象プラットフォームに一致させてください。

