以下の用途向け:IOS
iOS 向け Beauty AR SDK
iOS 向け Beauty AR SDK でネイティブのカメラ体験に自然なレタッチとフェイスエフェクトを追加。撮影処理と画面は引き続き自由に制御できます。
開発者向けリソース
iOS 向け Beauty AR SDKのドキュメントとサンプル
IOS BEAUTY AR の機能
アプリに必要なカメラ体験を構築
ネイティブフレーム入力
- ピクセルバッファとテクスチャ
- 画像処理 API
外観の調整
- 調整できる美顔エフェクト
- ライセンス取得済みのメイクとステッカー
アプリ側の制御
- 独自のカメラ画面を管理
- リソースとライフサイクルを管理
iOS 向け Beauty AR SDK を見る
API をカメラ、操作 UI、エフェクト素材に接続します。
ネイティブカメラフレームを処理
対応するフレームデータを iOS 向け Beauty AR SDK に渡し、処理済み出力をアプリで使います。
ドキュメントを読む// pixelBuffer must use the supported RGBA format.
YTProcessInput *input = [[YTProcessInput alloc] init];
input.pixelData = [[YTImagePixelData alloc] init];
input.pixelData.data = pixelBuffer;
input.dataType = kYTImagePixelData;
YTProcessOutput *output = [self.xMagicApi process:input];独自の操作 UI でエフェクトを調整
スライダーを iOS 向け Beauty AR SDK のエフェクトパラメータに割り当てます。名前と範囲はパラメータガイドから選んでください。
ドキュメントを読む// Values come from your validated effect configuration.
[self.xMagicApi setEffect:effectName
effectValue:effectValue
resourcePath:nil
extraInfo:nil];カメラにルックを読み込む
ライセンス認証の成功後、iOS 向け Beauty AR SDK で同梱エフェクト素材を適用します。
ドキュメントを読む// Use a compatible asset included in your license.
[self.xMagicApi setEffect:effectName
effectValue:effectValue
resourcePath:assetPath
extraInfo:nil];始める
iOS 向け Beauty AR SDK を導入する
- 01
- 02
- 03
# Choose the pod that matches your licensed package.
pod 'TencentEffect_S1-04'
# Then run: pod install// Authenticate before creating the effect instance.
[TELicenseCheck setTELicense:licenseURL
key:licenseKey
completion:^(NSInteger code, NSString *message) {
if (code == TELicenseCheckOk) {
// Initialize XMagic with your bundled effect resources.
}
}];iOS 向け Beauty AR SDK のよくある質問
iOS 向け Beauty AR SDK をインストールするには?
ライセンスに合う CocoaPods パッケージを使用し、エフェクト素材を追加します。リンカー設定とカメラ権限の説明は最新ガイドに従ってください。
iOS 向け Beauty AR SDK のライセンスはどう使いますか?
アプリの bundle identifier をライセンスに一致させてください。XMagic インスタンスの作成前に TELicenseCheck 認証を完了します。
iOS 向け Beauty AR SDK は既存のキャプチャ出力を処理できますか?
はい。処理 API は対応するピクセルバッファ、テクスチャ、raw データ、画像入力を受け付けます。キャプチャ処理に接続する前に形式と向きを確認してください。
画像のカメラ画面は含まれますか?
画像はアプリデザインの一例です。このページでは Core SDK の導入を扱います。カメラ操作やエフェクトの UI はアプリ側で用意してください。
iOS 向け Beauty AR SDK はいつ解放すべきですか?
カメラ画面を離れる際はライフサイクルガイドに従い、リスナーを解除してエフェクトインスタンスを解放します。画面を閉じた後も保持しないでください。
Swift または Objective-C で iOS 向け Beauty AR SDK を統合するには?
Xcode プロジェクトに文書記載のパッケージを統合し、アプリのライフサイクル遷移を処理します。選択した機能の権限と capabilities を iPhone でテストしてください。
アプリ公開前に iOS 向け Beauty AR SDK をテストするには?
ライセンス対象の入力とエフェクト処理をテストします。カメラ使用時の権限とプレビュー終了後の解放も確認してください。
iOS 向け Beauty AR SDK の画面をカスタマイズするには?
対応するエフェクトを独自のプレビューと選択 UI に接続します。素材、機能対応、ライセンス範囲は対象プラットフォームに一致させてください。

