Unduh SDK WebRTC untuk Android Membangun WebRTC SDK di Android Jalankan Aplikasi Sampel Android Konfigurasikan Amazon Cognito untuk Android WebRTC SDK

WebRTC SDK for Android

step-by-step Petunjuk berikut menjelaskan cara mengunduh, membuat, dan menjalankan Kinesis Video Streams dengan WebRTC SDK for Android dan sampelnya yang sesuai.

catatan

Kinesis Video Streams tidak mendukung alamat IPv6 di Android. Untuk informasi selengkapnya dan langkah-langkah tentang menonaktifkan IPv6 di perangkat Android Anda, lihat https://support.surfshark.com/hc/en-us/articles/360011828279-H -IPv6-on-Android-. ow-to-disable

Unduh SDK WebRTC untuk Android

Untuk mengunduh SDK WebRTC di Android, jalankan perintah berikut:


$ git clone https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-android.git

Membangun WebRTC SDK di Android

Untuk membangun SDK WebRTC di Android, selesaikan langkah-langkah berikut:

Impor Android WebRTC SDK ke lingkungan pengembangan terintegrasi (IDE) Android Studio dengan membuka dengan Open as Project. amazon-kinesis-video-streams-webrtc-sdk-android/build.gradle
Jika Anda membuka proyek untuk pertama kalinya, secara otomatis akan disinkronkan. Jika tidak - memulai sinkronisasi. Ketika Anda melihat kesalahan build, pilih untuk menginstal SDK yang diperlukan dengan memilih Instal paket SDK yang hilang, lalu pilih Terima dan selesaikan penginstalan.
Konfigurasikan setelan Amazon Cognito (kumpulan pengguna dan kumpulan identitas). Untuk langkah-langkah detail, lihatKonfigurasikan Amazon Cognito untuk Android WebRTC SDK. Ini menghasilkan pengaturan autentikasi dan otorisasi yang diperlukan untuk membangun Android WebRTC SDK.

Di IDE Android Anda, buka awsconfiguration.json (darisrc/main/res/raw/). File terlihat seperti berikut:


{
  "Version": "1.0",
  "CredentialsProvider": {
    "CognitoIdentity": {
      "Default": {
        "PoolId": "REPLACE_ME",
        "Region": "REPLACE_ME"
      }
    }
  },
  "IdentityManager": {
    "Default": {}
  },
  "CognitoUserPool": {
    "Default": {
      "AppClientSecret": "REPLACE_ME",
      "AppClientId": "REPLACE_ME",
      "PoolId": "REPLACE_ME",
      "Region": "REPLACE_ME"
    }
  }
}

Perbarui awsconfiguration.json dengan nilai yang dihasilkan dengan menjalankan langkah-langkah diKonfigurasikan Amazon Cognito untuk Android WebRTC SDK.

Pastikan perangkat Android Anda terhubung ke komputer tempat Anda menjalankan IDE Android. Di Android IDE, pilih perangkat yang terhubung lalu buat dan jalankan WebRTC Android SDK.

Langkah ini menginstal aplikasi yang dipanggil AWSKinesisVideoWebRTCDemoApp di perangkat Android Anda. Dengan menggunakan aplikasi ini, Anda dapat memverifikasi streaming audio/video WebRTC langsung antara klien perangkat seluler, web, dan IoT.

Jalankan Aplikasi Sampel Android

Selesaikan langkah-langkah berikut:

Di perangkat Android Anda, buka AWSKinesisVideoWebRTCDemoAppdan masuk menggunakan akun baru (dengan membuatnya terlebih dahulu) atau akun Amazon Cognito yang sudah ada.
Masuk AWSKinesisVideoWebRTCDemoApp, navigasikan ke halaman Konfigurasi Saluran dan buat saluran pensinyalan baru atau pilih yang sudah ada.

