Tüm Ürünler
Search

Bu Ürün

    ApsaraVideo VOD:Integrate the SDK

    Belge Merkezi

    ApsaraVideo VOD:Integrate the SDK

    Son Güncelleme:Oct 05, 2026

    ApsaraVideo Player SDK for iOS'u projenize hızlıca entegre edin.

    Gereksinimler

    • İşletim sistemi: iOS 8.0 veya sonraki bir sürüm.

    • Geliştirme aracı: Xcode önerilir. Bu konuda Xcode kullanılmaktadır. İndirmek için: ‎Xcode.

    • ApsaraVideo Player SDK for iOS, simülatörleri desteklemez. Uygulamaları gerçek bir cihazda çalıştırmanız gerekir.

    Ön koşullar

    • Oynatıcı yetkilendirmesi için bir lisans dosyası edindiniz; örneğin AliVideoCert-********.crt. Daha fazla bilgi için bkz. Lisans alma.

    • Manuel entegrasyon için en son ApsaraVideo Player SDK for iOS paketini indirin. Bkz. indir.

    Kullanım notları

    • Uygulamanızı paketlerken, kilitlenme raporlarını sembolize etmek için dSYM dosyası kullanılır.

    • ApsaraVideo Player SDK for iOS, AlivcFFmpeg ve AliyunPlayer çerçevelerini gerektirir. Oynatıcı üstbilgi dosyaları AliyunPlayer içinde bulunur.

    • Hem oynatıcı SDK'sını hem de kısa video SDK'sını entegre ediyorsanız kısa video SDK'sı, oynatıcı SDK'sı ve AlivcFFmpeg arasında sürüm uyumluluğunu sağladığınızdan emin olun. Sürüm uyuşmazlıkları, özellik hatalarına neden olabilir. Daha fazla bilgi için bkz. AlivcFFmpeg bağımlılıkları.

    • ApsaraVideo Player SDK for iOS paketi simülatör mimarilerini içerir. Uygulamanızı App Store'a gönderirken reddedilmeyi önlemek için bunları kaldırın.

    Video eğitimi

    1. Adım: SDK'yı entegre edin

    CocoaPods entegrasyonu

    1. CocoaPods'u yükleyin. Bu işlem bir Ruby ortamı gerektirir.

      // In Terminal, run the following command:
sudo gem install cocoapods

    2. CocoaPods kurulumunu doğrulayın.

      Kurulumu doğrulamak için terminalinizde pod --version komutunu çalıştırın.

      xxx@ ~ % pod --version
1.16.2

    3. Bir Podfile oluşturun.

      Terminalinizde proje dizininize gidin ve bir Podfile oluşturmak için pod init komutunu çalıştırın.

      // Go to your project directory.
xxx@ ~ %  cd /path/yourProject
// Generate the Podfile.
xxx@ yourProject % pod init

    4. Oynatıcı SDK'sı bağımlılığını eklemek için Podfile'ı düzenleyin.

      Not

      • Hem oynatıcı SDK'sını hem de kısa video SDK'sını entegre etmek için aşağıdaki kodda AliPlayerSDK_iOS ifadesini AliPlayerPartSDK_iOS ile değiştirin. AliPlayerPartSDK_iOS FFmpeg içermez; bu da kısa video SDK'sındaki FFmpeg ile çakışmaları önler.

      • Oynatıcı SDK'sı için doğru sürüm numarasını girin. Aksi takdirde içe aktarma başarısız olur ve hata bildirir. Oynatıcı SDK'sı sürümleri için bkz. ApsaraVideo Player SDK for iOS Sürüm Notları.

      source 'https://github.com/CocoaPods/Specs.git'
platform:ios, '8.0'

target 'yourProject' do
    # Player SDK. We recommend that you use the latest version.
    pod 'AliPlayerSDK_iOS'
end

    5. (Opsiyonel) Belirli bir oynatıcı SDK'sı sürümüne bağımlılık ekleyin.

      source 'https://github.com/CocoaPods/Specs.git'
platform:ios, '8.0'

player_sdk_version = '7.18.0'

target 'yourProject' do
    # Player SDK. We recommend that you use the latest version.
    pod 'AliPlayerSDK_iOS' , player_sdk_version
end

    6. Bağımlılıkları yükleyin.

      Bağımlılıkları yüklemek için aşağıdaki komutu çalıştırın.

      pod install

      Aşağıdaki çıktı, başarılı bir kurulumu gösterir.

      xxx@ yourProject % pod install
Analyzing dependencies
Downloading dependencies
Installing AliPlayerSDK_iOS (7.18.0)
Generating Pods project
Integrating client project
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

      Oynatıcı SDK'sını güncellemek için aşağıdaki komutu çalıştırın.

      pod update AliPlayerSDK_iOS

    Manuel entegrasyon

    Not

    Hem oynatıcı SDK'sını hem de kısa video SDK'sını entegre ediyorsanız yalnızca bir AlivcFFmpeg çerçevesini içe aktarın ve doğru sürümü kullandığınızdan emin olun.

    1. ApsaraVideo Player SDK for iOS öğesini indirin.

    2. Oynatıcı çerçevelerini Frameworks, Libraries, and Embedded Content bölümüne ekleyin ve Embed seçeneğini Embed & Sign olarak ayarlayın.

      • alivcffmpeg.framework: Oynatıcının temel çerçevesi.

      • AliyunMediaDownloader.framework: Çevrimdışı indirme için kullanılır.

      • AliyunPlayer.framework: Oynatıcı çerçevesi.

        本地集成

    3. Build Settings sekmesine tıklayın.

    4. Search Paths bölümünde Framework Search Paths değerini yerel çerçeve dizininize ayarlayın.

    (Opsiyonel) RTS entegrasyonu (CocoaPods)

    Gerçek Zamanlı Akış (RTS) bileşenini entegre etmek için bkz. iOS'ta RTS tabanlı akış çekmeyi uygulayın.

    2. Adım: Lisansı yapılandırın

    Önemli

    Oynatıcıyı Çin anakarası, Hong Kong ve Makao dışındaki bölgelerde (uluslararası site) kullanırken diğer tüm oynatıcı API'lerini çağırmadan önce ortamı ayarlamak için aşağıdaki API'yi çağırmanız gerekir.

    1. Yöntem 1: Varsayılan yapılandırmayı uluslararası site ortamına güncellemek için aşağıdaki API'yi çağırın.

      // For the international site, you must call this API before any other player APIs
