全部产品
Search
文档中心

Apsara Video SDK:iOS

更新时间:Dec 06, 2025

Topik ini menjelaskan cara mengintegrasikan SDK MediaBox untuk audio dan video pada iOS secara cepat dalam berbagai skenario bisnis.

Catatan

Untuk melakukan upgrade dari versi SDK v6.6.0 atau lebih lama ke v6.7.0 atau lebih baru, lihat Pengumuman tentang perubahan integrasi untuk retouching dan efek di A/V Terminal SDK V6.7.0.

Prasyarat

Kategori

Deskripsi

macOS

macOS High Sierra 10.13 atau yang lebih baru.

Xcode

Prosedur dalam topik ini didasarkan pada Xcode. Unduh di: Xcode.

Versi iOS

iOS 9.0 atau yang lebih baru.

Langkah 1: Integrasikan SDK

Integrasikan menggunakan CocoaPods (Direkomendasikan)

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

  2. Ubah Podfile untuk menambahkan dependensi SDK.

    Nomor versi SDK dalam topik ini hanya sebagai referensi. Untuk mendapatkan versi terbaru, lihat SDK Berdasarkan Skenario.

    # Pilih dan integrasikan salah satu dari empat SDK berikut berdasarkan kebutuhan bisnis Anda.
    
    # 1. SDK All-in-One Standar: Player + Real-Time Streaming (RTS) + Live + Short Video + RTC Co-streaming + Retouching Dasar
    pod 'AliVCSDK_Standard', '7.9.1'
    # 2. SDK Live Dasar: Player + Stream Ingest + Retouching Dasar + RTS
    pod 'AliVCSDK_BasicLive', '7.9.1'   
    # 3. SDK Short Video: Player + Short Video + Retouching Dasar
    pod 'AliVCSDK_UGC', '7.9.1'  
    # 4. SDK Live Interaktif: Player + RTS + Stream Ingest + RTC Co-streaming + Retouching Dasar
    pod 'AliVCSDK_InteractiveLive', '7.9.1'
  3. Jalankan perintah pod install untuk menginstal SDK.

    Setelah perintah dijalankan, file *.xcworkspace akan dihasilkan, yang menandakan bahwa SDK telah berhasil diintegrasikan.

Integrasikan SDK secara manual

Catatan
  • Untuk mengirimkan aplikasi Anda ke App Store, Anda harus menghapus versi emulator (arsitektur x86) dari library dinamis. Jika tidak, pengiriman akan ditolak. Metode integrasi CocoaPods menangani hal ini secara otomatis.

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

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

  2. Tambahkan dependensi SDK.

    Di proyek Xcode Anda, buka Targets > General > Frameworks, Libraries, and Embedded Content. Impor dependensi AliVCSDK_***.framework dan alivcffmpeg.framework. Impor dependensi lainnya dari paket SDK sesuai kebutuhan. Atur 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 paket SDK menyertakannya.

    Impor dependensi AliyunVideoSDKPro.bundle ke dalam proyek.

Langkah 2: Konfigurasikan lisensi

Saat pertama kali mengintegrasikan SDK, Anda harus mengelola lisensi dan mengonfigurasi otorisasi lisensi.

Langkah 3: Konfigurasikan izin aplikasi

  1. Di proyek Xcode Anda, buka Targets > Build Settings > Linking > Other Linker Flags. Tambahkan opsi linker -ObjC.

  2. Di proyek Xcode Anda, buka Targets > Build Settings > Build Options > Enable Bitcode. Atur nilainya 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 informasi lebih lanjut, lihat bagian spesifik fitur dalam FAQ.