catatan
Saat ini, dengan menggunakan contoh aplikasi di SDK ini, Anda hanya dapat menjalankan satu saluran pensinyalan. AWSKinesisVideoWebRTCDemoApp
Opsional: pilih ID Klien unik jika Anda ingin terhubung ke saluran ini sebagai penampil. ID klien hanya diperlukan jika beberapa pemirsa terhubung ke saluran. Ini membantu master saluran mengidentifikasi masing-masing pemirsa.
Pilih Wilayah AWS dan apakah Anda ingin mengirim data audio atau video, atau keduanya.
Untuk memverifikasi peer-to-peer streaming, lakukan salah satu hal berikut:

catatan
Pastikan Anda menentukan nama saluran pensinyalan, AWS wilayah, ID penampil, dan ID AWS akun yang sama pada semua klien yang Anda gunakan dalam demo ini.
- P eer-to-peer streaming antara dua perangkat Android: master dan viewer
  - Menggunakan prosedur di atas, unduh, buat, dan jalankan Android WebRTC SDK di dua perangkat Android.
  - Buka AWSKinesisVideoWebRTCDemoAppdi satu perangkat Android dalam mode master (pilih MULAI MASTER) untuk memulai sesi baru (saluran pensinyalan).
    
    catatan
    Saat ini, hanya ada satu master untuk saluran pensinyalan tertentu.
  - Buka AWSKinesisVideoWebRTCDemoAppdi perangkat Android kedua Anda dalam mode penampil untuk terhubung ke saluran pensinyalan (sesi) yang dimulai pada langkah di atas (pilih MULAI PENAMPIL).
    
    Verifikasi bahwa pemirsa dapat melihat data audio/video master.
- eer-to-peer Streaming P antara master SDK yang disematkan dan penampil perangkat Android
  - Unduh, buat, dan jalankan mode master WebRTC SDK di C untuk Perangkat Tertanam di perangkat kamera.
  - Menggunakan prosedur di atas, unduh, buat, dan jalankan Android WebRTC SDK di perangkat Android. Buka AWSKinesisVideoWebRTCDemoAppdi perangkat Android ini dalam mode penampil dan verifikasi bahwa penampil dapat melihat data audio/video master SDK yang disematkan.
- P eer-to-peer streaming antara perangkat Android sebagai master dan browser web sebagai penampil
  - Menggunakan prosedur di atas, unduh, buat, dan jalankan Android WebRTC SDK di perangkat Android. Buka AWSKinesisVideoWebRTCDemoAppdi perangkat Android ini dalam mode master (pilih MULAI MASTER) untuk memulai sesi baru (saluran pensinyalan).
  - Unduh, buat, dan jalankan penampil Kinesis Video Streams dengan WebRTC JavaScript SDK untuk aplikasi web as dan verifikasi bahwa pemirsa dapat melihat audio/video master Android.

Konfigurasikan Amazon Cognito untuk Android WebRTC SDK

Prasyarat

Kami merekomendasikan Android Studio untuk memeriksa, mengedit, dan menjalankan kode aplikasi. Kami merekomendasikan menggunakan versi stabil terbaru.
Dalam kode contoh, Anda memberikan kredensi Amazon Cognito.

Ikuti prosedur ini untuk menyiapkan kumpulan pengguna Amazon Cognito dan kumpulan identitas.

Siapkan kumpulan pengguna

Untuk mengatur kumpulan pengguna

Masuk ke konsol Amazon Cognito dan verifikasi wilayah tersebut benar.
Di navigasi di sebelah kiri pilih Kumpulan pengguna.
Di bagian User pool, pilih Create user pool.
Lengkapi bagian berikut:
1. Langkah 1: Konfigurasikan pengalaman masuk - Di bagian opsi masuk kumpulan pengguna Cognito, pilih opsi yang sesuai.
  
  Pilih Selanjutnya.
2. Langkah 2: Konfigurasikan persyaratan keamanan - Pilih opsi yang sesuai.
  
  Pilih Selanjutnya.
3. Langkah 3: Konfigurasikan pengalaman pendaftaran - Pilih opsi yang sesuai.
  
  Pilih Selanjutnya.
