All Products
Search

This Product

    ApsaraVideo VOD:Integrasikan SDK

    Document Center

    ApsaraVideo VOD:Integrasikan SDK

    Last Updated:Feb 11, 2026

    Topik ini menjelaskan cara mengintegrasikan kit pengembangan perangkat lunak (SDK) Pemutar Video Apsara untuk iOS secara cepat.

    Persyaratan lingkungan

    • Sistem: iOS 8.0 atau yang lebih baru.

    • Tool pengembangan: Disarankan menggunakan Xcode. Prosedur dalam topik ini berbasis Xcode. URL unduhan: Xcode.

    • Batasan: SDK Pemutar Video Apsara untuk iOS tidak mendukung emulator. Anda harus menjalankan aplikasi pada perangkat fisik setelah integrasi.

    Prasyarat

    • Anda telah mendaftarkan lisensi untuk SDK Pemutar Video Apsara dan memperoleh file lisensi AliVideoCert-********.crt. Untuk informasi selengkapnya, lihat Dapatkan lisensi.

    • Saat mengintegrasikan SDK secara lokal, Anda harus terlebih dahulu mengunduh paket SDK Pemutar Video Apsara untuk iOS. Disarankan untuk mengunduh versi terbaru.

    Catatan penggunaan

    • Saat membuat paket aplikasi, file dSYM digunakan untuk parsing simbol crash.

    • AlivcFFmpeg dan AliyunPlayer diperlukan saat menggunakan SDK Pemutar Video Apsara untuk iOS. File header pemutar terletak di AliyunPlayer.

    • Jika ingin mengintegrasikan SDK Pemutar Video Apsara dan SDK video pendek sekaligus, perhatikan ketergantungan versi antara SDK video pendek, SDK Pemutar Video Apsara, dan AlivcFFmpeg. Jika tidak, fitur SDK video pendek atau SDK Pemutar Video Apsara mungkin gagal. Untuk informasi selengkapnya, lihat Ketergantungan AlivcFFmpeg.

    • Paket instalasi SDK Pemutar Video Apsara untuk iOS mencakup arsitektur simulator. Anda harus menghapus arsitektur simulator sebelum menerbitkan aplikasi. Jika tidak, aplikasi gagal dikirim ke App Store.

    Langkah 1: Integrasikan SDK

    Integrasi CocoaPods

    1. Instal CocoaPods. CocoaPods bergantung pada lingkungan Ruby.

      // Jalankan perintah ini di terminal
sudo gem install cocoapods

    2. Verifikasi CocoaPods.

      Setelah instalasi selesai, jalankan pod --version di terminal untuk memverifikasi bahwa CocoaPods telah terinstal.

      xxx@ ~ % pod --version
1.16.2

    3. Buat Podfile.

      Di terminal, navigasikan ke direktori proyek Anda. Jalankan perintah pod init untuk membuat Podfile.

      // Masuk ke direktori proyek Anda.
xxx@ ~ %  cd /path/yourProject
// Hasilkan file tersebut.
xxx@ yourProject % pod init

    4. Edit Podfile untuk menambahkan dependensi SDK Pemutar Video Apsara.

      Catatan

      • Jika ingin mengintegrasikan SDK Pemutar Video Apsara dan SDK video pendek sekaligus, ganti AliPlayerSDK_iOS dalam kode berikut dengan AliPlayerPartSDK_iOS. AliPlayerPartSDK_iOS tidak berisi framework FFmpeg. Hal ini mencegah konflik dengan framework FFmpeg dari SDK video pendek.

      • Pastikan nomor versi SDK Pemutar Video Apsara benar. Jika tidak, kesalahan akan dilaporkan dan SDK gagal diimpor. Untuk informasi selengkapnya tentang versi SDK, lihat Catatan rilis SDK Pemutar Video Apsara untuk iOS.

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

target 'yourProject' do
    # Kami menyarankan Anda menggunakan versi terbaru SDK Pemutar Video Apsara.
    pod 'AliPlayerSDK_iOS'
end

    5. Opsional, tambahkan dependensi pada versi tertentu SDK Pemutar Video Apsara.

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

player_sdk_version = '7.12.0'

target 'yourProject' do
    # Kami menyarankan Anda menggunakan versi terbaru SDK Pemutar Video Apsara.
    pod 'AliPlayerSDK_iOS' , player_sdk_version
