Langkah 4: Integrasikan IVS Siaran SDK - Amazon IVS

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

Langkah 4: Integrasikan IVS Siaran SDK

IVSmenyediakan siaran SDK untuk web, Android, dan iOS yang dapat Anda integrasikan ke dalam aplikasi Anda. Siaran SDK digunakan untuk mengirim dan menerima video. Jika Anda telah mengonfigurasi RTMP Ingest untuk tahap Anda, Anda dapat menggunakan encoder apa pun yang dapat disiarkan ke RTMP titik akhir (misalnya, OBS atau ffmpeg).

Pada bagian ini, kami menulis aplikasi sederhana yang memungkinkan dua atau lebih peserta untuk berinteraksi secara real time. Langkah-langkah di bawah ini memandu Anda melalui pembuatan aplikasi yang disebut BasicRealTime. Kode aplikasi lengkap aktif CodePen dan GitHub:

Web

Mengatur File

Untuk memulai, atur file Anda dengan membuat folder dan file awal HTML dan JS:

mkdir realtime-web-example cd realtime-web-example touch index.html touch app.js

Anda dapat menginstal siaran SDK menggunakan tag skrip atau npm. Contoh kami menggunakan tag skrip untuk kesederhanaan tetapi mudah dimodifikasi jika Anda memilih untuk menggunakan npm nanti.

Menggunakan Tag Skrip

Siaran Web SDK didistribusikan sebagai JavaScript perpustakaan dan dapat diambil di https://web-broadcast.live-video.net/1.17.0/ amazon-ivs-web-broadcast .js.

Saat dimuat melalui <script> tag, pustaka mengekspos variabel global dalam lingkup jendela bernamaIVSBroadcastClient.

Menggunakan npm

Untuk menginstal paket npm:

npm install amazon-ivs-web-broadcast

Anda sekarang dapat mengakses IVSBroadcastClient objek:

const { Stage } = IVSBroadcastClient;

Android

Buat Proyek Android

  1. Di Android Studio, buat Proyek Baru.

  2. Pilih Aktivitas Tampilan Kosong.

    Catatan: Di beberapa versi Android Studio yang lebih lama, aktivitas berbasis Tampilan disebut Empty Activity. Jika jendela Android Studio menampilkan Aktivitas Kosong dan tidak menampilkan Aktivitas Tampilan Kosong, pilih Aktivitas Kosong. Jika tidak, jangan pilih Aktivitas Kosong, karena kita akan menggunakan View APIs (bukan Jetpack Compose).

  3. Beri nama proyek Anda, lalu pilih Selesai.

Instal Siaran SDK

Untuk menambahkan library siaran IVS Android Amazon ke lingkungan pengembangan Android Anda, tambahkan pustaka ke build.gradle file modul Anda, seperti yang ditunjukkan di sini (untuk versi terbaru IVS siaran AmazonSDK). Dalam proyek yang lebih baru, mavenCentral repositori mungkin sudah disertakan dalam settings.gradle file Anda, jika itu masalahnya, Anda dapat menghilangkan bloknya. repositories Untuk sampel kami, kami juga perlu mengaktifkan pengikatan data di android blok.

android { dataBinding.enabled true } repositories { mavenCentral() } dependencies { implementation 'com.amazonaws:ivs-broadcast:1.23.0:stages@aar' }

Bergantian, untuk menginstal secara SDK manual, unduh versi terbaru dari lokasi ini:

https://search.maven.org/artifact/com.amazonaws/ivs-broadcast

iOS

Buat Proyek iOS

  1. Buat proyek Xcode baru.

  2. Untuk Platform, pilih iOS.

  3. Untuk Aplikasi, pilih Aplikasi.

  4. Masukkan Nama Produk aplikasi Anda, lalu pilih Berikutnya.

  5. Pilih (navigasikan ke) direktori tempat menyimpan proyek, lalu pilih Buat.

Selanjutnya Anda perlu membawa masukSDK. Kami menyarankan Anda mengintegrasikan siaran SDK melalui CocoaPods. Atau, Anda dapat menambahkan kerangka kerja secara manual ke proyek Anda. Kedua metode dijelaskan di bawah ini.

Direkomendasikan: Instal Broadcast SDK (CocoaPods)

Dengan asumsi nama proyek AndaBasicRealTime, buat Podfile di folder proyek dengan konten berikut dan kemudian jalankanpod install:

target 'BasicRealTime' do # Comment the next line if you don't want to use dynamic frameworks use_frameworks! # Pods for BasicRealTime pod 'AmazonIVSBroadcast/Stages' end

Pendekatan Alternatif: Instal Kerangka Secara Manual

  1. Unduh versi terbaru dari https://broadcast.live-video.net/1.23.0/A mazonIVSBroadcast -Stages.xcFramework.zip.

  2. Ekstrak isi arsip. AmazonIVSBroadcast.xcframeworkberisi 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:

    Instal iOS secara manual.

Konfigurasikan Izin

Anda perlu memperbarui proyek Anda Info.plist untuk menambahkan dua entri baru untuk NSCameraUsageDescription danNSMicrophoneUsageDescription. Untuk nilainya, berikan penjelasan yang dihadapi pengguna tentang mengapa aplikasi Anda meminta akses kamera dan mikrofon.

Konfigurasikan izin iOS.