4. Langkah 4: Konfigurasikan pengiriman pesan - Pilih opsi yang sesuai.
  
  Di bidang pemilihan peran IAM, pilih peran yang ada atau buat peran baru.
  
  Pilih Selanjutnya.
5. Langkah 5: Integrasikan aplikasi Anda - Pilih opsi yang sesuai.
  
  Di bidang Klien aplikasi awal, pilih Klien rahasia.
  
  Pilih Selanjutnya.
6. Langkah 6: Tinjau dan buat - Tinjau pilihan Anda dari bagian sebelumnya, lalu pilih Buat kumpulan pengguna.
Pada halaman User pool, pilih pool yang baru saja Anda buat.

Salin ID kumpulan Pengguna dan catat ini untuk nanti. Dalam awsconfiguration.json file, ini adalahCognitoUserPool.Default.PoolId.
Pilih tab Integrasi aplikasi dan pergi ke bagian bawah halaman.
Di bagian Daftar klien Aplikasi, pilih nama klien Aplikasi yang baru saja Anda buat.

Salin ID Klien dan catat ini untuk nanti. Dalam awsconfiguration.json file, ini adalahCognitoUserPool.Default.AppClientId.
Tunjukkan rahasia Klien dan catat ini untuk nanti. Dalam awsconfiguration.json file, ini adalahCognitoUserPool.Default.AppClientSecret.

Siapkan kolam identitas

Untuk mengatur kumpulan identitas

Masuk ke konsol Amazon Cognito dan verifikasi wilayah tersebut benar.
Di navigasi di sebelah kiri pilih Identity pool.
Pilih Buat kumpulan identitas.
Konfigurasikan kumpulan identitas.
1. Langkah 1: Konfigurasikan kepercayaan kumpulan identitas - Lengkapi bagian berikut:
  - Akses pengguna - Pilih Akses yang Diautentikasi
  - Sumber identitas yang diautentikasi - Pilih kumpulan pengguna Amazon Cognito
  Pilih Selanjutnya.
2. Langkah 2: Konfigurasikan izin - Di bagian peran yang diautentikasi, lengkapi bidang berikut:
  - Peran IAM - Pilih Buat peran IAM baru
  - Nama peran IAM - Masukkan nama dan catat untuk langkah selanjutnya.
  Pilih Selanjutnya.
3. Langkah 3: Hubungkan penyedia identitas - Di bagian Rincian kumpulan pengguna, lengkapi bidang berikut:
  - ID kumpulan pengguna - Pilih kumpulan pengguna yang Anda buat sebelumnya.
  - ID klien aplikasi - Pilih ID klien aplikasi yang Anda buat sebelumnya.
  Pilih Selanjutnya.
4. Langkah 4: Konfigurasikan properti - Ketik nama di bidang Identity pool name.
  
  Pilih Selanjutnya.
5. Langkah 5: Tinjau dan buat - Tinjau pilihan Anda di setiap bagian, lalu pilih Buat kumpulan identitas.
Pada halaman Identity pool, pilih kumpulan identitas baru Anda.

Salin ID kumpulan Identitas dan catat ini untuk nanti. Dalam awsconfiguration.json file, ini adalahCredentialsProvider.CognitoIdentity.Default.PoolId.
Perbarui izin untuk peran IAM.
1. Masuk ke AWS Management Console dan buka konsol IAM di https://console.aws.amazon.com/iam/.
2. Di navigasi di sebelah kiri, pilih Peran.
3. Temukan dan pilih peran yang Anda buat di atas.
  
  catatan
  Gunakan bilah pencarian, jika perlu.
4. Pilih kebijakan izin terlampir.
  
  Pilih Edit.
5. Pilih tab JSON dan ganti kebijakan dengan yang berikut:
```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cognito-identity:*",
                "kinesisvideo:*"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}
```
  Pilih Selanjutnya.
6. Pilih kotak di samping Setel versi baru ini sebagai default jika belum dipilih.
  
  Pilih Simpan perubahan.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

WebRTC SDK di JavaScript

WebRTC SDK untuk iOS