ApsaraVideo Live:Integrasi SDK

Lingkungan Terintegrasi

Unduh paket 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

      Pada proyek Xcode, buka General > Frameworks, Libraries, and Embedded Content dan konfigurasikan metode penyematan untuk setiap framework dependensi sebagai berikut:

      • Embed & Sign: alivcffmpeg.framework, AlivcLibReplayKitExt.framework, AlivcLibRtmp.framework, AlivcLivePusher.framework, AliyunPlayer.framework, artcSource.framework, opencv2.framework

      • Embed Without Signing: AlivcLiveBroadcast.appex

      • Do Not Embed: Accelerate.framework, CoreGraphics.framework, CoreImage.framework, CoreMedia.framework, CoreMotion.framework, CoreVideo.framework, Face3D.framework, FaceDetection.framework, Foundation.framework, Metal.framework, MNN.framework, OpenGLES.framework, pixelai.framework, QuartzCore.framework, queen.framework

   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. Di bagian tersebut, atur metode penyematan untuk framework pihak ketiga seperti alivcffmpeg.framework, AlivcLibRtmp.framework, AlivcLivePusher.framework, AliyunPlayer.framework, artcSource.framework, RtsSDK.framework, dan opencv2.framework menjadi Embed & Sign. Biarkan framework sistem (seperti Accelerate, CoreGraphics, dan CoreMedia) tetap diatur sebagai Do Not Embed. Atur AlivcLiveBroadcast.appex menjadi Embed Without Signing.

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 path 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 Skema Penggunaan dan Integrasi All-in-One Media SDK.

   4. Masukkan perintah berikut di jendela terminal. Setelah perintah pod dijalankan, file proyek dengan ekstensi .xcworkspace akan dihasilkan. File ini berisi SDK yang telah terintegrasi. 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.

   Pada file Info.plist, tambahkan entri Privacy - Camera Usage Description dan Privacy - Microphone Usage Description untuk kamera dan mikrofon. Jika aplikasi perlu melanjutkan pengambilan aliran di latar belakang, aktifkan mode tangkapan audio latar belakang. Untuk melakukannya, pada tab Capabilities proyek Xcode, atur Background Modes ke ON, lalu pilih Audio, AirPlay, and Picture in Picture dalam daftar Modes yang muncul.

4. Nonaktifkan Bitcode.

   SDK tidak mendukung Bitcode. Anda harus menonaktifkan opsi Bitcode di proyek. Untuk melakukannya, di Build Settings proyek Xcode, cari bitcode dan atur Enable Bitcode di bawah Build Options menjadi No.

5. Konfigurasikan lisensi.

   Untuk petunjuknya, lihat Integrasikan lisensi.

Catatan penggunaan

• Untuk informasi API lengkap, lihat Referensi API untuk Edisi Dasar.

• Untuk contoh kode API, lihat Penggunaan fitur.

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.