Flutter プッシュ SDK デモのコンパイル方法 - ApsaraVideo Live

デモのダウンロード

最新のデモのソースコードとインストールパッケージについては、「SDK のダウンロード」をご参照ください。

デモのコンパイル

環境要件

カテゴリ	要件
Flutter バージョン	バージョン 2.5.0 以降、3.0.0 未満。バージョン 2.8.0 を推奨します。
Dart バージョン	バージョン 2.12.0 以降、3.0.0 未満。
システムバージョン	Android 5.0 以降。 iOS 10.0 以降。
CPU アーキテクチャ	armeabi-v7a または arm64-v8a。
開発ツール	Android Studio または Visual Studio Code を使用します。

コンパイル

IDE を使用する方法

Android Studio

プロジェクトを開く：

Android Studio を起動し、[Open] をクリックして、flutter_livepush_plugin/example ディレクトリを選択します。
依存関係をインストールする：

Android Studio で pubspec.yaml ファイルを開き、右上隅にある [Pub Get] ボタンをクリックして依存関係をインストールします。
デバイスをセットアップする：

Android の物理デバイスが接続されていることを確認します。
アプリを実行する：

ツールバーの緑色の実行ボタン (実行) をクリックし、ターゲットデバイスを選択してアプリを起動します。

Visual Studio Code

プロジェクトを開く：

Visual Studio Code を起動します。ファイル -> フォルダーを開く を選択し、flutter_livepush_plugin プロジェクトの example フォルダーを開きます。
依存関係をインストールする：
このフォルダーでコマンドラインを開き、以下のコマンドを実行して依存関係をインストールします。
```
flutter pub get
```
デバイスをセットアップする：

Android または iOS の物理デバイスが接続されていることを確認します。VS Code の左下隅にあるデバイスセレクターを使用して、ターゲットデバイスを選択します。
アプリを実行する：

[F5] キーを押すか、左側のアクティビティバーにある [実行とデバッグ] アイコンをクリックし、[Flutter] 設定を選択して、デバッグセッションを開始します。

Xcode (iOS)

プロジェクトを開く：

プロジェクトの example/ios ディレクトリに移動し、Runner.xcworkspace ファイルを Xcode で開きます。
CocoaPods の依存関係をインストールする：
example/ios ディレクトリでコマンドラインを開き、以下のコマンドを実行します。
```
pod install
```
署名を設定する：

Xcodeで、Runner プロジェクトを選択し、Signing & Capabilities タブで有効な開発者アカウントと署名証明書を設定します。
アプリを実行する：

Xcode ツールバーの実行ボタン (▶️) をクリックし、ターゲットデバイスを選択してアプリを起動します。

コマンドラインを使用する方法

flutter_livepush_plugin/example ディレクトリに移動し、コマンドラインを開きます。

依存関係をインストールします。
```
flutter pub get
```
プロジェクトをコンパイルします。
Android

重要
Android プロジェクトをコンパイルする前に、Android SDK と Gradle がインストールされていることを確認してください。
- アプリを実行する：
  
  以下のコマンドを実行してアプリを起動します。
  # デバッグビルドを実行 flutter run --debug # リリースビルドを実行 flutter run --release
- APK ファイルをパッケージ化する：
  
  以下のコマンドを実行して APK ファイルを生成します。
  flutter build apk
  
  説明
  APK ファイルは build/app/outputs/flutter-apk/app-release.apk にあります。
iOS

重要
iOS プロジェクトをコンパイルする前に、Xcode と CocoaPods がインストールされていることを確認してください。

まず、CocoaPods の依存関係を初期化します。
```
cd ios && pod install && cd ..
```
- アプリを実行する：
  
  以下のコマンドを実行してアプリを起動します。
  # デバッグビルドを実行 flutter run --debug # リリースビルドを実行 flutter run --release
- IPA ファイルをパッケージ化する：
  
  以下のコマンドを実行して IPA ファイルを生成します。
  flutter build ipa
  
  説明
  IPA ファイルは build/ios/ipa/Runner.ipa にあります。

よくある質問

コンパイルの問題：iOS で pod install が失敗する

Dart バージョン 3.0 以降を使用している場合、iOS で pod install を実行すると、以下のエラーが発生します。

[!] CocoaPods could not find compatible versions for pod "Flutter":
In Podfile:
Flutter (from `Flutter`)
url_launcher_ios (from `.symlinks/plugins/url_launcher_ios/ios`) was resolved to 0.0.1, which depends on
Flutter
Specs satisfying the `Flutter (from `Flutter`), Flutter` dependency were found, but they required a higher minimum deployment target.

解決策：example フォルダー内の Podfile で、platform :ios のバージョン指定を 12.0 に変更します。

コンパイルの問題：CocoaPods とプロファイル環境の不一致

Xcode でアプリの実行に失敗し、「The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation.」というエラーが表示されることがあります。

以下の手順を実行します。

Pods フォルダーを削除します。
Podfile.lock を削除します。
pod install --repo-update を実行します。
Xcode を終了し、プロジェクトを再度開いてコンパイルします。

コンパイルの問題：「Type 'UIApplication' does not conform to protocol 'Launcher'」

コンパイル中に「Type 'UIApplication' does not conform to protocol 'Launcher'」というエラーが発生することがあります。

// Copyright 2013 The Flutter Authors. All rights reserved.
// このソースコードの使用は、LICENSE ファイルに記載されている BSD スタイルのライセンスによって規定されます。

/// URL の起動に関連する UIApplication メソッドのプロトコル。
///
/// このプロトコルは、テスト用に代替実装を注入できるようにするために存在します。
protocol Launcher {
    /// アプリが URL スキームを処理できるかどうかを示すブール値を返します。
    func canOpenURL(_ url: URL) -> Bool

    /// 指定された URL のリソースを非同期で開こうと試みます。
    func open(
        _ url: URL,
        options: [UIApplication.OpenExternalURLOptionsKey: Any],
        completionHandler completion: ((Bool) -> Void)?)
}

/// Launcher は意図的に UIApplication への直接のパススルーです。
extension UIApplication: Launcher {}

解決策：コードを以下のように変更します。

/// Launcher は意図的に UIApplication への直接のパススルーです。
extension UIApplication: Launcher {
    func open(_ url: URL, options: [OpenExternalURLOptionsKey : Any], completionHandler completion: ((Bool) -> Void)?) {
        self.open(url, options: options, completionHandler: completion)
        }
}

[その他のコンパイルの問題]

お使いの Flutter のバージョンが環境要件を満たしていることを確認してください。

[インジェスト URL を取得する方法]

インジェスト URL を取得するには、「ストリーミング URL の生成」をご参照ください。

[デモでストリームインジェストが失敗する]

セルフサービスのトラブルシューティングを使用してインジェスト URL をテストし、有効であることを確認してください。

[インジェストされたオーディオおよびビデオストリームに関する情報を表示する方法]

ストリーム管理に移動します。[アクティブなストリーム] で、取り込まれた音声およびビデオストリームを表示および管理できます。

[ストリームを再生する方法]

ストリームインジェストを開始した後、ApsaraVideo Player、FFplay、VLC などのプレーヤーを使用してストリームのプルをテストしてください。再生 URL を取得するには、「ストリーミング URL の生成」をご参照ください。