すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo VOD:iOS用の短いビデオSDKの統合

最終更新日:Oct 30, 2024

このトピックでは、iOS用のショートビデオSDKをポッドモードで統合し、SDKを手動で統合する方法について説明します。

前提条件

開発環境がセットアップされました。 次の表に、開発環境の要件を示します。

環境

説明

iOS

iOS 9.0以降。

macOSハイシエラ

macOS High Sierra 10.13以降。

Xcode

Xcode 9.0以降。 Xcodeをダウンロードするには、Mac App Storeにアクセスしてください。

(推奨) SDKをポッドモードで統合する

  1. Podfileファイルに依存関係を追加します。

    重要
    • ショートビデオSDK 3.24.0以降を使用する場合は、FFmpeg 4.3.0以降を使用します。

    • ネットワーク経由でポッドリポジトリにアクセスして更新できることを確認してください。 ポッドがインストールされたら、フレームワークのバージョンがGitHub公式Webサイトでリリースされている最新バージョンと同じかどうかを確認します。

    • 最小依存関係の統合方法を使用してショートビデオSDKを統合する場合、メディアのアップロードが必要な場合は、アップロードSDKを統合する必要があります。 詳細については、「iOS用アップロードSDKの統合」をご参照ください。

    • デフォルトの統合 (リソースパッケージとアップロードSDKが含まれています)

      # The resource package, upload SDK, and short video SDK are integrated. This is the default integration method. 
      pod 'AliyunVideoSDKPro', '~> 6.15.0'
    • 最小依存関係統合 (リソースパッケージとアップロードSDKを除く)

      # Only the short video SDK is integrated. The resource package and upload SDK are not integrated.
      pod 'AliyunVideoSDKPro/min', '~> 6.15.0'
      説明

      録画中にフェイスステッカーを使用する場合は、AliyunVideoSDKPro.bundleリソースパッケージを追加する必要があります。 詳細については、「リソースパッケージパスの指定」をご参照ください。

  2. ポッドリポジトリを更新します。

    pod repo update
  3. ポッドをインストールします。

    pod install

SDKを手動で統合する

フレームワークとリソースの依存関係の説明

説明

アップロードフレームワークは手動統合ではサポートされていません。 メディアファイルをApsaraVideo VODにアップロードするには、アップロードSDKを統合する必要があります。 詳細については、「iOS用アップロードSDKの統合」をご参照ください。

次の表に、手動統合に必要なフレームワークとリソースパッケージを示します。

名前

説明

ダウンロードリンク

AliyunVideoSDKPro.framework

動的フレームワーク

プロフェッショナル版V6.15.0

AliyunVideoSDKPro.bundle

リソースパッケージ (オプション)

説明

このリソースパッケージは、録音中にフェイスステッカーを使用する場合に必要です。

alivcffmpeg

動的フレームワーク

GitHub

手順

説明
  • 手動統合の手順は複雑です。 動的フレームワークをApp Storeに送信する前に、x86-basedシミュレーターアーキテクチャの動的フレームワークを削除する必要があります。 動的フレームワークを削除しない場合、送信はApp Storeによって拒否されます。 短いビデオSDKをポッドモードで統合することを推奨します。 次のメソッドを使用して、動的フレームワークを削除できます。

    • lipoコマンドラインツールを使用して、x86-basedシミュレータアーキテクチャの動的フレームワークを削除します。

    • ポッドモードで動的フレームワークを統合します。 このようにして、x86-basedシミュレータアーキテクチャの動的フレームワークは、ポッドがパッケージ化されるときに自動的に取り除かれます。

  • コンパイル中にエラーが発生した場合は、次の操作を実行します。[ビルド設定] タブをクリックします。 [Apple Clang - Language] セクションで、[Compile Sources As][Objective-C ++] に設定します。

  1. 動的フレームワークを追加します。

    [全般] タブをクリックします。 [フレームワーク、ライブラリ、および埋め込みコンテンツ] セクションで、[+] をクリックし、ドロップダウンリストから [他の... を追加] を選択し、前述の動的フレームワークAliyunVideoSDKPro.frameworkおよびalivcffmpeg.frameworkをインポートします。 フレームワークのインポート後、[埋め込みと署名] をクリックします。

  2. 他のライブラリを追加します。

    [全般] タブをクリックします。 [フレームワーク、ライブラリ、および埋め込みコンテンツ] セクションで、[+] をクリックし、MobileCoreServices.framework、SystemConfiguration.framework、およびlibresolv.tbdをインポートします。

  3. オプション:AliyunVideoSDKPro.bundleリソースパッケージをプロジェクトにインポートします。

    [ビルドフェーズ] タブをクリックします。 [バンドルリソースのコピー] セクションで、[+] をクリックし、ドロップダウンリストから [その他の追加] を選択し、AliyunVideoSDKPro. Bundleをインポートします。

プロジェクトの設定

SDKの統合後、プロジェクトを開き、設定を変更します。

  1. [ビルド設定] タブをクリックします。 [リンク] セクションで、[その他のリンカーフラグ] を-ObjCに設定します。

  2. プロジェクトのinfo.Plistファイルを開き、次の権限を付与します。

    Privacy - Camera Usage Description
    Privacy - Microphone Usage Description
    Privacy - Photo Library Usage Description

ライセンスファイルの設定

ライセンスを取得したら、ライセンスファイルを設定します。 ライセンスの取得方法の詳細については、「ショートビデオSDKのライセンスの取得と使用」をご参照ください。

ダウンロードしたライセンスファイルをアプリケーションプロジェクトにインポートします。 AlivcLicenseKeyAlivcLicenseFileをinfo.plistファイルに追加します。 AlivcLicenseKeyの値はLicenseKeyの値であり、AlivcLicenseFileの値はライセンスファイルが格納されているディレクトリです。 次の表に、設定で必要なキーを示します。

キー

AlivcLicenseKey

LicenseKeyの値。 例: MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****。

AlivcLicenseFile

ライセンスファイルが保存されているディレクトリ。

次のステップ

SDKの初期化

関連ドキュメント