end

    6. Instal dependensi.

      Jalankan perintah instalasi untuk menambahkan dependensi SDK Pemutar Video Apsara ke repositori lokal.

      pod install

      Hasil contoh berikut menunjukkan bahwa instalasi berhasil.

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

      Jalankan perintah berikut untuk memperbarui SDK Pemutar Video Apsara.

      pod update AliPlayerSDK_iOS

    Integrasi lokal

    Catatan

    Jika ingin mengintegrasikan SDK Pemutar Video Apsara dan SDK video pendek sekaligus, Anda hanya perlu mengimpor satu AlivcFFmpeg. Pastikan Anda mengimpor versi AlivcFFmpeg yang benar.

    1. Unduh SDK pemutar iOS.

    2. Tambahkan framework pemutar ke bagian Frameworks, Libraries, and Embedded Content, lalu atur Embed menjadi Embed & Sign.

      • alivcffmpeg.framework: framework dasar pemutar.

      • AliyunMediaDownloader.framework: framework untuk unduhan offline.

      • AliyunPlayer.framework: framework pemutar.

        本地集成

    3. Klik tab Build Settings.

    4. Di bagian Search Paths, atur Framework Search Paths ke direktori tempat file framework disimpan.

    (Opsional) Integrasi Streaming Real-Time (RTS) (CocoaPods)

    Untuk mengintegrasikan komponen Streaming Real-Time (RTS), lihat Implementasikan penarikan aliran RTS pada iOS.

    Langkah 2: Konfigurasikan lisensi

    Penting

    Jika menggunakan lingkungan global (wilayah luar Tiongkok daratan, Hong Kong, Makau, dan Taiwan), pastikan untuk memanggil API berikut guna memperbarui konfigurasi default ke lingkungan internasional sebelum memanggil API pemutar apa pun.

    1. Metode 1: Panggil API berikut untuk memperbarui konfigurasi default ke lingkungan internasional.

      // Jika Anda menggunakan lingkungan global (wilayah luar Tiongkok daratan, Hong Kong, Makau, dan Taiwan), pastikan untuk memanggil API berikut guna memperbarui konfigurasi default ke lingkungan internasional sebelum memanggil API pemutar apa pun. Hal ini memastikan semua layanan selanjutnya berjalan di lingkungan internasional.
// Gunakan antarmuka terpadu AlivcBase untuk mengatur lingkungan internasional. Lingkungan tidak dapat diubah selama waktu proses.
AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;

    2. Metode 2 (Direkomendasikan): Untuk SDK Pemutar Video Apsara V7.6.0 atau yang lebih baru, Anda dapat mengonfigurasi lingkungan internasional dalam file Info.plist.

      Buka file Info.plist dan ubah nilai AlivcEnv menjadi SEA.

      // Konfigurasikan lingkungan saat ini sebagai lingkungan internasional.
<key>AlivcEnv</key>
<string>SEA</string>

      Gambar berikut menunjukkan contoh konfigurasi.1754557498401-1d235342-3c0b-4c83-bcee-ae7656e8ff23

    Untuk informasi selengkapnya tentang cara mengintegrasikan lisensi pada client iOS, lihat Integrasikan lisensi pada client iOS.

    Langkah 3: Aktifkan logging (Opsional)

    Mengaktifkan logging membantu Anda menemukan dan memecahkan masalah secara cepat. Logging juga menyediakan data untuk optimasi performa dan peningkatan pengalaman pengguna. Anda dapat memutuskan apakah akan mengaktifkan logging berdasarkan skenario bisnis Anda. Untuk informasi selengkapnya tentang cara memperoleh log, lihat Peroleh log SDK.

    // Aktifkan logging.
