All Products
Search

This Product

    ApsaraVideo VOD:Persiapan integrasi

    Document Center

    ApsaraVideo VOD:Persiapan integrasi

    Last Updated:Sep 11, 2026

    Dokumen ini menjelaskan langkah-langkah integrasi dan prasyarat untuk AliPlayerWidget, membantu Anda memulai penggunaan komponen ini dengan cepat.

    Prasyarat

    Lingkungan pengembangan

    Untuk menggunakan AliPlayerWidget, pastikan lingkungan pengembangan Anda memenuhi persyaratan berikut:

    • Flutter SDK

      • Versi minimum yang dibutuhkan adalah 2.10.0. Versi yang direkomendasikan adalah 3.22.2.

      • Jalankan flutter doctor dan selesaikan masalah yang dilaporkan.

    • JDK 11

      Catatan

      Untuk mengatur JDK 11, buka Preferences -> Build, Execution, Deployment -> Build Tools -> Gradle -> Gradle JDK dan pilih versi 11. Jika versi 11 tidak tersedia, lakukan upgrade Android Studio Anda.

    • Lingkungan pengembangan Android

      • Instal versi terbaru Android Studio.

      • Konfigurasikan Android SDK. Level API minimum yang didukung adalah 21 (Android 5.0).

      • Diperlukan Gradle versi 7.0 atau lebih baru.

    • Lingkungan pengembangan iOS

      • Instal versi terbaru Xcode.

      • Konfigurasikan CocoaPods. Versi yang direkomendasikan adalah 1.13.0.

      • Versi iOS minimum yang didukung adalah 10.0.

    Izin

    • Izin

      • Aktifkan izin jaringan di Android dan iOS agar pemutar dapat memuat sumber daya video online.

    • Lisensi

      • Pastikan Anda memiliki Sertifikat lisensi dan License Key untuk SDK pemutar. Untuk informasi lebih lanjut, lihat Mengelola Lisensi.

      • Catatan: Tanpa konfigurasi lisensi yang valid, pemutar tidak akan berfungsi dan dapat melemparkan exception otorisasi.

    Untuk detail lebih lanjut mengenai inisialisasi, lihat proyek contoh aliplayer_widget_example.

    Tambahkan dependensi

    Umumnya, Anda hanya perlu menambahkan aliplayer_widget. Karena aliplayer_widget sudah memiliki dependensi terhadap flutter_aliplayer, Anda tidak perlu menambahkannya secara terpisah. Namun, jika Anda perlu menggunakan API dasar secara langsung (misalnya untuk pre-loading MediaLoader), Anda juga dapat secara eksplisit mendeklarasikan flutter_aliplayer sebagai dependensi.

    Versi SDK

    aliplayer_widget menggunakan SDK pemutar standalone secara default.

    Skenario

    Versi yang direkomendasikan

    Deskripsi

    Hanya pemutaran

    SDK pemutar Standar (Direkomendasikan)

    Gunakan nomor versi standar dari flutter_aliplayer.

    Push streaming + pemutaran

    InteractiveLive Edisi Khusus

    Ini direkomendasikan hanya jika Anda juga mengintegrasikan kemampuan push streaming, seperti flutter_livepush_plugin, dan memerlukan konsistensi dengan AliVCSDK dasarnya.

    Penting

    Kecuali diperlukan, jangan gunakan edisi khusus interactivelive. Jika proyek Anda hanya membutuhkan kemampuan pemutaran, sematkan versi ke nomor versi lengkap SDK pemutar standar. Hal ini mencegah Anda secara tidak perlu memperkenalkan SDK all-in-one, sehingga mengurangi kompleksitas dependensi dan menghindari potensi konflik SDK.

    Anda dapat menambahkan dependensi dengan salah satu metode berikut:

    Metode 1: Gunakan command line

    Di direktori root proyek Anda, jalankan perintah berikut:

    # Wajib
flutter pub add aliplayer_widget

# Opsional: Tambahkan hanya jika Anda perlu menggunakan API flutter_aliplayer dasar secara langsung
flutter pub add flutter_aliplayer

    Metode 2: Tambahkan secara manual

    Pada file pubspec.yaml Anda, tambahkan baris berikut di bawah bagian dependencies:

    dependencies:
  # Wajib
  aliplayer_widget: <latest_version>

  # Opsional: Tambahkan hanya jika Anda perlu menggunakan API flutter_aliplayer dasar secara langsung
  flutter_aliplayer: <latest_version>

    Ambil dependensi dan build

    Setelah menambahkan dependensi, ambil paket dan build proyek Anda:

    1. Ambil paket dependensi (jika Anda menambahkannya secara manual).

      flutter pub get

    2. Langkah tambahan untuk iOS:

      cd ios
pod install
cd ..

    3. Build proyek Anda.

      Build APK Android:

      flutter build apk

      Build aplikasi iOS:

      flutter build ios

      Build aplikasi universal:

      flutter build

    Setelah menyelesaikan langkah-langkah ini, Anda siap membangun fitur pemutaran video dengan AliPlayerWidget. Untuk detailnya, lihat Memulai Cepat.