Tüm Ürünler
Search
Belge Merkezi

ApsaraVideo VOD:Integrate the SDK

Son Güncelleme:Oct 05, 2026

Flutter için ApsaraVideo Player SDK'sını projenize entegre etmeye yönelik gereksinimleri ve sınırlamaları öğrenin.

Ortam Gereksinimleri


Kategori


Açıklama


Flutter sürümü


Flutter 3.22.2 (stable kanalı) desteklenir.


Dart sürümü


Dart 3.4.3 desteklenir.


İşletim sistemi sürümü


Android 6.0 ve üzeri sürümler desteklenir.


Telefon çipi


Gerekli mimariler: armeabi-v7a ve arm64-v8a.


Geliştirme araçları


Android Studio veya Visual Studio Code kullanmanızı öneririz.

SDK İndirmeleri

Not

Flutter için ApsaraVideo Player SDK'sı, Flutter SDK sürümünüzle eşleşmelidir. Örneğin, ApsaraVideo Player SDK 5.4.0, Flutter SDK 2.0 veya sonraki bir sürümü gerektirir. Sürüm uyumluluğu ayrıntıları için Flutter SDK sürüm geçmişi konusuna bakın.

Proje Açıklaması

Flutter oynatıcı SDK'sı, Android ve iOS için yerel ApsaraVideo Player SDK'larını sarmalar. Demo, projenize ekleyebileceğiniz bir bağımlılık olarak kaynak kodu sağlar.

Klasör ayrıntıları:


Dosya adı


Açıklama


Gerekli


android


Android yerel kodu ve oynatıcı SDK'sı.


Evet


ios


iOS yerel kodu ve oynatıcı SDK'sı.


Evet


lib


Flutter API kodu.


Evet


example


Flutter oynatıcı demosu.


Hayır

SDK hem canlı akışı hem de oynatmayı destekler. Yalnızca oynatma özelliğini kullanmak için SDK çekirdeğini tümleşik sürümden yalnızca oynatma sürümüne geçirin. Aşağıdaki örneklerde demo projesi kullanılmaktadır.

Android

  1. Proje düzeyindeki build.gradle dosyasına Alibaba Cloud Maven deposunu ekleyin.

    maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
  2. ApsaraVideo for MediaBox SDK'sını (etkileşimli akış), ApsaraVideo Player SDK'sı ile değiştirin.

    Projenizin android/build.gradle dosyasındaki useAIOFramework değişkenini ayarlayın.

    useAIOFramework = false ise yalnızca oynatma SDK'sı ve Android için RTS akış çekme kullanılır. useAIOFramework = true ise Android sürümü (etkileşimli akış) kullanılır; bu sürüm, Real-Time Streaming (RTS) ve Alibaba Real-Time Communication (ARTC) tabanlı ortak akış dahil olmak üzere canlı akış için akış gönderimini ve oynatmayı destekler.

    Önemli

    Çekirdek SDK sürümünü gerektiği gibi güncelleyin. En son sürümler: ApsaraVideo for MediaBox SDK, ApsaraVideo Player SDK ve RTS Akış Çekme.

    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

Projenizin flutter_aliplayer.podspec dosyasındaki useAIOFramework değişkenini ayarlayın.

useAIOFramework = false ise yalnızca oynatma SDK'sı ve iOS için RTS akış çekme kullanılır.

useAIOFramework = true ise iOS sürümü (etkileşimli akış) kullanılır; bu sürüm, Real-Time Streaming (RTS) ve RTC tabanlı ortak akış dahil olmak üzere canlı akış için akış gönderimini ve oynatmayı destekler.

Önemli

Çekirdek SDK sürümünü gerektiği gibi güncelleyin. En son sürümler: ApsaraVideo for MediaBox SDK, ApsaraVideo Player SDK ve RTS Akış Çekme.

   # 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

Sınırlamalar

Android için ApsaraVideo Player SDK'sı emülatörleri desteklemez. Entegrasyonu tamamladıktan sonra uygulamanızı fiziksel bir cihazda çalıştırın.

Entegrasyon Yordamı

Not

Bu adımlarda VS Code 1.65.2 örnek olarak kullanılmıştır. Diğer geliştirme araçları için yordam benzerdir.

  1. VS Code'u başlatın.

  2. View > Command Palette… seçeneğini seçin.

  3. flutter girin ve Flutter: New Project seçeneğini seçin.

  4. myapp gibi bir proje adı girin ve Enter tuşuna basın.

  5. Proje için konumu belirttikten sonra mavi OK düğmesini tıklayın.

    main.dart dosyası görüntülendiğinde proje hazırdır.

  6. Flutter için ApsaraVideo Player SDK'sını entegre edin.

    Flutter için ApsaraVideo Player SDK'sını hızlı bir şekilde entegre etmek için projenizin pubspec.yaml dosyasına flutter_aliplayer bağımlılığını ekleyin.

    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.
  7. İsteğe bağlı: İşiniz RTS desteği gerektiriyorsa gerekli bağımlılığı ekleyin. Daha fazla bilgi için Flutter için ApsaraVideo Player konusuna bakın.