Queen SDK は、Alibaba Cloud 動画チームが提供するリタッチ効果機能です。画像リタッチ、顔リタッチ、クロマキー、ステッカー、メイク、ジェスチャ検出、ボディシェイピング、ヘアスタイリング、AR 書き込みなど、多様なパーソナライズカスタマイズサービスをサポートします。ApsaraVideo Live、ビデオ会議、短尺動画制作などのシナリオに適用可能です。本トピックでは、iOS 向け Queen SDK を統合してリタッチ機能を実装する方法について説明します。
前提条件
以下の表に、開発環境の要件を示します。
カテゴリ | 説明 |
システムバージョン | iOS 9.0 以降をサポートします。 |
macOS High Sierra バージョン | macOS High Sierra 10.13 以降をサポートします。 |
Xcode バージョン | Xcode 9.0 以降をサポートします。Xcode をダウンロードしてください。 |
iOS デバイス | armv7 または arm64 アーキテクチャを搭載したモバイルデバイス（例：iPad、iPhone）。arm64 アーキテクチャをサポートする Mac は対象外です。 |
統合方法
SDK は Pod 統合とローカル統合の両方をサポートしています。ご要件に最も適した統合方法を選択してください。
Pod 統合
Pod を使用して統合するには、以下の手順を実行します。
pod 'Queen', '6.1.0-official-pro' ローカル統合
サンプルプロジェクトをダウンロードして解凍し、以下のフレームワークを取得します。
queen.framework opencv2.framework重要Lite 版では
opencv2.frameworkは不要です。Xcode を起動します。プロジェクトの [ターゲット] で、[全般] タブを開き、[フレームワーク、ライブラリ、および埋め込みコンテンツ] セクションに上記のフレームワークを追加します。追加したフレームワークの [埋め込み] プロパティを [埋め込み & 署名] に設定します。
プロジェクトの [ターゲット] で、[ビルド設定] タブを開き、[ENABLE_BITCODE] を検索します。その後、その値を [NO] に設定します。
mnn.metallibをqueen.frameworkからプロジェクトディレクトリに追加します。この手順は、フル版およびアルティメット版のみに必要です。
ライセンスの構成
事前にライセンスを取得する必要があります。詳細については、「Queen SDK ライセンスの取得」をご参照ください。ライセンスを取得後、プロジェクト内で LicenseKey および LicenseFile（証明書ファイル）を以下のように構成します。
ApsaraVideo Live 向け Queen SDK と ApsaraVideo VOD 向け短尺動画 SDK を同時に統合する場合、それぞれの LicenseKey および LicenseFile（証明書ファイル）は同一です。構成は 1 回のみ実行し、最新の証明書ファイルを使用してください。
購入済みの SDK バージョンが変更された場合、またはライセンス更新（SDK の有効期限切れ）が必要な場合は、証明書ファイルを更新してください。更新手順は以下のとおりです。
新しいライセンスを取得します。「Queen SDK ライセンスの取得」をご参照ください。最新の証明書ファイルを取得するには、メールにてお問い合わせください。
最新の証明書ファイルを取得後、本トピックのライセンス構成手順に従って更新を行います。
証明書ファイルをアプリプロジェクトにインポートし、Info.plist ファイルに 2 つの Key を追加します。
1 つ目の
KeyはAlivcLicenseKeyです。その値は LicenseKey であり、例：MoCTfuQ391Z01****8f8745e23c8a457a8ff8d5faedc1****です。2 つ目の
KeyはAlivcLicenseFileです。その値は証明書ファイルのパス（mainBundle からの相対パス）であり、例： AliVideoCert_164933454****.crt です。
参考
項目 | リンク |
サンプルプロジェクト | |
GitHub 上のデモプロジェクト | |
開発者向け共通 SDK ベンダー統合例 |