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

Memulai dengan IVS Android Broadcast SDK | Streaming Real-Time

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

Instal Perpustakaan

Ada beberapa cara untuk menambahkan pustaka siaran Android Amazon IVS ke lingkungan pengembangan Android Anda: gunakan Gradle secara langsung, gunakan katalog versi Gradle, atau instal SDK secara manual.

Gunakan Gradle secara langsung: Tambahkan pustaka ke build.gradle file modul Anda, seperti yang ditunjukkan di sini (untuk versi terbaru SDK siaran IVS):

repositories {
    mavenCentral()
}
 
dependencies {
     implementation 'com.amazonaws:ivs-broadcast:1.45.0:stages@aar'
}

Gunakan katalog versi Gradle: Pertama sertakan ini dalam build.gradle file modul Anda:

implementation(libs.ivs){
   artifact {
      classifier = "stages"
      type = "aar"
   }
}

Kemudian sertakan yang berikut dalam libs.version.toml file (untuk versi terbaru SDK siaran IVS):

[versions]
ivs="1.45.0"

[libraries]
ivs = {module = "com.amazonaws:ivs-broadcast", version.ref = "ivs"}

Instal SDK secara manual: Unduh versi terbaru dari lokasi ini:

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

Pastikan untuk mengunduh aar dengan -stages ditambahkan.

Juga izinkan kontrol SDK atas speakerphone: Terlepas dari metode instalasi yang Anda pilih, tambahkan juga izin berikut ke manifes Anda, untuk mengizinkan SDK mengaktifkan dan menonaktifkan speakerphone:

<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>

Menggunakan SDK dengan Simbol Debug

Kami juga menerbitkan versi SDK siaran Android yang menyertakan simbol debug. Anda dapat menggunakan versi ini untuk meningkatkan kualitas laporan debug (pelacakan tumpukan) di Firebase Crashlytics, jika Anda mengalami crash di IVS broadcast SDK; yaitu. libbroadcastcore.so Saat Anda melaporkan crash ini ke tim IVS SDK, jejak tumpukan berkualitas lebih tinggi memudahkan untuk memperbaiki masalah.

Untuk menggunakan versi SDK ini, masukkan yang berikut ini di file build Gradle Anda:

implementation "com.amazonaws:ivs-broadcast:$version:stages-unstripped@aar"

Gunakan baris di atas alih-alih ini:

implementation "com.amazonaws:ivs-broadcast:$version:stages@aar"

Mengunggah Simbol ke Firebase Crashlytics

Pastikan file build Gradle sudah disiapkan untuk Firebase Crashlytics. Ikuti instruksi Google di sini:

https://firebase.google.com/docs/crashlytics/ndk-reports

Pastikan untuk memasukkan com.google.firebase:firebase-crashlytics-ndk sebagai ketergantungan.

Saat membuat aplikasi untuk rilis, plugin Firebase Crashlytics harus mengunggah simbol secara otomatis. Untuk mengunggah simbol secara manual, jalankan salah satu dari berikut ini:

gradle uploadCrashlyticsSymbolFileRelease

./gradlew uploadCrashlyticsSymbolFileRelease

(Tidak ada salahnya jika simbol diunggah dua kali, baik secara otomatis maupun manual.)

Mencegah Rilis .apk Anda Menjadi Lebih Besar

Sebelum mengemas .apk file rilis, Plugin Gradle Android secara otomatis mencoba menghapus informasi debug dari pustaka bersama (termasuk pustaka SDK siaran IVS). libbroadcastcore.so Namun, terkadang ini tidak terjadi. Akibatnya, .apk file Anda bisa menjadi lebih besar dan Anda bisa mendapatkan pesan peringatan dari Plugin Android Gradle bahwa itu tidak dapat menghapus simbol debug dan mengemas .so file apa adanya. Jika ini terjadi, lakukan hal berikut:

Untuk informasi selengkapnya, lihat laporan masalah ini.

Minta 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, memintanya:

final String[] requiredPermissions =
         { Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO };

for (String permission : requiredPermissions) {
    if (ContextCompat.checkSelfPermission(this, permission) 
                != PackageManager.PERMISSION_GRANTED) {
        // If any permissions are missing we want to just request them all.
        ActivityCompat.requestPermissions(this, requiredPermissions, 0x100);
        break;
    }
}

Di sini, kami mendapatkan respons pengguna:

@Override
public void onRequestPermissionsResult(int requestCode, 
                                      @NonNull String[] permissions,
                                      @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode,
               permissions, grantResults);
    if (requestCode == 0x100) {
        for (int result : grantResults) {
            if (result == PackageManager.PERMISSION_DENIED) {
                return;
            }
        }
        setupBroadcastSession();
    }
}