// to set the environment. This setting cannot be changed at runtime.
AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;

    2. Yöntem 2(Önerilen): Oynatıcı SDK'sı 7.6.0 ve sonraki sürümlerinde uluslararası site ortamını Info.plist dosyasında yapılandırabilirsiniz.

      Info.plist dosyasını açın ve AlivcEnv değerini SEA olarak değiştirin.

      // Configure the current environment as the international site.
<key>AlivcEnv</key>
<string>SEA</string>

      Aşağıdaki görselde bir yapılandırma örneği gösterilmektedir: 1754557498401-1d235342-3c0b-4c83-bcee-ae7656e8ff23

    iOS istemcinizde lisansı yapılandırmak için bkz. iOS'ta lisans yapılandırma.

    3. Adım: Günlük kaydını etkinleştirin (Opsiyonel)

    Sorun gidermeye yardımcı olması için günlük kaydını etkinleştirin. Günlükleri nasıl alacağınızla ilgili talimatlar için bkz. SDK günlüklerini alma.

    // Enable logging.
[AliPlayer setEnableLog:YES];
// Set the log level. The default is LOG_LEVEL_INFO. For troubleshooting, set it to LOG_LEVEL_TRACE.
[AliPlayer setLogCallbackInfo:LOG_LEVEL_INFO callbackBlock:nil];

    Proje yapısı

    Çerçeve

    Açıklama

    alivcffmpeg.framework

    Oynatıcının temel çerçevesi. Gereklidir.

    AliyunMediaDownloader.framework

    Çevrimdışı indirme için kullanılır. Opsiyoneldir.

    AliyunPlayer.framework

    Oynatıcı çerçevesi. Gereklidir.

    artcSource.framework

    ARTC protokolünü destekler. Opsiyoneldir.

    Not

    ARTC protokolünü desteklemek için RtsSDK.framework öğesini de eklemeniz gerekir. Entegrasyon ayrıntıları için bkz. iOS'ta RTS tabanlı akış çekmeyi uygulayın.

    aemFilter.framework

    Ses geliştirmeyi etkinleştirir. Opsiyoneldir.

    libPluginSR.framework

    Süper çözünürlüğü etkinleştirir. Opsiyoneldir.

    normalsrFilter.framework

    Süper çözünürlüğü etkinleştirir. Opsiyoneldir.

    srFilter.framework

    Süper çözünürlüğü etkinleştirir. Opsiyoneldir.

    vfiFilter.framework

    Video kare ekleme özelliğini etkinleştirir. Opsiyoneldir.

    vvcCodecPlugin.framework

    H.266 kod çözme eklentisi. Opsiyoneldir.

    SSS

    CocoaPods kullanma

    // Deintegrate your project from CocoaPods dependencies.
pod deintegrate 

// Update the index of your local CocoaPods source repositories.
// Use case:
// - When you add a new dependency, this ensures you can fetch the latest available version.
// - When a specific library version is unavailable or you know a new version exists but does not appear in your project, use this command to update.
pod repo update

// Update the project's Pods.
// Use case:
// - Use this when you want to update all pods in your project to the latest supported versions allowed by your Podfile.
pod update

// Performs the same function as 'pod install' but forces an update of the local CocoaPods repository index before installing.
// Use case:
// - This is a good command to use when you add new libraries or want to use the latest version of a library specified in your Podfile, especially if you see an error message indicating that a required library version is unavailable.
pod install --repo-update

// Clear the Pods cache.
// Note:
// 1. Clearing the cache does not modify your Podfile.lock or Podfile. When you run 'pod install' or 'pod update', CocoaPods re-downloads the required libraries based on your manifest and lockfile.
// 2. Clearing the cache is not a regular step and should only be used to resolve specific issues. Normally, CocoaPods manages its cache well.
pod cache clean --all

    AlivcFFmpeg ile sembol çakışmaları

    Çözüm:

    • AlivcFFmpeg ile sembol çakışmalarıyla karşılaşırsanız yinelenen bağımlılığı kaldırın. ApsaraVideo Player SDK for iOS ile sağlanan sürümü tutun ve üçüncü taraf sürümü kaldırın. Bu işlem üçüncü taraf oynatıcı işlevselliğini etkileyebilir.

    Sandbox hatası

    • Sorun:

      截屏2024-12-06 16

    • Çözüm:

      UserSetting içinde User Script SandBoxing değerini NO olarak ayarlayın.

      1735888658101-5633103e-468d-4341-adaa-f5f52814aa36

    Kısa video SDK'sı entegrasyonu

    Hem ApsaraVideo Player SDK for iOS'u hem de kısa video SDK'sını entegre etmek için yinelenen sınıf sorunlarını ve derleme hatalarını önlemek üzere iOS için hepsi bir arada SDK kullanın.

    Diğer oynatıcı sorunları ve çözümleri için bkz. ApsaraVideo Player ile ilgili SSS.

    Başvuru kaynakları

    Temel özellikler

    Gelişmiş özellikler