ApsaraVideo Live:SDK のダウンロードと統合

Maven を使用した自動統合 (推奨)

1. プロジェクトのルートディレクトリにある settings.gradle ファイルを開きます。ARTC SDK の Maven リポジトリを dependencyResolutionManagement/repositories フィールドに追加します。

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // ARTC SDK の Maven リポジトリを追加します。
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

注意: 7.1.0 より前のバージョンの Android Gradle Plugin を使用している場合、settings.gradle ファイルに対応するフィールドが見つからないことがあります。詳細については、「Android Gradle Plugin 7.1」をご参照ください。この場合、代わりに次のソリューションを使用してください。

allprojects {
    repositories {
        ...
        // ARTC SDK の Maven リポジトリを追加します。
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

2. app/build.gradle ファイルを開き、ARTC SDK の依存関係を dependencies に追加します。バージョン番号は「SDK のダウンロード」セクションで確認できます。${latest_version} を特定のバージョン番号に置き換えてください。最新バージョンは 7.9.1 です。

dependencies {
    // ApsaraVideo Real-time Communication SDK の依存関係をインポートします。
    // ${latest_version} を特定のバージョン番号に置き換えます。
    implementation 'com.aliyun.aio:AliVCSDK_ARTC:${latest_version}'
    // バージョン 7.4.0 以前の場合は、keep 依存関係を追加します。
    // implementation 'com.aliyun.aio.keep:keep:1.0.1'
}

Android Gradle Plugin 8.1 以降を使用している場合、Android Studio は依存関係情報をバージョンカタログに移行することを推奨します。詳細については、「ビルドをバージョンカタログに移行する」をご参照ください。

SDK をダウンロードして手動で統合

1. 「SDK のダウンロード」セクションで、必要な ARTC SDK バージョンの AAR ファイルをダウンロードします。最新バージョンは 7.10.0 です。ファイル名の例は AliVCSDK_ARTC-x.y.z.aar です。

2. ダウンロードした AAR ファイルをプロジェクトディレクトリ (例: app/libs) にコピーします。このフォルダが存在しない場合は作成してください。

3. プロジェクトのルートディレクトリにある settings.gradle ファイルを開きます。AAR ファイルを含むフォルダを dependencyResolutionManagement/repositories に追加します。

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // ARTC SDK の相対パスを追加します。
        flatDir {
            dir 'app/libs'
        }
    }
}

注意: 7.1.0 より前のバージョンの Android Gradle Plugin を使用している場合、settings.gradle ファイルに対応するフィールドが見つからないことがあります。詳細については、「Android Gradle Plugin 7.1」をご参照ください。この場合、代わりに次のソリューションを使用してください。

プロジェクトのルートディレクトリにある build.gradle ファイルを開きます。次のフィールドを allprojects/repositories に追加します。

allprojects {
    repositories {
        ...
        // ARTC SDK の相対パスを追加します。
        flatDir {
            dir 'app/libs'
        }
    }
}

4. app/build.gradle ファイルを開き、AAR ファイルの依存関係を dependencies に追加します。

// x.y.z を対応するバージョン番号に置き換えます。
implementation(name:'AliVCSDK_ARTC', version: 'x.y.z', ext:'aar')

5. ビルドが完了すると、External Libraries の下に該当する依存関係が生成されます。

   

CocoaPods を使用した自動統合 (推奨)

1. ターミナルを開き、開発デバイスに CocoaPods ツールをインストールします。CocoaPods が既にインストールされている場合は、このステップをスキップできます。

sudo gem install cocoapods

2. ターミナルを開き、プロジェクトのルートディレクトリに移動して、次のコマンドを実行して Podfile を作成します。

pod init

3. 生成された Podfile を開いて編集し、ARTC SDK の依存関係を追加します。最新バージョンは 7.10.0 です。

target 'MyApp' do
  use_frameworks!
  # ${latest version} を特定のバージョン番号に置き換えます。
  pod 'AliVCSDK_ARTC', '~> ${latest version}'
end

4. ターミナルウィンドウで、次のコマンドを実行してプロジェクトの CocoaPods 依存関係ライブラリを更新します。

pod install

5. コマンドが正常に実行されると、プロジェクトフォルダに .xcworkspace 拡張子を持つプロジェクトファイルが生成されます。このファイルをダブルクリックして Xcode でプロジェクトを開きます。ワークスペースは CocoaPods の依存関係を自動的に読み込みます。

   

SDK をダウンロードして手動で統合

1. 「SDK のダウンロード」セクションで、最新の ARTC SDK ファイルを取得して解凍します。

2. 解凍した SDK パッケージからフレームワークファイルをプロジェクトディレクトリにコピーします。

3. Xcode でプロジェクトを開き、メニューから File -> Add Files to "xxx" を選択し、SDK ライブラリファイルをプロジェクトに追加します。

   

4. ターゲットを選択し、インポートしたフレームワークファイルを "Embed & Sign" に設定します。