View a markdown version of this page

Hubungkan ke sesi penyimpanan - Kinesis Video Streams

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

Hubungkan ke sesi penyimpanan

Ikuti prosedur ini untuk membuat sesi penyimpanan dan memulai proses koneksi WebRTC. Peserta master harus menelepon JoinStorageSession. Peserta pemirsa harus menelepon JoinStorageSessionAsViewer.

Ini akan membuat sesi penyimpanan mengirim penawaran SDP dan kandidat ICE melalui pensinyalan ke peserta master yang terhubung melaluiConnectAsMaster, atau peserta pemirsa tertentu yang terhubung melaluiConnectAsViewer.

  1. Dapatkan ARN dari saluran pensinyalan, karena ini adalah input yang diperlukan untuk langkah berikutnya. Jika Anda sudah tahu ARN, lanjutkan dengan langkah berikutnya.

    Konsol Manajemen AWS

    1. Buka konsol https://console.aws.amazon.com/kinesisvideo/home/#/signalingChannels Kinesis Video Streams Signaling Channels.

    2. Pilih nama saluran pensinyalan Anda.

    3. Di bawah tab Info saluran sinyal, cari ARN untuk saluran pensinyalan Anda.

    AWS CLI

    Verifikasi bahwa Anda telah AWS CLI menginstal dan dikonfigurasi. Untuk informasi selengkapnya, silakan lihat Panduan Pengguna AWS Command Line Interface.

    Untuk petunjuk pemasangan, lihat Panduan AWS Command Line Interface Pengguna. Setelah instalasi, konfigurasikan AWS CLI dengan kredenSIAL dan wilayah.

    Atau, buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan AWS CloudShell Pengguna untuk informasi lebih lanjut.

    Jalankan Describe-Signaling-Channel perintah berikut menggunakan AWS CLI:

    aws kinesisvideo describe-signaling-channel \
  --channel-name "YourChannelName" \

    Tanggapannya akan terlihat seperti berikut:

    {
    "ChannelInfo": {
        "ChannelName": "YourChannelName",
        "ChannelARN": "arn:aws:kinesisvideo:us-west-2:123456789012:channel/YourChannelName/1234567890123",
        "ChannelType": "SINGLE_MASTER", 
        "ChannelStatus": "ACTIVE",
        "CreationTime": "2024-07-07T23:28:24.941000-07:00",
        "SingleMasterConfiguration": {
        "MessageTtlSeconds": 60
    },
    "Version": "Ws0fZvFGXzEpuZ2CE1s9"
    }
}

    Anda akan menemukan saluran pensinyalan ARN di ChannelInfo objek.

    AWS SDK

    Cuplikan kode ini menunjukkan cara membuat Streams Video Kinesis dengan saluran pensinyalan WebRTC menggunakan SDK untuk v2. AWS JavaScript Sintaks akan berbeda dari AWS SDK lain, tetapi alur umumnya akan sama.

    Anda dapat melihat contoh kode lengkap untuk JoinStorageSession atau JoinStorageSessionAsViewer.

    Buat klien Kinesis Video Streams. Ini digunakan untuk memanggil DescribeSignalingChannel API.

    const clientConfig = {
    accessKeyId: 'YourAccessKey',
    secretAccessKey: 'YourSecretKey',
    region: 'us-west-2'
};
const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);

    Gunakan klien untuk memanggil DescribeSignalingChannel API.

    const describeSignalingChannelResponse = await kinesisVideoClient
    .describeSignalingChannel({
        ChannelName: 'YourChannelName',
    })
    .promise();

    Simpan tanggapannya.

    const channelARN =
    describeSignalingChannelResponse.ChannelInfo.ChannelARN;

  2. Dapatkan titik akhir WEBRTC. Permintaan ke JoinStorageSession atau JoinStorageSessionAsViewer untuk saluran pensinyalan tertentu harus dibuat ke titik akhir yang ditunjuk.

    Konsol Manajemen AWS
    catatan

    Operasi ini saat ini tidak didukung di Stre Konsol Manajemen AWS aming Video Kinesis.

    Buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan AWS CloudShell Pengguna untuk informasi selengkapnya.

    Ikuti instruksi di AWS CLI tab.

    AWS CLI

    Verifikasi bahwa Anda telah AWS CLI menginstal dan dikonfigurasi. Untuk informasi selengkapnya, lihat AWS Command Line Interface dokumentasi.

    Untuk petunjuk pemasangan, lihat Panduan AWS Command Line Interface Pengguna. Setelah instalasi, konfigurasikan AWS CLI dengan kredenSIAL dan wilayah.

    Atau, buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan AWS CloudShell Pengguna untuk informasi lebih lanjut.

    Jalan Get-Signaling-Channel-Endpoint kan perintah di AWS CLI:

    aws kinesisvideo get-signaling-channel-endpoint \
  --channel-arn "arn:aws:kinesisvideo:us-west-2:123456789012:channel/YourChannelName/1234567890123" \
  --single-master-channel-endpoint-configuration "Protocols=['WEBRTC'],Role=MASTER" \
  --region "us-west-2"

    Responsnya terlihat seperti berikut ini:

    {
    "ResourceEndpointList": [
        {
            "Protocol": "WEBRTC",
            "ResourceEndpoint": "https://w-abcd1234.kinesisvideo.aws-region.amazonaws.com"
        } 
    ]
}
    AWS SDK

    Cuplikan kode ini menunjukkan cara memanggil GetSignalingChannelEndpoint API untuk Streams Video Kinesis dengan saluran pensinyalan WebRTC menggunakan SDK untuk v2. AWS JavaScript Sintaks akan berbeda dari AWS SDK lain, tetapi alur umumnya akan sama. Lihat contoh kode lengkap untuk JoinStorageSession atau JoinStorageSessionAsViewer.

    Buat klien Kinesis Video Streams. Ini adalah klien yang digunakan untuk memanggil DescribeSignalingChannel API.

    Jika Anda membuat klien Kinesis Video Streams sebelumnya untuk meneleponDescribeSignalingChannel, Anda dapat menggunakan kembali klien yang sama.

    const clientConfig = {
    accessKeyId: 'YourAccessKey',
    secretAccessKey: 'YourSecretKey',
    region: 'us-west-2'
};
const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);

    Gunakan klien untuk memanggil GetSignalingChannelEndpoint API.

    const getSignalingChannelEndpointResponse = await kinesisVideoClient
    .getSignalingChannelEndpoint({
        ChannelARN: channelARN,
        SingleMasterChannelEndpointConfiguration: {
            Protocols: ['WEBRTC'],
            Role: 'MASTER',
        },
    })
    .promise();

    Simpan tanggapan:

    const webrtcEndpoint = getSignalingChannelEndpointResponse.ResourceEndpointList[0].ResourceEndpoint;

  3. Gunakan saluran ARN dan titik akhir WEBRTC untuk melakukan panggilan API. Jika peserta terhubung dengan benar ke Kinesis Video Streams dengan Pensinyalan WebRTC melalui ConnectAsViewer WebSocket API ConnectAsMaster atau, penawaran SDP dan aliran pesan kandidat ICE akan dikirim sepanjang sesi WebSocket penyimpanan ke peserta.

    Konsol Manajemen AWS
    catatan

    Operasi ini saat ini tidak didukung di Stre Konsol Manajemen AWS aming Video Kinesis.

    Buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan AWS CloudShell Pengguna untuk informasi selengkapnya.

    Ikuti instruksi di AWS CLI tab.

    AWS CLI

    Verifikasi bahwa Anda telah AWS CLI menginstal dan dikonfigurasi. Untuk informasi selengkapnya, lihat AWS Command Line Interface dokumentasi.

    Untuk petunjuk pemasangan, lihat Panduan AWS Command Line Interface Pengguna. Setelah instalasi, konfigurasikan AWS CLI dengan kredenSIAL dan wilayah.

    Atau, buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan AWS CloudShell Pengguna untuk informasi lebih lanjut.

    Jalan Join-Storage-Session kan perintah untuk peserta master dalam AWS CLI menggunakan saluran ARN dan titik akhir WEBRTC dari langkah-langkah sebelumnya:

    aws kinesis-video-webrtc-storage join-storage-session \
  --endpoint-url https://w-abcd1234.kinesisvideo.us-west-2.amazonaws.com \
  --channel-arn arn:aws:kinesisvideo:us-west-2:123456789012:channel/YourChannelName/1234567890123 \
  --region "us-west-2"

    Setelah berhasil dijalankan, respons kosong dikembalikan dan tidak ada yang dicetak.

    Dalam kasus peserta pemirsa, jalankan Join-Storage-Session-As-Viewer perintah berikut di AWS CLI menggunakan saluran ARN dan titik akhir WEBRTC dari sebelumnya:

    aws kinesis-video-webrtc-storage join-storage-session-as-viewer \
  --endpoint-url https://w-abcd1234.kinesisvideo.us-west-2.amazonaws.com \
  --channel-arn arn:aws:kinesisvideo:us-west-2:123456789012:channel/YourChannelName/1234567890123 \
  --client-id "ExampleViewerClientID"
  --region "us-west-2"

    Setelah berhasil dijalankan, respons kosong dikembalikan dan tidak ada yang dicetak.

    AWS SDK

    Cuplikan kode ini menunjukkan cara memanggil JoinStorageSessionAsViewer API JoinStorageSession or untuk Streams Video Kinesis dengan saluran pensinyalan WebRTC menggunakan SDK untuk v2. AWS JavaScript Sintaks akan berbeda dari AWS SDK lain, tetapi alur umumnya akan sama. Lihat contoh kode lengkap untuk JoinStorageSession atau JoinStorageSessionAsViewer.

    Buat klien penyimpanan WebRTC Streams Video Streams Kinesis. Ini adalah klien yang digunakan untuk menelepon JoinStorageSession atau JoinStorageSessionAsViewer dan berbeda dari klien Kinesis Video Streams yang dibuat pada langkah-langkah sebelumnya.

    const webrtcStorageClientConfig = {
    accessKeyId: 'YourAccessKey',
    secretAccessKey: 'YourSecretKey',
    region: 'us-west-2',
    endpoint: webrtcEndpoint
};
const kinesisVideoWebRTCStorageClient = new AWS.KinesisVideoWebRTCStorage(clientConfig);

    Gunakan klien untuk memanggil JoinStorageSession API untuk peserta master.

    await kinesisVideoWebRTCStorageClient
    .joinStorageSession({
        channelArn: channelARN,
    })
    .promise();

    Dalam kasus peserta pemirsa, gunakan klien untuk memanggil JoinStorageSessionAsViewer API.

    await kinesisVideoWebRTCStorageClient
    .joinStorageSessionAsViewer({
        channelArn: channelARN,
        clientId: "ExampleViewerClientID",
    })
    .promise();

    Halaman web langsung dengan contoh kode ini tersedia di GitHub. Masukkan wilayah Anda, AWS kredenSIAL, dan nama saluran pensinyalan Anda. Perluas simpul Penyerapan dan Penyimpanan WebRTC, dan hapus centang Secara otomatis menentukan mode konsumsi.

    Alihkan penggantian manual ke ON dan pilih tombol Tampilkan untuk memanggil tombol JoinStorageSession API and/or Show secara manual untuk memanggil JoinStorageSessionAsViewer API secara manual.

    Ketika Anda memilih Start Master atau Start Viewer, setelah aplikasi terhubung ke pensinyalan melalui ConnectAsMaster atauConnectAsViewer, sebuah tombol akan muncul untuk membuat sesi penyimpanan memulai koneksi WebRTC dengan peer alih-alih aplikasi memanggil API segera setelah terhubung ke pensinyalan.