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

ApsaraVideo VOD:SDK の統合

最終更新日:Nov 09, 2025

このトピックでは、ApsaraVideo Player SDK for Flutter の制限事項と統合方法について説明します。

環境要件

カテゴリ

説明

Flutter バージョン

Flutter 3.22.2 • channel stable をサポートします。

Dart バージョン

Dart 3.4.3 をサポートします。

OS バージョン

Android 6.0 以降をサポートします。

携帯電話のチップ

必須アーキテクチャ: armeabi-v7a および arm64-v8a。

開発ツール

Android Studio または Visual Studio Code を使用します。

SDK のダウンロード

説明

ApsaraVideo Player SDK for Flutter は、お使いの Flutter SDK バージョンと互換性がある必要があります。たとえば、ApsaraVideo Player SDK for Flutter のバージョン 5.4.0 は、Flutter SDK 2.0 以降のみをサポートします。バージョンの互換性の詳細については、「Flutter SDK リリース履歴」をご参照ください。

プロジェクトの説明

ApsaraVideo Player SDK for Flutter のネイティブレイヤーは、ApsaraVideo Player SDKs for Android および iOS に基づいています。ソースコードは、プロジェクトに追加できるデモの依存関係として利用できます。

プロジェクトフォルダの構造を次の図に示します。Flutter directory structure

次の表に、フォルダとその特徴を示します。

ファイル名

説明

必須

android

Android ネイティブコードとプレーヤー SDK。

はい

ios

iOS ネイティブコードとプレーヤー SDK。

はい

lib

Flutter API コード。

はい

example

ApsaraVideo Player for Flutter デモ。

いいえ

ApsaraVideo Player SDK for Flutter には、ライブストリーミングと再生の両方の機能が含まれています。プロジェクトでライブストリーミング機能が不要な場合は、SDK カーネルをオールインワンバージョン (ライブストリーミングと再生) から再生専用バージョンに変更できます。以下のセクションでは、デモプロジェクトを例として使用します。

Android

  1. プロジェクトレベルの build.gradle ファイルに Alibaba Cloud Maven リポジトリを追加します。

    maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
  2. ApsaraVideo for MediaBox SDK (インタラクティブストリーム) を ApsaraVideo Player SDK に置き換えます。

    プロジェクトの android/build.gradle ファイル内の useAIOFramework 変数を変更します。

    useAIOFramework = false の場合、再生専用 SDK と Android 用 RTS ストリームフェッチング が使用されます。useAIOFramework = true の場合、Android バージョン (インタラクティブストリーム) が使用されます。このバージョンは、リアルタイムストリーミング (RTS) と RTC ベースの共同ストリーミングを含むライブストリーミングのアップストリーミング、および再生をサポートします。

    重要

    必要に応じてカーネル SDK のバージョンを変更してください。最新バージョンについては、「ApsaraVideo for MediaBox SDK」、「ApsaraVideo Player SDK」、および「RTS ストリームフェッチング」をご参照ください。

    dependencies {
        // SDK カーネルを定義します。
        def useAIOFramework = false
    
        def aio_sdk_version = "x.x.x" // ApsaraVideo for MediaBox SDK (インタラクティブストリーム) の最新バージョン。
        def player_sdk_version = "x.x.x" // ApsaraVideo Player SDK の最新バージョン。
        def rts_sdk_version = "x.x.x" // RTS コンポーネントの最新バージョン。
    
        // useAIOFramework の値に基づいて SDK を選択します。
        if (useAIOFramework) {
            // ApsaraVideo for MediaBox SDK (インタラクティブストリーム): ライブストリーミング (RTS および RTC ベースの共同ストリーミングを含む) のアップストリーミングと再生をサポートします。
            implementation "com.aliyun.aio:AliVCSDK_InteractiveLive:$aio_sdk_version"
        } else {
            // ApsaraVideo Player SDK。
            implementation "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
            // (オプション) RTS コンポーネント SDK。
            implementation "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"
            // (オプション) プレーヤーと RTS 間の AlivcArtc ブリッジレイヤー。バージョン番号はプレーヤー SDK のバージョンと同じである必要があります。このレイヤーは RTS コンポーネントと一緒に統合する必要があります。
            implementation "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version" 
        }
    }

iOS

プロジェクトの flutter_aliplayer.podspec ファイル内の useAIOFramework 変数を変更します。

useAIOFramework = false の場合、再生専用 SDK と iOS 用 RTS ストリームフェッチング が使用されます。

useAIOFramework = true の場合、iOS バージョン (インタラクティブストリーム) が使用されます。このバージョンは、リアルタイムストリーミング (RTS) と RTC ベースの共同ストリーミングを含むライブストリーミングのアップストリーミング、および再生をサポートします。

重要

必要に応じてカーネル SDK のバージョンを変更してください。最新バージョンについては、「ApsaraVideo for MediaBox SDK」、「ApsaraVideo Player SDK」、および「RTS ストリームフェッチング」をご参照ください。

   # SDK カーネルを定義します。
  useAIOFramework = false

  # SDK バージョンを定義します。
  aio_sdk_version = 'x.x.x'
  player_sdk_version = 'x.x.x'
  rts_sdk_version = 'x.x.x'

  # useAIOFramework の値に基づいて SDK を選択します。
  if useAIOFramework
    s.subspec 'AliVCSDKFrameworks' do |ss|
    # ApsaraVideo for MediaBox SDK (インタラクティブストリーム): ライブストリーミング (RTS および RTC ベースの共同ストリーミングを含む) のアップストリーミングと再生をサポートします。
    ss.dependency 'AliVCSDK_InteractiveLive', aio_sdk_version
  end
  else
  s.subspec 'AliPlayerSDKFrameworks' do |ss|
    # スタンドアロンの ApsaraVideo Player SDK for iOS。
    ss.dependency 'AliPlayerSDK_iOS', player_sdk_version
    ss.dependency 'AliPlayerSDK_iOS_ARTC', player_sdk_version
    ss.dependency 'RtsSDK', rts_sdk_version
    end
  end

制限事項

ApsaraVideo Player SDK for Android はエミュレーターをサポートしていません。統合後、物理デバイスでアプリケーションを実行する必要があります。

統合プロシージャ

説明

以下のステップでは、VS Code V1.65.2 を例として使用します。プロシージャは他の開発ツールでも同様です。

  1. VS Code を起動します。

  2. [表示] > [コマンドパレット...] を選択します。

  3. flutter と入力し、[Flutter: 新規プロジェクト] を選択します。

  4. myapp などのプロジェクト名を入力し、Enter キーを押します。

  5. プロジェクトの場所を選択し、ボタンをクリックして確定します。

    プロジェクトが作成されるまで待ちます。main.dart ファイルが表示されると、プロセスは完了です。

  6. ApsaraVideo Player SDK for Flutter を統合します。

    ApsaraVideo Player SDK for Flutter を迅速に統合するには、プロジェクトの pubspec.yaml ファイルに flutter_aliplayer の依存関係を追加します。

    dependencies:
      flutter_aliplayer: ^7.0.0
    # バージョンは ApsaraVideo Player SDK for Flutter のバージョン番号です (例: 7.0.0)。必要に応じてバージョン番号を変更してください。
  7. オプション:ビジネスで RTS (RTS) のサポートが必要な場合は、必要な依存関係を追加します。詳細については、「ApsaraVideo Player for Flutter」をご参照ください。