Memulai dengan SDK Siaran iOS IVS | Streaming Waktu Nyata - Amazon IVS
Instal PerpustakaanPermintaan IzinNonaktifkan Aplikasi Idle Timer

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai dengan SDK Siaran iOS IVS | Streaming Waktu Nyata

Dokumen ini membawa Anda melalui langkah-langkah yang terlibat dalam memulai dengan SDK siaran iOS streaming real-time IVS.

Instal Perpustakaan

Kami menyarankan Anda mengintegrasikan SDK siaran melalui Swift Package Manager. (Atau, Anda dapat mengintegrasikan melalui CocoaPods atau menambahkan kerangka kerja secara manual ke proyek Anda.)

Direkomendasikan: Integrasikan Broadcast SDK (Swift Package Manager)

  1. Unduh file Package.swift dari https://broadcast.live-video.net/1.38.0/Package.swift.

  2. Dalam proyek Anda, buat direktori baru bernama Amazon IVSBroadcast dan tambahkan ke kontrol versi.

  3. Tempatkan file Package.swift yang diunduh di direktori baru.

  4. Di Xcode, buka File > Add Package Dependencies dan pilih Add Local...

  5. Arahkan ke dan pilih IVSBroadcast direktori Amazon yang Anda buat, lalu pilih Add Package.

  6. Saat diminta untuk Memilih Produk Paket untuk Amazon IVSBroadcast, pilih IVSBroadcastTahapan Amazon sebagai Produk Package Anda dengan menetapkan target aplikasi Anda di bagian Tambahkan ke Target.

  7. Pilih Add Package.

Penting: SDK siaran streaming real-time IVS mencakup semua fitur SDK siaran streaming latensi rendah IVS. Tidak mungkin untuk mengintegrasikan keduanya SDKs dalam proyek yang sama.

Pendekatan Alternatif: Integrasikan Broadcast SDK () CocoaPods

CocoaPods Penting: dalam mode pemeliharaan (hanya perbaikan keamanan) dan setelah Desember 2026, tidak ada paket atau pembaruan baru yang dapat dipublikasikan ke repositori. CocoaPods Paket yang ada akan tetap tersedia tetapi dibekukan. Kami merekomendasikan menggunakan Swift Package Manager untuk semua proyek baru.

Fungsionalitas real-time diterbitkan sebagai subspec dari SDK siaran Streaming Latensi Rendah iOS. Ini agar pelanggan dapat memilih untuk memasukkan atau mengecualikannya berdasarkan kebutuhan fitur mereka. Termasuk itu meningkatkan ukuran paket.

Rilis diterbitkan melalui CocoaPods di bawah namaAmazonIVSBroadcast. Tambahkan dependensi ini ke Podfile Anda:

pod 'AmazonIVSBroadcast/Stages'

Jalankan pod install dan SDK akan tersedia di .xcworkspace Anda.

Penting: SDK siaran streaming real-time IVS (yaitu, dengan subspec panggung) mencakup semua fitur SDK siaran streaming latensi rendah IVS. Tidak mungkin untuk mengintegrasikan keduanya SDKs dalam proyek yang sama. Jika Anda menambahkan subspec stage via CocoaPods ke proyek Anda, pastikan untuk menghapus baris lain di Podfile yang berisi. AmazonIVSBroadcast Misalnya, tidak memiliki kedua baris ini di Podfile Anda:

pod 'AmazonIVSBroadcast'
pod 'AmazonIVSBroadcast/Stages'

Pendekatan Alternatif: Instal Kerangka Secara Manual

  1. Unduh versi terbaru dari https://broadcast.live-video.net/1.38.0/AmazonIVSBroadcast-Stages.xcframework.zip.

  2. Ekstrak konten arsip. AmazonIVSBroadcast.xcframework berisi SDK untuk perangkat dan simulator.

  3. Sematkan AmazonIVSBroadcast.xcframework dengan menyeretnya ke bagian Frameworks, Libraries, dan Embedded Content pada tab General untuk target aplikasi Anda.

    Bagian Kerangka Kerja, Pustaka, dan Konten Tersemat pada tab Umum untuk target aplikasi Anda.

Permintaan Izin

Aplikasi Anda harus meminta izin untuk mengakses kamera dan mikrofon pengguna. (Ini tidak khusus untuk Amazon IVS; diperlukan untuk aplikasi apa pun yang membutuhkan akses ke kamera dan mikrofon.)

Di sini, kami memeriksa apakah pengguna telah memberikan izin dan, jika tidak, kami memintanya:

switch AVCaptureDevice.authorizationStatus(for: .video) {
case .authorized: // permission already granted.
case .notDetermined:
   AVCaptureDevice.requestAccess(for: .video) { granted in
       // permission granted based on granted bool.
   }
case .denied, .restricted: // permission denied.
@unknown default: // permissions unknown.
}

Anda perlu melakukan ini untuk keduanya .video dan jenis .audio media, jika Anda ingin akses ke kamera dan mikrofon, masing-masing.

Anda juga perlu menambahkan entri untuk NSCameraUsageDescription dan NSMicrophoneUsageDescription ke AndaInfo.plist. Jika tidak, aplikasi Anda akan macet saat mencoba meminta izin.

Nonaktifkan Aplikasi Idle Timer

Ini adalah langkah opsional, tetapi direkomendasikan. Ini mencegah perangkat Anda tertidur saat menggunakan SDK siaran, yang akan mengganggu siaran.

override func viewDidAppear(_ animated: Bool) {
   super.viewDidAppear(animated)
   UIApplication.shared.isIdleTimerDisabled = true
}
override func viewDidDisappear(_ animated: Bool) {
   super.viewDidDisappear(animated)
   UIApplication.shared.isIdleTimerDisabled = false
}