Integrasikan ApsaraVideo Player SDK untuk Flutter – persyaratan dan penyiapan - ApsaraVideo VOD

Pelajari persyaratan dan batasan untuk mengintegrasikan ApsaraVideo Player SDK untuk Flutter ke dalam proyek Anda.

Persyaratan lingkungan

Category	Description
Flutter version	Mendukung Flutter 3.22.2, channel stable.
Dart version	Mendukung Dart 3.4.3.
OS version	Mendukung Android 6.0 dan versi setelahnya.
Phone chip	Arsitektur yang diperlukan: armeabi-v7a dan arm64-v8a.
Development tools	Kami menyarankan Anda menggunakan Android Studio atau Visual Studio Code.

Unduhan SDK

Catatan

ApsaraVideo Player SDK untuk Flutter harus sesuai dengan versi Flutter SDK Anda. Misalnya, ApsaraVideo Player SDK 5.4.0 memerlukan Flutter SDK 2.0 atau versi yang lebih baru. Untuk detail kompatibilitas versi, lihat Flutter SDK release history.

Flutter SDK: Flutter SDK
ApsaraVideo Player SDK terbaru untuk Flutter: ApsaraVideo Player SDK
Plugin ApsaraVideo Player SDK untuk Flutter (untuk pembaruan patch): ApsaraVideo Player SDK for Flutter plugin

Deskripsi proyek

SDK player Flutter membungkus native ApsaraVideo Player SDK untuk Android dan iOS. Demo menyediakan kode sumber sebagai dependensi yang dapat Anda tambahkan ke proyek Anda.

Detail folder:

File name	Description	Required
android	Kode native Android dan player SDK.	Yes
ios	Kode native iOS dan player SDK.	Yes
lib	Kode API Flutter.	Yes
example	Demo player Flutter.	No

SDK mendukung streaming langsung dan pemutaran. Untuk hanya menggunakan pemutaran, alihkan kernel SDK dari versi all-in-one ke versi khusus pemutaran. Contoh berikut menggunakan proyek demo.

Android

Tambahkan repositori Maven Alibaba Cloud ke file build.gradle tingkat proyek.

maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }

Ganti ApsaraVideo for MediaBox SDK (interactive stream) dengan ApsaraVideo Player SDK.

Atur variabel useAIOFramework dalam file android/build.gradle proyek Anda.

Jika useAIOFramework = false, SDK khusus pemutaran dan RTS stream pulling for Android digunakan. Jika useAIOFramework = true, versi Android (interactive stream) digunakan, yang mendukung stream ingest untuk live streaming, termasuk Real-Time Streaming (RTS) dan co-streaming berbasis Alibaba Real-Time Communication (ARTC), serta pemutaran.

Penting

Perbarui versi kernel SDK sesuai kebutuhan. Versi terbaru: ApsaraVideo for MediaBox SDK, ApsaraVideo Player SDK, dan RTS Stream Pulling.

dependencies {
    // Define the SDK kernel.
    def useAIOFramework = false

    def aio_sdk_version = "x.x.x" // Latest version of ApsaraVideo for MediaBox SDK (interactive stream).
    def player_sdk_version = "x.x.x" // Latest version of ApsaraVideo Player SDK.
    def rts_sdk_version = "x.x.x" // Latest version of the RTS component.

    // Select the SDK based on the value of useAIOFramework.
    if (useAIOFramework) {
        // ApsaraVideo for MediaBox SDK (interactive stream): Supports stream ingest for live streaming (including RTS and RTC-based co-streaming) and playback.
        implementation "com.aliyun.aio:AliVCSDK_InteractiveLive:$aio_sdk_version"
    } else {
        // ApsaraVideo Player SDK.
        implementation "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
        // (Optional) RTS component SDK.
        implementation "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"
        // (Optional) The AlivcArtc bridge layer between the player and RTS. The version number must be the same as the player SDK version. This layer must be integrated together with the RTS component.
        implementation "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version" 
    }
}

iOS

Atur variabel useAIOFramework dalam file flutter_aliplayer.podspec proyek Anda.

Jika useAIOFramework = false, SDK khusus pemutaran dan RTS stream pulling for iOS digunakan.

Jika useAIOFramework = true, versi iOS (interactive stream) digunakan, yang mendukung stream ingest untuk live streaming, termasuk Real-Time Streaming (RTS) dan co-streaming berbasis RTC, serta pemutaran.

Penting

Perbarui versi kernel SDK sesuai kebutuhan. Versi terbaru: ApsaraVideo for MediaBox SDK, ApsaraVideo Player SDK, dan RTS Stream Pulling.

   # Define the SDK kernel.
  useAIOFramework = false

  # Define the SDK versions.
  aio_sdk_version = 'x.x.x'
  player_sdk_version = 'x.x.x'
  rts_sdk_version = 'x.x.x'

  # Select the SDK based on the value of useAIOFramework.
  if useAIOFramework
    s.subspec 'AliVCSDKFrameworks' do |ss|
    # ApsaraVideo for MediaBox SDK (interactive stream): Supports stream ingest for live streaming (including RTS and RTC-based co-streaming) and playback.
    ss.dependency 'AliVCSDK_InteractiveLive', aio_sdk_version
  end
  else
  s.subspec 'AliPlayerSDKFrameworks' do |ss|
    # Standalone 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

Batasan

ApsaraVideo Player SDK untuk Android tidak mendukung emulator. Setelah integrasi selesai, jalankan aplikasi Anda pada perangkat fisik.

Prosedur integrasi

Catatan

Langkah-langkah berikut menggunakan VS Code 1.65.2 sebagai contoh. Prosedurnya serupa untuk alat pengembangan lainnya.

Jalankan VS Code.
Pilih View > Command Palette…
Masukkan flutter dan pilih Flutter: New Project.
Masukkan nama proyek, misalnya myapp, lalu tekan Enter.
Setelah menentukan lokasi proyek, klik tombol OK berwarna biru.
Proyek siap digunakan saat file main.dart muncul.
Integrasikan ApsaraVideo Player SDK untuk Flutter.
Untuk mengintegrasikan ApsaraVideo Player SDK untuk Flutter secara cepat, tambahkan dependensi flutter_aliplayer ke file pubspec.yaml proyek Anda.
```
dependencies:
  flutter_aliplayer: ^7.0.0
# The version is the version number of the ApsaraVideo Player SDK for Flutter, for example, 7.0.0. Change the version number as needed.
```
Opsional: Jika bisnis Anda memerlukan dukungan untuk RTS, tambahkan dependensi yang diperlukan. Untuk informasi selengkapnya, lihat ApsaraVideo Player for Flutter.