All Products
Search

This Product

    Apsara Video SDK:Integrasikan SDK untuk iOS

    Document Center

    Apsara Video SDK:Integrasikan SDK untuk iOS

    Last Updated:Apr 25, 2026

    Topik ini menjelaskan cara mengintegrasikan SDK ApsaraVideo MediaBox untuk iOS secara cepat sesuai berbagai skenario bisnis.

    Penting

    Jika Anda melakukan upgrade dari SDK v6.6.0 atau versi sebelumnya ke v6.7.0 atau versi setelahnya, lihat Pembaruan efek retouching terintegrasi pada ApsaraVideo MediaBox SDK V6.7.0.

    Prasyarat

    Item

    Deskripsi

    macOS

    macOS High Sierra 10.13 atau versi lebih baru.

    Xcode

    Langkah-langkah dalam topik ini menggunakan Xcode. Anda dapat mengunduhnya dari Xcode.

    Versi iOS

    iOS 9.0 atau versi lebih baru.

    Langkah 1: Integrasikan SDK

    Integrasi pod (Direkomendasikan)

    1. Di direktori proyek Anda, jalankan pod init untuk membuat Podfile.

    2. Tambahkan dependensi SDK ke Podfile.

      Versi SDK dalam kode berikut hanya sebagai contoh. Untuk versi terbaru, lihat SDK berdasarkan skenario.

      # Integrasikan salah satu dari empat SDK berikut berdasarkan skenario bisnis Anda.

# 1. SDK all-in-one Standar: player + real-time streaming (RTS) + live streaming standar + video pendek + co-streaming real-time communication (RTC) + retouching dasar
pod 'AliVCSDK_Standard', '7.11.0'
# 2. SDK live streaming Dasar: player + pengambilan aliran live + retouching dasar + real-time streaming (RTS)
pod 'AliVCSDK_BasicLive', '7.11.0'   
# 3. SDK skenario video pendek: player + video pendek + retouching dasar
pod 'AliVCSDK_UGC', '7.11.0'  
# 4. SDK live streaming Interaktif: player + real-time streaming (RTS) + pengambilan aliran live + co-streaming real-time communication (RTC) + retouching dasar
pod 'AliVCSDK_InteractiveLive', '7.11.0'

    3. Jalankan perintah pod install untuk menginstal SDK.

      Setelah perintah dijalankan, file .xcworkspace akan dihasilkan. Kehadiran file ini menandakan bahwa integrasi SDK telah selesai.

    Integrasi manual

    Catatan

    • Sebelum mengirimkan aplikasi Anda ke App Store, Anda harus menghapus arsitektur x86 untuk simulator dari framework dinamis. Jika tidak, pengiriman Anda akan ditolak. Integrasi pod menangani hal ini secara otomatis.

    • Jika terjadi error kompilasi, buka TARGETS > Build Settings > Apple Clang - Language di proyek Xcode Anda dan atur Compile Sources As menjadi Objective-C++.

    1. Unduh dan ekstrak SDK berdasarkan skenario yang diperlukan untuk iOS.

    2. Tambahkan dependensi SDK.

      Di proyek Xcode Anda, buka TARGETS > General > Frameworks, Libraries, and Embedded Content. Tambahkan dependensi AliVCSDK_***.framework, alivcffmpeg.framework, dan dependensi lain yang diperlukan dari paket SDK. Untuk setiap dependensi yang diimpor, atur opsi Embed menjadi Embed & Sign.

    3. Tambahkan dependensi library lainnya.

      Di proyek Xcode Anda, buka TARGETS > General > Frameworks, Libraries, and Embedded Content. Impor dependensi MobileCoreServices.framework, SystemConfiguration.framework, CoreTelephony.framework, CoreMedia.framework, VideoToolbox.framework, AVFoundation.framework, dan libresolv.tbd.

    4. Tambahkan bundle resource (jika disertakan dalam paket SDK).

      Tambahkan bundle resource AliyunVideoSDKPro.bundle ke proyek Anda.

    Langkah 2: Konfigurasikan otorisasi lisensi

    Untuk integrasi SDK pertama kali, Anda harus mengelola lisensi dan mengonfigurasi otorisasi lisensi.

    Langkah 3: Konfigurasikan izin aplikasi

    1. Di proyek Xcode Anda, buka TARGETS > Build Settings > Linking. Di bidang Other Linker Flags, tambahkan opsi -ObjC.

    2. Di proyek Xcode Anda, buka TARGETS > Build Settings > Build Options dan atur Enable Bitcode menjadi NO.

    3. Ubah file Info.plist untuk mengonfigurasi izin aplikasi.

      Privacy - Camera Usage Description
Privacy - Microphone Usage Description
Privacy - Photo Library Usage Description

    FAQ

    Untuk troubleshooting, lihat bagian spesifik fitur di FAQ.