全部产品
Search
文档中心

ApsaraVideo Live:Integrasi SDK

更新时间:Feb 05, 2026

Topik ini menjelaskan cara mengintegrasikan Push SDK untuk iOS.

Lingkungan Terintegrasi

Item

Persyaratan

Versi OS

iOS 8.0 atau yang lebih baru

Model ponsel

iPhone 7 atau yang lebih baru

Arsitektur CPU

ARM64 atau ARMv7

Tool integrasi

Xcode 8.0 atau yang lebih baru

bitcode

Dimatikan

Unduh paket SDK

Catatan

Setiap rilis Push SDK untuk iOS dikompilasi dalam dua versi: versi ARM yang hanya mendukung debugging pada perangkat fisik dan versi ARM & simulator yang mendukung debugging baik pada perangkat fisik maupun simulator. Anda harus menggunakan versi ARM di lingkungan produksi.

Unduh versi Push SDK untuk iOS yang diperlukan dari unduhan SDK. Edisi Dasar Push SDK terletak di folder AlivcLivePusher dalam paket yang telah diekstraksi, seperti yang ditunjukkan pada gambar berikut:006

Konten file yang ditampilkan pada gambar sebelumnya memiliki perbedaan sebagai berikut:

Nama file

Deskripsi

AlivcLivePusherSDK/arm

Versi ARM dari Edisi Dasar Push SDK.

AlivcLivePusherSDK/arm&simulator

Versi ARM & simulator dari Edisi Dasar Push SDK.

Integrasikan Push SDK

Setelah Anda mengintegrasikan Push SDK secara manual atau menggunakan pod, Anda juga harus meminta izin dan menonaktifkan Bitcode.

Jika Anda memilih untuk mengintegrasikan Push SDK secara manual, ikuti langkah-langkah integrasi manual. Jika Anda memilih untuk mengintegrasikan Push SDK menggunakan pod, ikuti langkah-langkah integrasi pod.

  1. Integrasi manual:

    1. Buat proyek uji SDK: App > DemoPush.

    2. Seret file-file berikut ke proyek Xcode Anda:

      • AlivcLibReplayKitExt.framework

      • AlivcLivePusher.framework

      Untuk menggunakan efek Retouching dan stiker, seret juga file-file berikut:

      • queen.framework

      • openvc2.framework

      • MNN.framework

      • AliyunQueenUIKit.framework

      Untuk bergantung pada versi SDK Pemutar Video Apsara, seret juga file-file berikut:

      • RtsSDK.framework

      • AliyunPlayer.framework

      • artcSource.framework

      • alivcffmpeg.framework播放器SDK-新

    3. Pilih Copy items if needed, lalu klik Finish.勾选

    4. Setelah Anda mengimpor SDK, tambahkan dependensi SDK di Xcode > General > Frameworks, Libraries, and Embedded Content.SDK依赖

  2. Integrasi pod:

    1. Di jendela terminal, masukkan perintah berikut untuk menginstal CocoaPods.

      Penting

      Sebelum menginstal CocoaPods, pastikan lingkungan Ruby telah terinstal di Mac Anda.

      sudo gem install cocoapods
    2. Buka direktori proyek dan masukkan perintah berikut di jendela terminal untuk membuat file Podfile.

      pod init
    3. Edit file Podfile untuk menambahkan dependensi Push SDK. Jika Anda memerlukan pemutaran siaran langsung, Anda juga dapat menambahkan dependensi SDK Pemutar Video Apsara.

      # Edisi Dasar Push SDK
      pod 'AlivcLivePusher', '~> x.y.z'
      Catatan
      • x.y.z merepresentasikan nomor versi Push SDK. Ganti placeholder ini dengan nomor versi terbaru dari halaman Unduhan SDK, misalnya 7.4.0.

      • Push SDK tidak dapat diintegrasikan bersamaan dengan Player SDK (AliyunPlayer). Untuk mengintegrasikan Push SDK dan Player SDK sekaligus, gunakan All-in-One Media SDK. Untuk informasi selengkapnya, lihat Skenario dan Integrasi All-in-One Media SDK.

    4. Masukkan perintah berikut di jendela terminal. Setelah perintah pod dieksekusi, file proyek dengan ekstensi .xcworkspace akan dihasilkan. File ini berisi SDK yang telah diintegrasikan. Klik ganda file tersebut untuk memperbarui dan menginstal SDK.

      pod install

      atau

      pod update
  3. Minta izin.

    Catatan

    Anda harus menambahkan izin akses kamera dan mikrofon.

    Di file Info.plist, tambahkan izin Privacy - Camera Usage Description dan Privacy - Microphone Usage Description untuk kamera dan mikrofon.摄像头和麦克风权限Jika aplikasi perlu melanjutkan pengambilan aliran di latar belakang, aktifkan mode penangkapan audio latar belakang. Untuk melakukannya, pilih Audio, AirPlay, and Picture in Picture, seperti yang ditunjukkan pada gambar.后台音频采集

  4. Nonaktifkan Bitcode.

    SDK tidak mendukung Bitcode. Anda harus menonaktifkan opsi Bitcode di proyek. Untuk melakukannya, atur Enable Bitcode ke NO, seperti yang ditunjukkan pada gambar.关闭bitcode

  5. Konfigurasikan lisensi.

    Untuk petunjuknya, lihat Integrasikan lisensi.

Catatan Penggunaan

FAQ

Error kompilasi

Jika Anda menerima error kompilasi Building for iOS, but the linked and embedded framework XXX.framework' was built for iOS + iOS Simulator, lakukan langkah-langkah berikut:

  1. Klik menu Xcode.

  2. Pilih File > Workspace Settings untuk membuka kotak dialog pengaturan.

  3. Ubah Build System menjadi Legacy Build System.

Library dependensi Queen tidak ditemukan saat kompilasi

Jika library dependensi Queen tidak ditemukan selama integrasi manual, lihat dokumen Queen_SDK_iOS untuk menambahkan library yang diperlukan.