Queen SDK は、Alibaba のビデオクラウドチームによって開発されたスマートレタッチ SDK です。この SDK は、画像レタッチ、フェイスレタッチ、クロマキー、ステッカー、メイクアップ、ジェスチャー認識、ボディシェイプ、ヘアスタイリング、拡張現実（AR）ライティングなど、幅広い機能を提供します。これらの機能は、ライブストリーミング、ビデオ会議、ショートビデオ制作のシナリオで使用できます。このトピックでは、レタッチ機能を実装するために iOS 向け Queen SDK を統合する方法について説明します。
前提条件
開発環境が準備されていること。次の表に、開発環境の要件を示します。
項目 | 説明 |
iOS | iOS 9.0 以降。 |
macOS High Sierra | macOS High Sierra 10.13 以降。 |
Xcode | Xcode 9.0 以降。 Xcode をダウンロードするには、Mac App Store にアクセスしてください。 |
iOS デバイス | iPad や iPhone など、ARMv7 または ARM64 アーキテクチャを採用したモバイルデバイス。 macOS を実行し、ARM64 アーキテクチャを採用したデバイスはサポートされていません。 |
統合方法
ビジネス要件に基づいて、ポッドモードまたはローカルモードで SDK を統合できます。
Pod モード
サンプルコード:
pod 'Queen', '6.1.0-official-pro' ローカルモード
サンプルプロジェクトパッケージをダウンロードして解凍し、次のフレームワークを取得します。
queen.framework opencv2.framework重要opencv2.frameworkは Basic Edition では不要です。Xcode を開き、プロジェクトの [target] を選択します。 [General] タブで、[Frameworks, Libraries, And Embedded Content] セクションに上記のフレームワークを追加し、これらのフレームワークの [Embed] パラメーターを [Embed & Sign] に設定します。
プロジェクト [target] の [Build Settings] タブで、[ENABLE_BITCODE] を見つけ、このパラメーターを [NO] に設定します。
取得した
queen.frameworkファイルからmnn.metallibをプロジェクトディレクトリに追加します。この手順は、Ultimate Edition と Full Edition の場合にのみ必要です。
ライセンスの設定
事前に Queen SDK のライセンスを取得していることを確認してください。 詳細については、「Queen SDK のライセンスを取得する」をご参照ください。ライセンスを取得したら、次の手順を実行して、プロジェクトで LicenseKey と LicenseFile を設定します。
ApsaraVideo Live の Queen SDK と ApsaraVideo VOD のショートビデオ SDK を同時に統合する場合、2 つの SDK の LicenseKey と LicenseFile は同じです。 LicenseKey と LicenseFile は一度だけ設定する必要があります。最新のライセンスファイルを使用する必要があることに注意してください。
購入した SDK が更新された場合、または更新する必要がある場合は、ライセンスファイルも更新する必要があります。次の手順を実行して、ライセンスファイルを更新します。
メールを送信して最新のライセンスファイルを取得します。 詳細については、「Queen SDK のライセンスを取得する」をご参照ください。
最新のライセンスファイルを取得したら、ライセンスを設定する手順を実行します。
ライセンスファイルをアプリプロジェクトにインポートし、Info.plist ファイルに次のキーを追加します。
AlivcLicenseKey: このキーの値は、LicenseKey の値です。例:MoCTfuQ391Z01****8f8745e23c8a457a8ff8d5faedc1****。AlivcLicenseFile: このキーの値は、mainBundle を基準としたライセンスファイルのパスです。 例: AliVideoCert_164933454****.crt。
参考資料
項目 | 参考資料 |
サンプル プロジェクト | |
GitHub 上のデモ プロジェクト | |
一般的なベンダーの SDK との統合コード |