ApsaraVideo Live：Integrasi SDK

Persyaratan lingkungan

Unduh Push SDK

Integrasi Push SDK

Setelah Anda mengintegrasikan Push SDK secara manual atau menggunakan CocoaPods, Anda juga harus meminta izin, menonaktifkan Bitcode, dan meninjau instruksi penggunaan.

Prosedur ini memberikan instruksi untuk integrasi manual dan integrasi CocoaPods. Ikuti langkah-langkah yang sesuai dengan metode pilihan Anda.

1. Integrasi Manual

   1. Buat proyek uji SDK bernama App > DemoPush.

   2. Seret file berikut ke dalam proyek Xcode Anda:

      • AlivcLibReplayKitExt.framework

      • AlivcLivePusher.framework

      Untuk menggunakan efek retouching dan stiker, Anda perlu menyeret file berikut:

      • queen.framework

      • openvc2.framework

      • MNN.framework

      • AliyunQueenUIKit.framework

      Jika proyek Anda memiliki dependensi pada ApsaraVideo Player SDK, Anda juga perlu menyeret file berikut:

      • RtsSDK.framework

      • AliyunPlayer.framework

      • artcSource.framework

      • alivcffmpeg.framework

   3. Pilih Copy items if needed dan klik Finish.

   4. Setelah Anda mengimpor SDK, tambahkan dependensinya di bawah Xcode > General > Frameworks, Libraries, and Embedded Content.

2. Integrasi CocoaPods

   1. Di jendela Terminal, jalankan perintah berikut untuk menginstal CocoaPods.

      Penting

      Pastikan bahwa lingkungan Ruby telah diatur di Mac Anda sebelum menginstal CocoaPods.

      sudo gem install cocoapods

   2. Navigasikan ke direktori proyek Anda dan jalankan perintah berikut di jendela Terminal untuk membuat Podfile.

      pod init

   3. Edit Podfile untuk menambahkan dependensi Push SDK. Jika Anda memerlukan pemutaran langsung, Anda juga dapat menambahkan dependensi ApsaraVideo Player SDK.

      # Push SDK Basic Edition
      pod 'AlivcLivePusher', '~> x.y.z'

      Catatan

      • x.y.z adalah nomor versi Push SDK. Ganti `x.y.z` dengan nomor versi terbaru dari Unduhan SDK, seperti 7.4.0.

      • Push SDK dan Player SDK (AliyunPlayer) tidak dapat diintegrasikan secara bersamaan. Untuk mengintegrasikan kedua SDK tersebut, Anda harus menggunakan ApsaraVideo MediaBox SDK. Untuk informasi lebih lanjut, lihat Skenario dan Integrasi ApsaraVideo MediaBox SDK.

   4. Jalankan perintah berikut di jendela Terminal. Setelah perintah selesai, file .xcworkspace akan dibuat. Klik dua kali file ini untuk membuka proyek Anda di Xcode.

      pod install

      atau

      pod update

3. Minta Izin

   Catatan

   Anda harus meminta izin untuk kamera dan mikrofon.

   Dalam file Info.plist, tambahkan kunci Privacy - Camera Usage Description dan Privacy - Microphone Usage Description untuk meminta akses ke kamera dan mikrofon.Jika aplikasi Anda perlu melanjutkan stream ingest saat berada di latar belakang, aktifkan mode audio latar belakang dengan memilih Audio, AirPlay, and Picture in Picture, seperti yang ditunjukkan pada gambar.

4. Nonaktifkan Bitcode

   SDK tidak mendukung Bitcode. Nonaktifkan opsi ini di proyek Anda dengan mengatur Enable Bitcode ke NO, seperti yang ditunjukkan pada gambar berikut.

5. Konfigurasikan Lisensi

   Untuk informasi lebih lanjut, lihat Integrasi lisensi untuk Push SDK.

Catatan penggunaan

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

• Untuk contoh kode API, lihat Penggunaan Fitur.

FAQ

Compilation Error

Jika Anda menerima kesalahan 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.

Missing Queen Dependency Libraries During Compilation

Jika library dependensi untuk Queen hilang selama integrasi manual, lihat dokumentasi Queen_SDK_iOS untuk menambahkan library dependensi yang diperlukan.