[AliPlayer setEnableLog:YES];
// Atur tingkat log. Tingkat default adalah LOG_LEVEL_INFO. Untuk memecahkan masalah, atur tingkat menjadi LOG_LEVEL_TRACE.
[AliPlayer setLogCallbackInfo:LOG_LEVEL_INFO callbackBlock:nil];

    Struktur proyek

    Framework

    Deskripsi

    alivcffmpeg.framework

    Framework dasar pemutar. Framework ini wajib digunakan.

    AliyunMediaDownloader.framework

    Digunakan untuk unduhan offline. Tidak wajib.

    AliyunPlayer.framework

    Pemutar wajib digunakan.

    artcSource.framework

    Framework yang mendukung protokol Alibaba Real-Time Communication (ARTC). Framework ini opsional.

    Catatan

    Untuk mendukung protokol ARTC, Anda juga harus menambahkan RtsSDK.framework. Untuk informasi selengkapnya, lihat Implementasikan penarikan aliran RTS pada iOS.

    aemFilter.framework

    Peningkatan audio bersifat opsional.

    libPluginSR.framework

    Framework untuk Video Ultra HD. Framework ini opsional.

    normalsrFilter.framework

    Framework untuk Video Ultra HD. Framework ini opsional.

    srFilter.framework

    Framework untuk Video Ultra HD. Framework ini opsional.

    vfiFilter.framework

    Interpolasi frame video bersifat opsional.

    vvcCodecPlugin.framwork

    Plugin untuk decoding H.266. Framework ini opsional.

    Permasalahan Integrasi Umum

    Cara menggunakan CocoaPods

    Cara menggunakan CocoaPods

    // Pisahkan proyek dari dependensi CocoaPods.
pod deintegrate 

// Perbarui indeks sumber CocoaPods lokal.
// Skenario:
// Perintah ini memastikan Anda dapat memperoleh versi terbaru yang tersedia saat menambahkan dependensi baru.
// Jika versi tertentu dari library tidak tersedia atau versi baru dirilis tetapi tidak muncul di proyek Anda, Anda dapat menjalankan perintah ini untuk memperbarui indeks.
pod repo update

// Perbarui pods dalam proyek Anda.
// Skenario:
// Jalankan perintah ini saat Anda ingin memperbarui semua pods dalam proyek ke versi terbaru yang didukung.
// Jika Anda menentukan rentang versi untuk dependensi dalam Podfile, perintah ini mencoba memperbarui library ke versi yang sesuai dengan rentang tersebut.
pod update

// Melakukan fungsi yang sama seperti pod install, tetapi memperbarui paksa indeks repositori CocoaPods lokal sebelum instalasi.
// Skenario:
// Kami menyarankan Anda menjalankan perintah ini saat menambahkan library baru atau ingin menggunakan versi terbaru library yang ditentukan dalam Podfile. Ini berguna ketika pesan kesalahan menunjukkan bahwa versi library yang diperlukan tidak tersedia.
pod install --repo-update

// Bersihkan cache pod.
// Catatan:
// 1. Membersihkan cache tidak mengubah Podfile.lock atau Podfile Anda. CocoaPods mengunduh ulang library yang diperlukan berdasarkan manifes dan file lock setelah Anda menjalankan pod install atau pod update.
// 2. Membersihkan cache bukan operasi rutin. Lakukan operasi ini hanya saat menghadapi masalah tertentu. Dalam kondisi normal, CocoaPods dapat mengelola cache-nya dengan baik.
pod cache clean --all

    Kode Anda atau kode pihak ketiga yang Anda referensikan mengalami konflik dengan simbol AlivcFFmpeg selama integrasi.

    Solusi:

    • Konflik dengan simbol AlivcFFmpeg: Pertahankan hanya satu AlivcFFmpeg dan hapus dependensi AlivcFFmpeg yang berlebihan. AlivcFFmpeg adalah dependensi kustom yang dikembangkan oleh Alibaba Cloud berdasarkan FFmpeg dan merupakan bagian penting dari SDK Pemutar Video Apsara. Disarankan untuk menghapus dependensi AlivcFFmpeg untuk SDK pihak ketiga dan mempertahankan dependensi AlivcFFmpeg untuk SDK Pemutar Video Apsara. Namun, hal ini dapat menyebabkan kesalahan pada pemutar pihak ketiga.

    Kesalahan Sandbox

    • Permasalahan sebagai berikut:

      截屏2024-12-06 16

    • Solusi:

      Atur User Script SandBoxing di UserSettings menjadi NO.

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

    Integrasi Video Pendek

    Untuk mengintegrasikan SDK pemutar iOS dan SDK video pendek ke dalam proyek Anda, disarankan menggunakan SDK all-in-one iOS untuk integrasi. Hal ini mencegah kesalahan kelas duplikat dan kegagalan kompilasi.

    Untuk masalah lain yang mungkin terjadi saat menggunakan SDK Pemutar Video Apsara beserta solusinya, lihat FAQ tentang Pemutar Video Apsara.

    Dokumen fitur

    Fitur dasar

    Fitur lanjutan