Batasan dan integrasi ApsaraVideo Player SDK untuk Flutter - ApsaraVideo VOD

Topik ini menjelaskan batasan ApsaraVideo Player SDK untuk Flutter serta cara mengintegrasikannya.

Persyaratan Lingkungan

Kategori	Deskripsi
Versi Flutter	Mendukung Flutter 3.22.2 • channel stable.
Versi Dart	Mendukung Dart 3.4.3.
Versi OS	Mendukung Android 6.0 atau yang lebih baru.
Chip ponsel	Arsitektur yang diperlukan: armeabi-v7a dan arm64-v8a.
Alat pengembangan	Gunakan Android Studio atau Visual Studio Code.

Unduhan SDK

Catatan

ApsaraVideo Player SDK untuk Flutter harus kompatibel dengan versi Flutter SDK Anda. Misalnya, versi 5.4.0 ApsaraVideo Player SDK untuk Flutter hanya mendukung Flutter SDK 2.0 atau yang lebih baru. Untuk informasi selengkapnya mengenai kompatibilitas versi, lihat Riwayat rilis Flutter SDK.

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

Deskripsi Proyek

Lapisan native ApsaraVideo Player SDK untuk Flutter didasarkan pada ApsaraVideo Player SDK untuk Android dan iOS. Kode sumber tersedia sebagai dependensi demo yang dapat Anda tambahkan ke proyek Anda.

Struktur folder proyek ditunjukkan pada gambar berikut: Flutter directory structure

Tabel berikut menjelaskan folder-folder tersebut beserta fiturnya.

Nama file	Deskripsi	Diperlukan
android	Kode native Android dan SDK pemutar.	Ya
ios	Kode native iOS dan SDK pemutar.	Ya
lib	Kode API Flutter.	Ya
example	Demo ApsaraVideo Player untuk Flutter.	Tidak

ApsaraVideo Player SDK untuk Flutter mencakup fitur untuk streaming langsung dan pemutaran. Jika proyek Anda tidak memerlukan fitur streaming langsung, Anda dapat mengubah kernel SDK dari versi all-in-one (streaming langsung dan pemutaran) menjadi versi pemutaran saja. Bagian-bagian berikut menggunakan proyek demo sebagai contoh.

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 (aliran interaktif) dengan ApsaraVideo Player SDK.

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

Jika useAIOFramework = false, SDK pemutaran saja dan penarikan aliran RTS untuk Android digunakan. Jika useAIOFramework = true, versi Android (aliran interaktif) digunakan. Versi ini mendukung pengambilan aliran untuk streaming langsung, termasuk Streaming Real-Time (RTS) dan co-streaming berbasis RTC, serta pemutaran.

Penting

Ubah versi kernel SDK sesuai kebutuhan. Untuk versi terbaru, lihat ApsaraVideo for MediaBox SDK, ApsaraVideo Player SDK, dan Penarikan Aliran RTS.

dependencies {
    // Definisikan kernel SDK.
    def useAIOFramework = false

    def aio_sdk_version = "x.x.x" // Versi terbaru ApsaraVideo for MediaBox SDK (aliran interaktif).
    def player_sdk_version = "x.x.x" // Versi terbaru ApsaraVideo Player SDK.
    def rts_sdk_version = "x.x.x" // Versi terbaru komponen RTS.

    // Pilih SDK berdasarkan nilai useAIOFramework.
    if (useAIOFramework) {
        // ApsaraVideo for MediaBox SDK (aliran interaktif): Mendukung pengambilan aliran untuk streaming langsung (termasuk RTS dan co-streaming berbasis RTC) dan pemutaran.
        implementation "com.aliyun.aio:AliVCSDK_InteractiveLive:$aio_sdk_version"
    } else {
        // ApsaraVideo Player SDK.
        implementation "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
        // (Opsional) SDK komponen RTS.
        implementation "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"
        // (Opsional) Lapisan jembatan AlivcArtc antara pemutar dan RTS. Nomor versi harus sama dengan versi SDK pemutar. Lapisan ini harus diintegrasikan bersama dengan komponen RTS.
        implementation "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version" 
    }
}

iOS

Modifikasi variabel useAIOFramework dalam file flutter_aliplayer.podspec proyek Anda.

Jika useAIOFramework = false, SDK pemutaran saja dan penarikan aliran RTS untuk iOS digunakan.

Jika useAIOFramework = true, versi iOS (aliran interaktif) digunakan. Versi ini mendukung pengambilan aliran untuk streaming langsung, termasuk Streaming Real-Time (RTS) dan co-streaming berbasis RTC, serta pemutaran.

Penting

Ubah versi kernel SDK sesuai kebutuhan. Untuk versi terbaru, lihat ApsaraVideo for MediaBox SDK, ApsaraVideo Player SDK, dan Penarikan Aliran RTS.

   # Definisikan kernel SDK.
  useAIOFramework = false

  # Definisikan versi SDK.
  aio_sdk_version = 'x.x.x'
  player_sdk_version = 'x.x.x'
  rts_sdk_version = 'x.x.x'

  # Pilih SDK berdasarkan nilai useAIOFramework.
  if useAIOFramework
    s.subspec 'AliVCSDKFrameworks' do |ss|
    # ApsaraVideo for MediaBox SDK (aliran interaktif): Mendukung pengambilan aliran untuk streaming langsung (termasuk RTS dan co-streaming berbasis RTC) dan pemutaran.
    ss.dependency 'AliVCSDK_InteractiveLive', aio_sdk_version
  end
  else
  s.subspec 'AliPlayerSDKFrameworks' do |ss|
    # ApsaraVideo Player SDK mandiri untuk 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, Anda harus menjalankan aplikasi pada perangkat fisik.

Prosedur integrasi

Catatan

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

Mulai VS Code.
Pilih View > Command Palette….
Masukkan flutter dan pilih Flutter: New Project.
Masukkan nama proyek, misalnya myapp, lalu tekan Enter.
Pilih lokasi untuk proyek dan klik tombol untuk mengonfirmasi.
Tunggu hingga proyek dibuat. Proses selesai ketika 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 dalam proyek Anda.
```
dependencies:
  flutter_aliplayer: ^7.0.0
# Versi ini adalah nomor versi ApsaraVideo Player SDK untuk Flutter, misalnya 7.0.0. Ubah nomor versi sesuai kebutuhan.
```
Opsional:Jika bisnis Anda memerlukan dukungan untuk RTS (RTS), tambahkan dependensi yang diperlukan. Untuk informasi selengkapnya, lihat ApsaraVideo Player untuk Flutter.