Amazon Kinesis Video RTC SDK Streams Web untuk iOS - Kinesis Video Streams
Unduh SDKMembangun SDKJalankan aplikasi sampelKonfigurasikan Amazon Cognito untuk SDK

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

Amazon Kinesis Video RTC SDK Streams Web untuk iOS

step-by-step Petunjuk berikut menjelaskan cara mengunduh, membuat, dan menjalankan RTC SDK Web Kinesis Video Streams di iOS dan sampelnya yang sesuai.

Unduh SDK

Untuk mengunduh Web RTC SDK di iOS, jalankan perintah berikut:

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

Membangun SDK

Selesaikan langkah-langkah berikut:

  1. Impor Web iOS RTC SDK ke lingkungan pengembangan XCode terintegrasi (IDE) di komputer iOS dengan membuka KinesisVideoWebRTCDemoApp.xcworkspace (path: amazon-kinesis-video-streams - webrtc-sdk-ios /Swift/ AWSKinesisVideoWebRTCDemoApp .xcworkspace).

  2. Jika Anda membuka proyek untuk pertama kalinya, proyek akan dibangun secara otomatis. Jika tidak, mulailah membangun.

    Anda mungkin melihat kesalahan berikut: 

    error: The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation.

    Jika Anda melihat ini, lakukan hal berikut:

    1. Ubah direktori kerja Anda saat ini menjadi amazon-kinesis-video-streams-webrtc-sdk-ios/Swift dan jalankan yang berikut di baris perintah:

      pod cache clean --all
pod install

    2. Ubah direktori kerja Anda saat ini menjadi amazon-kinesis-video-streams-webrtc-sdk-ios dan jalankan yang berikut di baris perintah:

      $ git checkout Swift/Pods/AWSCore/AWSCore/Service/AWSService.m

    3. Buildlagi.

  3. Konfigurasikan setelan Amazon Cognito (kumpulan pengguna dan kumpulan identitas). Untuk langkah-langkah detail, lihatKonfigurasikan Amazon Cognito untuk SDK. Ini menghasilkan pengaturan otentikasi dan otorisasi yang diperlukan untuk membangun Web iOS. RTC SDK

  4. Di AndaIDE, buka awsconfiguration.json file (dari/Swift/KVSiOSApp). File terlihat seperti berikut:

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

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

  5. Di AndaIDE, buka Constants.swift file (dari/Swift/KVSiOSApp). File terlihat seperti berikut:

    import Foundation
import AWSCognitoIdentityProvider

let CognitoIdentityUserPoolRegion = AWSRegionType.USWest2
let CognitoIdentityUserPoolId = "REPLACEME"
let CognitoIdentityUserPoolAppClientId = "REPLACEME"
let CognitoIdentityUserPoolAppClientSecret = "REPLACEME"

let AWSCognitoUserPoolsSignInProviderKey = "UserPool"
let CognitoIdentityPoolID = "REPLACEME"

let AWSKinesisVideoEndpoint = "https://kinesisvideo.us-west-2.amazonaws.com"
let AWSKinesisVideoKey = "kinesisvideo"

let VideoProtocols =  ["WSS", "HTTPS"]

let ConnectAsMaster = "connect-as-master"
let ConnectAsViewer = "connect-as-viewer"

let MasterRole = "MASTER"
let ViewerRole = "VIEWER"

let ClientID = "ConsumerViewer"

    Perbarui Constants.swift dengan nilai yang dihasilkan dengan menjalankan langkah-langkah diKonfigurasikan Amazon Cognito untuk SDK.

  6. Pastikan perangkat iOS Anda terhubung ke komputer Mac tempat Anda menjalankanXCode. DiXCode, pilih perangkat yang terhubung lalu buat dan jalankan Web RTC iOSSDK.

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

Jalankan aplikasi sampel

Selesaikan langkah-langkah berikut:

  1. Di perangkat iOS Anda, buka AWSKinesisVideoWebRTCDemoAppdan masuk menggunakan akun baru (dengan membuatnya terlebih dahulu) atau akun Amazon Cognito yang sudah ada.

  2. Masuk AWSKinesisVideoWebRTCDemoApp, navigasikan ke halaman Konfigurasi Saluran dan buat saluran pensinyalan baru atau pilih yang sudah ada.

    catatan

    Saat ini, menggunakan aplikasi sampel dalam hal iniSDK, Anda hanya dapat menjalankan satu saluran pensinyalan di AWSKinesisVideoWebRTCDemoApp.

  3. (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.

  4. Pilih Wilayah AWS dan apakah Anda ingin mengirim data audio atau video, atau keduanya.

  5. Untuk memverifikasi peer-to-peer streaming, lakukan salah satu hal berikut:

    catatan

    Pastikan Anda menentukan nama saluran pensinyalan yang sama, AWS wilayah, ID penampil, dan AWS ID akun pada semua klien yang Anda gunakan dalam demo ini.

    • P eer-to-peer streaming antara dua perangkat iOS: master dan viewer

      • Menggunakan prosedur di atas, unduh, buat, dan jalankan Web iOS RTC SDK di dua perangkat iOS.

      • Buka AWSKinesisVideoWebRTCDemoAppdi satu perangkat iOS dalam mode master (pilih STARTMASTER) untuk memulai sesi baru (saluran pensinyalan).

        catatan

        Saat ini, hanya ada satu master untuk saluran pensinyalan tertentu.

      • Buka AWSKinesisVideoWebRTCDemoAppdi perangkat iOS kedua Anda dalam mode penampil untuk terhubung ke saluran pensinyalan (sesi) yang dimulai pada langkah di atas (pilih STARTVIEWER).

        Verifikasi bahwa pemirsa dapat melihat data audio/video master.

    • P eer-to-peer streaming antara SDK master yang disematkan dan penampil perangkat iOS

    • P eer-to-peer streaming antara perangkat iOS sebagai master dan browser web sebagai penampil

      • Menggunakan prosedur di atas, unduh, buat, dan jalankan Web iOS RTC SDK di perangkat iOS. Buka AWSKinesisVideoWebRTCDemoAppdi perangkat iOS ini dalam mode master (pilih STARTMASTER) untuk memulai sesi baru (saluran pensinyalan).

      • Unduh, buat, dan jalankan penampil Amazon Kinesis Video Streams RTC SDK dengan JavaScript Web in untuk aplikasi web as dan verifikasi bahwa JavaScript pemirsa dapat melihat audio/video master Android.

Konfigurasikan Amazon Cognito untuk SDK

Prasyarat

  • Kami merekomendasikan XCode untuk memeriksa, mengedit, dan menjalankan kode aplikasi. Kami merekomendasikan versi 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

  1. Masuk ke konsol Amazon Cognito dan verifikasi wilayah tersebut benar.

  2. Di navigasi di sebelah kiri pilih Kumpulan pengguna.

  3. Di bagian User pool, pilih Create user pool.

  4. 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 IAM peran, 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.

  5. 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.

  6. Pilih tab Integrasi aplikasi dan pergi ke bagian bawah halaman.

  7. 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.

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

Siapkan kolam identitas

Untuk mengatur kumpulan identitas

  1. Masuk ke konsol Amazon Cognito dan verifikasi wilayah tersebut benar.

  2. Di navigasi di sebelah kiri pilih Identity pool.

  3. Pilih Buat kumpulan identitas.

  4. 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:

      • IAMrole - Pilih Buat IAM peran baru

      • IAMnama peran - 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.

  5. 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.

  6. Perbarui izin untuk IAM peran tersebut.

    1. Masuk ke AWS Management Console dan buka IAM konsol 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 JSONtab 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.