すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:統合の準備

    ドキュメントセンター

    ApsaraVideo VOD:統合の準備

    最終更新日:Sep 11, 2026

    このドキュメントでは、AliPlayerWidget を迅速に使い始められるように、統合手順と前提条件を概説します。

    前提条件

    開発環境

    AliPlayerWidget を使用するには、開発環境が次の要件を満たしていることを確認してください。

    • Flutter SDK

      • 最低限必要なバージョンは 2.10.0 です。推奨バージョンは 3.22.2 です。

      • flutter doctor を実行し、報告された問題をすべて解決してください。

    • JDK 11

      説明

      JDK 11 を設定するには、[Preferences] -> [Build, Execution, Deployment] -> [Build Tools] -> [Gradle] -> [Gradle JDK] に移動し、11 を選択してください。バージョン 11 が利用できない場合は、Android Studio をアップグレードしてください。

    • Android 開発環境

      • 最新バージョンの Android Studio をインストールしてください。

      • Android SDK を設定してください。サポートされている最小 API レベルは 21 (Android 5.0) です。

      • Gradle バージョン 7.0 以降が必要です。

    • iOS 開発環境

      • 最新バージョンの Xcode をインストールしてください。

      • CocoaPods を設定してください。推奨バージョンは 1.13.0 です。

      • サポートされている最小 iOS バージョンは 10.0 です。

    権限

    • 権限

      • プレーヤーがオンラインのビデオリソースを読み込めるように、Android と iOS でネットワーク権限を有効にしてください。

    • ライセンス

      • プレーヤー SDK のライセンス証明書と License Key を取得していることを確認してください。詳細については、「ライセンスの管理」をご参照ください。

      • 注：有効なライセンス設定がない場合、プレーヤーは動作せず、認可例外がスローされることがあります。

    初期化の詳細については、aliplayer_widget_example サンプルプロジェクトをご参照ください。

    依存関係の追加

    通常、aliplayer_widget を追加するだけで十分です。aliplayer_widget はすでに flutter_aliplayer に依存しています。下層 API を直接使用する必要がある場合 (MediaLoader のプリロードなど) は、flutter_aliplayer を依存関係として明示的に宣言することもできます。

    SDK のバージョン

    aliplayer_widget は、デフォルトで標準プレーヤー SDK を使用します。

    シナリオ

    推奨バージョン

    説明

    再生のみ

    標準プレーヤー SDK (推奨)

    flutter_aliplayer の標準バージョン番号を使用します。

    プッシュストリーミング + 再生

    interactivelive 特別版

    これは、flutter_livepush_plugin などのプッシュストリーミング機能も統合し、その下層にある AliVCSDK との一貫性が必要な場合にのみ推奨されます。

    重要

    必要でない限り、interactivelive 特別版は使用しないでください。プロジェクトで再生機能のみが必要な場合は、バージョンを標準プレーヤー SDK の完全なバージョン番号に固定してください。これにより、オールインワン SDK の不必要な導入を防ぎ、依存関係の複雑さを軽減し、潜在的な SDK の競合を回避できます。

    依存関係は、次のいずれかの方法で追加できます。

    方法 1：コマンドラインの使用

    プロジェクトのルートディレクトリで、次のコマンドを実行してください。

    # 必須
flutter pub add aliplayer_widget

# オプション: 下層の flutter_aliplayer API を直接使用する必要がある場合にのみ追加
flutter pub add flutter_aliplayer

    方法 2：手動での追加

    pubspec.yaml ファイルの dependencies セクションに次の行を追加してください。

    dependencies:
  # 必須
  aliplayer_widget: <latest_version>

  # オプション: 下層の flutter_aliplayer API を直接使用する必要がある場合にのみ追加
  flutter_aliplayer: <latest_version>

    依存関係の取得とビルド

    依存関係を追加した後、パッケージを取得し、プロジェクトをビルドします。

    1. 依存関係パッケージを取得します (手動で追加した場合)。

      flutter pub get

    2. iOS の追加手順：

      cd ios
pod install
cd ..

    3. プロジェクトをビルドしてください。

      Android APK のビルド：

      flutter build apk

      iOS アプリのビルド：

      flutter build ios

      ユニバーサルアプリのビルド：

      flutter build

    これらの手順を完了すると、AliPlayerWidget を使用してビデオ再生機能を構築する準備が整います。詳細については、「クイックスタート」をご参照ください。