Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Contoh Streaming Waktu Nyata Amazon IVS menggunakan AWS CLI
Contoh kode berikut menunjukkan kepada Anda cara melakukan tindakan dan menerapkan skenario umum AWS Command Line Interface dengan menggunakan Streaming Real-Time Amazon IVS.
*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.
Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.
**Topics**
+ [Tindakan](#actions)
## Tindakan
### `create-encoder-configuration`
Contoh kode berikut menunjukkan cara menggunakan`create-encoder-configuration`.
**AWS CLI**
**Untuk membuat konfigurasi encoder komposisi**
`create-encoder-configuration`Contoh berikut membuat konfigurasi encoder komposisi dengan properti yang ditentukan.
```
aws ivs-realtime create-encoder-configuration \
--name test-ec --video bitrate=3500000,framerate=30.0,height=1080,width=1920
```
Output:
```
{
"encoderConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef",
"name": "test-ec",
"tags": {},
"video": {
"bitrate": 3500000,
"framerate": 30,
"height": 1080,
"width": 1920
}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [CreateEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-encoder-configuration.html)di *Referensi AWS CLI Perintah*.
### `create-ingest-configuration`
Contoh kode berikut menunjukkan cara menggunakan`create-ingest-configuration`.
**AWS CLI**
**Untuk membuat konfigurasi ingest**
`create-ingest-configuration`Contoh berikut membuat konfigurasi ingest menggunakan protokol RTMPS.
```
aws ivs-realtime create-ingest-configuration \
--name ingest1 \
--ingest-protocol rtmps
```
Output:
```
{
"ingestConfiguration": {
"name": "ingest1",
"arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
"ingestProtocol": "RTMPS",
"streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
"stageArn": "",
"participantId": "xyZ654abC321",
"state": "INACTIVE",
"userId": "",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [IVS Stream Ingest \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [CreateIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-ingest-configuration.html)di *Referensi AWS CLI Perintah*.
### `create-participant-token`
Contoh kode berikut menunjukkan cara menggunakan`create-participant-token`.
**AWS CLI**
**Untuk membuat token peserta panggung**
`create-participant-token`Contoh berikut membuat toke peserta untuk tahap yang ditentukan.
```
aws ivs-realtime create-participant-token \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--user-id bob
```
Output:
```
{
"participantToken": {
"expirationTime": "2023-03-07T09:47:43+00:00",
"participantId": "ABCDEfghij01234KLMN6789",
"token": "abcd1234defg5678"
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [CreateParticipantToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-participant-token.html)di *Referensi AWS CLI Perintah*.
### `create-stage`
Contoh kode berikut menunjukkan cara menggunakan`create-stage`.
**AWS CLI**
**Contoh 1: Untuk membuat panggung**
`create-stage`Contoh berikut membuat token peserta tahap dan tahap untuk pengguna tertentu.
```
aws ivs-realtime create-stage \
--name stage1 \
--participant-token-configurations userId=alice
```
Output:
```
{
"participantTokens": [
{
"participantId": "ABCDEfghij01234KLMN5678",
"token": "a1b2c3d4567890ab",
"userId": "alice"
}
],
"stage": {
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"storageConfigurationArn": "",
"mediaTypes": [
"AUDIO_VIDEO"
],
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "DISABLED"
},
"recordingReconnectWindowSeconds": 0,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 6
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
},
"name": "stage1",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
**Contoh 2: Untuk membuat panggung dan mengkonfigurasi rekaman peserta individu**
`create-stage`Contoh berikut membuat panggung dan mengkonfigurasi rekaman peserta individu.
```
aws ivs-realtime create-stage \
--name stage1 \
--auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}'
```
Output:
```
{
"stage": {
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh"
"mediaTypes": [
"AUDIO_VIDEO"
],
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "DISABLED"
},
"recordingReconnectWindowSeconds": 100,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 5
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
},
"name": "stage1",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
**Contoh 3: Untuk membuat panggung dan mengonfigurasi rekaman peserta individu dengan rekaman thumbnail diaktifkan**
`create-stage`Contoh berikut membuat panggung dan mengkonfigurasi perekaman peserta individu dengan rekaman thumbnail diaktifkan.
```
aws ivs-realtime create-stage \
--name stage1 \
--auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", \
"thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}}'
```
Output:
```
{
"stage": {
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
"mediaTypes": [
"AUDIO_VIDEO"
],
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "INTERVAL"
},
"recordingReconnectWindowSeconds": 0,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 6
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
},
"name": "stage1",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
+ Untuk detail API, lihat [CreateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-stage.html)di *Referensi AWS CLI Perintah*.
### `create-storage-configuration`
Contoh kode berikut menunjukkan cara menggunakan`create-storage-configuration`.
**AWS CLI**
**Untuk membuat konfigurasi penyimpanan komposisi**
`create-storage-configuration`Contoh berikut membuat konfigurasi penyimpanan komposisi dengan properti yang ditentukan.
```
aws ivs-realtime create-storage-configuration \
--name "test-sc" --s3 "bucketName=amzn-s3-demo-bucket"
```
Output:
```
{
"storageConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef",
"name": "test-sc",
"s3": {
"bucketName": "amzn-s3-demo-bucket"
},
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [CreateStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-storage-configuration.html)di *Referensi AWS CLI Perintah*.
### `delete-encoder-configuration`
Contoh kode berikut menunjukkan cara menggunakan`delete-encoder-configuration`.
**AWS CLI**
**Untuk menghapus konfigurasi encoder komposisi**
Berikut ini `delete-encoder-configuration` menghapus konfigurasi encoder komposisi yang ditentukan oleh ARN yang diberikan (Amazon Resource Name).
```
aws ivs-realtime delete-encoder-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
```
Perintah ini tidak menghasilkan output.
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [DeleteEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-encoder-configuration.html)di *Referensi AWS CLI Perintah*.
### `delete-ingest-configuration`
Contoh kode berikut menunjukkan cara menggunakan`delete-ingest-configuration`.
**AWS CLI**
**Contoh 1: Untuk menghapus konfigurasi ingest yang tidak aktif**
`delete-ingest-configuration`Contoh berikut menghapus konfigurasi ingest yang tidak aktif untuk ARN konfigurasi ingest-tertentu (Nama Sumber Daya Amazon).
```
aws ivs-realtime delete-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234
```
Perintah ini tidak menghasilkan output.
Untuk informasi selengkapnya, lihat [IVS Stream Ingest \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
**Contoh 2: Untuk memaksa menghapus konfigurasi ingest aktif**
`delete-ingest-configuration`Contoh berikut memaksa penghapusan konfigurasi ingest aktif untuk ARN konfigurasi ingest-tertentu (Nama Sumber Daya Amazon).
```
aws ivs-realtime delete-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \
--force
```
Perintah ini tidak menghasilkan output.
Untuk informasi selengkapnya, lihat [IVS Stream Ingest \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [DeleteIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-ingest-configuration.html)di *Referensi AWS CLI Perintah*.
### `delete-public-key`
Contoh kode berikut menunjukkan cara menggunakan`delete-public-key`.
**AWS CLI**
**Untuk menghapus kunci publik**
Berikut ini `delete-public-key` menghapus kunci publik yang ditentukan.
```
aws ivs-realtime delete-public-key \
--arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2
```
Perintah ini tidak menghasilkan output.
Untuk informasi selengkapnya, lihat [Mendistribusikan Token Peserta](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) di *Panduan Pengguna Streaming Waktu Nyata Amazon IVS*.
+ Untuk detail API, lihat [DeletePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-public-key.html)di *Referensi AWS CLI Perintah*.
### `delete-stage`
Contoh kode berikut menunjukkan cara menggunakan`delete-stage`.
**AWS CLI**
**Untuk menghapus panggung**
`delete-stage`Contoh berikut menghapus tahap yang ditentukan.
```
aws ivs-realtime delete-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Perintah ini tidak menghasilkan output.
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [DeleteStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-stage.html)di *Referensi AWS CLI Perintah*.
### `delete-storage-configuration`
Contoh kode berikut menunjukkan cara menggunakan`delete-storage-configuration`.
**AWS CLI**
**Untuk menghapus konfigurasi penyimpanan komposisi**
Berikut ini `delete-storage-configuration` menghapus konfigurasi penyimpanan komposisi yang ditentukan oleh ARN yang diberikan (Nama Sumber Daya Amazon).
```
aws ivs-realtime delete-storage-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef"
```
Perintah ini tidak menghasilkan output.
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [DeleteStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-storage-configuration.html)di *Referensi AWS CLI Perintah*.
### `disconnect-participant`
Contoh kode berikut menunjukkan cara menggunakan`disconnect-participant`.
**AWS CLI**
**Untuk memutuskan sambungan peserta panggung**
`disconnect-participant`Contoh berikut memutus peserta yang ditentukan dari tahap yang ditentukan.
```
aws ivs-realtime disconnect-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--participant-id ABCDEfghij01234KLMN5678
```
Perintah ini tidak menghasilkan output.
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [DisconnectParticipant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/disconnect-participant.html)di *Referensi AWS CLI Perintah*.
### `get-composition`
Contoh kode berikut menunjukkan cara menggunakan`get-composition`.
**AWS CLI**
**Contoh 1: Untuk mendapatkan komposisi dengan pengaturan tata letak default**
`get-composition`Contoh berikut mendapatkan komposisi untuk ARN (Amazon Resource Name) yang ditentukan.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Output:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "ACTIVE"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": "",
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"videoAspectRatio": "VIDEO",
"videoFillMode": ""
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "ACTIVE",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Perekaman Komposit IVS \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
**Contoh 2: Untuk mendapatkan komposisi dengan tata letak PiP**
`get-composition`Contoh berikut mendapatkan komposisi untuk ARN (Amazon Resource Name) yang ditentukan, yang menggunakan tata letak PiP.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs"
```
Output:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "ACTIVE"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "STARTING"
}
],
"layout": {
"pip": {
"featuredParticipantAttribute": "abcdefg",
"gridGap": 0,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"pipBehavior": "STATIC",
"pipOffset": 0,
"pipParticipantAttribute": "",
"pipPosition": "BOTTOM_RIGHT",
"videoFillMode": "COVER"
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "ACTIVE",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Perekaman Komposit IVS \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
**Contoh 3: Untuk mendapatkan komposisi dengan rekaman thumbnail diaktifkan**
`get-composition`Contoh berikut mendapatkan komposisi untuk ARN (Amazon Resource Name) yang ditentukan, yang memiliki rekaman thumbnail diaktifkan dengan pengaturan default.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Output:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "ACTIVE"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
"thumbnailConfigurations": [
{
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
}
]
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": ""
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"videoAspectRatio": "VIDEO",
"videoFillMode": "" }
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "ACTIVE",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Perekaman Komposit IVS \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [GetComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-composition.html)di *Referensi AWS CLI Perintah*.
### `get-encoder-configuration`
Contoh kode berikut menunjukkan cara menggunakan`get-encoder-configuration`.
**AWS CLI**
**Untuk mendapatkan konfigurasi encoder komposisi**
`get-encoder-configuration`Contoh berikut mendapatkan konfigurasi encoder komposisi yang ditentukan oleh ARN yang diberikan (Amazon Resource Name).
```
aws ivs-realtime get-encoder-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh"
```
Output:
```
{
"encoderConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh",
"name": "test-ec",
"tags": {},
"video": {
"bitrate": 3500000,
"framerate": 30,
"height": 1080,
"width": 1920
}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [GetEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-encoder-configuration.html)di *Referensi AWS CLI Perintah*.
### `get-ingest-configuration`
Contoh kode berikut menunjukkan cara menggunakan`get-ingest-configuration`.
**AWS CLI**
**Untuk mendapatkan informasi konfigurasi tertelan**
`get-ingest-configuration`Contoh berikut mendapatkan konfigurasi ingest untuk ARN konfigurasi ingest-tertentu (Nama Sumber Daya Amazon).
```
aws ivs-realtime get-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234
```
Output:
```
{
"ingestConfiguration": {
"name": "ingest1",
"arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
"ingestProtocol": "RTMPS",
"streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
"stageArn": "",
"participantId": "xyZ654abC321",
"state": "INACTIVE",
"userId": "",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [IVS Stream Ingest \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [GetIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-ingest-configuration.html)di *Referensi AWS CLI Perintah*.
### `get-participant`
Contoh kode berikut menunjukkan cara menggunakan`get-participant`.
**AWS CLI**
**Contoh 1: Untuk mendapatkan peserta panggung**
`get-participant`Contoh berikut mendapatkan peserta tahap untuk ID peserta dan ID sesi tertentu di ARN tahap tertentu (Nama Sumber Daya Amazon).
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Output:
```
{
"participant": {
"browserName": "Google Chrome",
"browserVersion": "116",
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"ispName": "Comcast",
"osName": "Microsoft Windows 10 Pro",
"osVersion": "10.0.19044",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingS3BucketName": "bucket-name",
"recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
"recordingState": "ACTIVE",
"sdkVersion": "",
"state": "CONNECTED",
"userId": ""
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
**Contoh 2: Untuk mendapatkan peserta panggung yang telah direplikasi ke tahap lain**
`get-participant`Contoh berikut mendapatkan peserta tahap untuk ID peserta dan ID sesi tertentu di ARN tahap tertentu (Nama Sumber Daya Amazon), ketika peserta juga telah direplikasi ke tahap lain.
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Output:
```
{
"participant": {
"browserName": "Google Chrome",
"browserVersion": "116",
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"ispName": "Comcast",
"osName": "Microsoft Windows 10 Pro",
"osVersion": "10.0.19044",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingS3BucketName": "bucket-name",
"recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
"recordingState": "ACTIVE",
"replicationState": "ACTIVE",
"replicationType": "SOURCE",
"sdkVersion": "",
"state": "CONNECTED",
"userId": ""
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
**Contoh 3: Untuk mendapatkan peserta panggung yang telah direplikasi dari tahap lain**
`get-participant`Contoh berikut mendapatkan peserta tahap untuk ID peserta dan ID sesi tertentu di ARN tahap tertentu (Nama Sumber Daya Amazon), ketika peserta telah direplikasi dari tahap lain.
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Output:
```
{
"participant": {
"browserName": "Google Chrome",
"browserVersion": "116",
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"ispName": "Comcast",
"osName": "Microsoft Windows 10 Pro",
"osVersion": "10.0.19044",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingS3BucketName": "bucket-name",
"recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
"recordingState": "ACTIVE",
"replicationState": "ACTIVE",
"replicationType": "REPLICA",
"sdkVersion": "",
"state": "CONNECTED",
"userId": ""
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
+ Untuk detail API, lihat [GetParticipant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-participant.html)di *Referensi AWS CLI Perintah*.
### `get-public-key`
Contoh kode berikut menunjukkan cara menggunakan`get-public-key`.
**AWS CLI**
**Untuk mendapatkan kunci publik yang ada digunakan untuk menandatangani token peserta panggung**
`get-public-key`Contoh berikut mendapatkan kunci publik yang ditentukan oleh ARN yang disediakan, untuk menandatangani token peserta tahap.
```
aws ivs-realtime get-public-key \
--arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2
```
Output:
```
{
"publicKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
"name": "",
"publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEqVWUtqs6EktQMR1sCYmEzGvRwtaycI16\n9pmzcpiWu/uhNStGlteJ5odRfRwVkoQUMnSZXTCcbn9bBTTmiWo4mJcFOOAzsthH\n0UAb8NdD4tUE0At4a9hYP9IETEXAMPLE\n-----END PUBLIC KEY-----",
"fingerprint": "12:a3:44:56:bc:7d:e8:9f:10:2g:34:hi:56:78:90:12",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mendistribusikan Token Peserta](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) di *Panduan Pengguna Streaming Waktu Nyata Amazon IVS*.
+ Untuk detail API, lihat [GetPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-public-key.html)di *Referensi AWS CLI Perintah*.
### `get-stage-session`
Contoh kode berikut menunjukkan cara menggunakan`get-stage-session`.
**AWS CLI**
**Untuk mendapatkan sesi panggung**
`get-stage-session`Contoh berikut mendapatkan sesi tahap untuk ID sesi tertentu dari ARN tahap tertentu (Amazon Resource Name).
```
aws ivs-realtime get-stage-session \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Output:
```
{
"stageSession": {
"endTime": "2023-04-26T20:36:29+00:00",
"sessionId": "st-a1b2c3d4e5f6g",
"startTime": "2023-04-26T20:30:29.602000+00:00"
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [GetStageSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-stage-session.html)di *Referensi AWS CLI Perintah*.
### `get-stage`
Contoh kode berikut menunjukkan cara menggunakan`get-stage`.
**AWS CLI**
**Untuk mendapatkan informasi konfigurasi panggung**
`get-stage`Contoh berikut mendapatkan konfigurasi tahap untuk ARN tahap tertentu (Amazon Resource Name).
```
aws ivs-realtime get-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Output:
```
{
"stage": {
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"storageConfigurationArn": "",
"mediaTypes": [
"AUDIO_VIDEO"
],
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "DISABLED"
},
"recordingReconnectWindowSeconds": 0,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 6
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
},
"name": "test",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
+ Untuk detail API, lihat [GetStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-stage.html)di *Referensi AWS CLI Perintah*.
### `get-storage-configuration`
Contoh kode berikut menunjukkan cara menggunakan`get-storage-configuration`.
**AWS CLI**
**Untuk mendapatkan konfigurasi penyimpanan komposisi**
`get-storage-configuration`Contoh berikut mendapatkan konfigurasi penyimpanan komposisi yang ditentukan oleh ARN yang diberikan (Amazon Resource Name).
```
aws ivs-realtime get-storage-configuration \
--name arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh"
```
Output:
```
{
"storageConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
"name": "test-sc",
"s3": {
"bucketName": "amzn-s3-demo-bucket"
},
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [GetStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-storage-configuration.html)di *Referensi AWS CLI Perintah*.
### `import-public-key`
Contoh kode berikut menunjukkan cara menggunakan`import-public-key`.
**AWS CLI**
**Untuk mengimpor kunci publik yang ada untuk digunakan untuk menandatangani token peserta panggung**
`import-public-key`Contoh berikut mengimpor kunci publik dari file material, yang akan digunakan untuk menandatangani token peserta tahap.
```
aws ivs-realtime import-public-key \
--public-key-material="`cat public.pem`"
```
Output:
```
{
"publicKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
"name": "",
"publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEqVWUtqs6EktQMR1sCYmEzGvRwtaycI16\n9pmzcpiWu/uhNStGlteJ5odRfRwVkoQUMnSZXTCcbn9bBTTmiWo4mJcFOOAzsthH\n0UAb8NdD4tUE0At4a9hYP9IETEXAMPLE\n-----END PUBLIC KEY-----",
"fingerprint": "12:a3:44:56:bc:7d:e8:9f:10:2g:34:hi:56:78:90:12",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mendistribusikan Token Peserta](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) di *Panduan Pengguna Streaming Waktu Nyata Amazon IVS*.
+ Untuk detail API, lihat [ImportPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/import-public-key.html)di *Referensi AWS CLI Perintah*.
### `list-compositions`
Contoh kode berikut menunjukkan cara menggunakan`list-compositions`.
**AWS CLI**
**Untuk mendapatkan daftar komposisi**
Berikut ini `list-compositions` mencantumkan semua komposisi untuk AWS akun Anda, di AWS wilayah tempat permintaan API diproses.
```
aws ivs-realtime list-compositions
```
Output:
```
{
"compositions": [
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"id": "AabBCcdDEefF",
"startTime": "2023-10-16T23:25:23+00:00",
"state": "ACTIVE"
}
],
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:25:21+00:00",
"state": "ACTIVE",
"tags": {}
},
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/ABcdabCDefgh",
"destinations": [
{
"endTime": "2023-10-16T23:25:00.786512+00:00",
"id": "aABbcCDdeEFf",
"startTime": "2023-10-16T23:24:01+00:00",
"state": "STOPPED"
},
{
"endTime": "2023-10-16T23:25:00.786512+00:00",
"id": "deEFfaABbcCD",
"startTime": "2023-10-16T23:24:01+00:00",
"state": "STOPPED"
}
],
"endTime": "2023-10-16T23:25:00+00:00",
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/efghabcdABCD",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STOPPED",
"tags": {}
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [ListCompositions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-compositions.html)di *Referensi AWS CLI Perintah*.
### `list-encoder-configurations`
Contoh kode berikut menunjukkan cara menggunakan`list-encoder-configurations`.
**AWS CLI**
**Untuk membuat daftar konfigurasi encoder komposisi**
Berikut ini `list-encoder-configurations` mencantumkan semua konfigurasi encoder komposisi untuk AWS akun Anda, di AWS wilayah tempat permintaan API diproses.
```
aws ivs-realtime list-encoder-configurations
```
Output:
```
{
"encoderConfigurations": [
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh",
"name": "test-ec-1",
"tags": {}
},
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABCefgEFGabc",
"name": "test-ec-2",
"tags": {}
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [ListEncoderConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-encoder-configurations.html)di *Referensi AWS CLI Perintah*.
### `list-ingest-configurations`
Contoh kode berikut menunjukkan cara menggunakan`list-ingest-configurations`.
**AWS CLI**
**Untuk mendapatkan informasi ringkasan tentang semua konfigurasi ingest**
`list-ingest-configurations`Contoh berikut mencantumkan semua konfigurasi ingest untuk AWS akun Anda, di AWS wilayah tempat permintaan API diproses.
```
aws ivs-realtime list-ingest-configurations
```
Output:
```
{
"ingestConfigurations": [
{
"name": "",
"arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/XYZuvwSt4567",
"ingestProtocol": "RTMPS",
"stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"participnatId": "abC789Xyz456",
"state": "INACTIVE"
"userId": "",
}
]
}
```
Untuk informasi selengkapnya, lihat [IVS Stream Ingest \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [ListIngestConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-ingest-configurations.html)di *Referensi AWS CLI Perintah*.
### `list-participant-events`
Contoh kode berikut menunjukkan cara menggunakan`list-participant-events`.
**AWS CLI**
**Contoh 1: Untuk mendapatkan daftar acara peserta panggung**
`list-participant-events`Contoh berikut mencantumkan semua peristiwa peserta untuk ID peserta tertentu dan ID sesi dari ARN tahap tertentu (Nama Sumber Daya Amazon).
```
aws ivs-realtime list-participant-events \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Output:
```
{
"events": [
{
"eventTime": "2023-04-26T20:36:28+00:00",
"name": "LEFT",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2023-04-26T20:36:28+00:00",
"name": "PUBLISH_STOPPED",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2023-04-26T20:30:34+00:00",
"name": "JOINED",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2023-04-26T20:30:34+00:00",
"name": "PUBLISH_STARTED",
"participantId": "abCDEf12GHIj"
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
**Contoh 2: Untuk mendapatkan daftar acara peserta panggung, termasuk replikasi peserta berhenti dan mulai**
`list-participant-events`Contoh berikut mencantumkan semua acara peserta untuk ID sesi tertentu dari ARN tahap tertentu (Nama Sumber Daya Amazon), tempat peserta direplikasi ke tahap lain.
```
aws ivs-realtime list-participant-events \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Output:
```
{
"events": [
{
"eventTime": "2025-04-26T20:36:28+00:00",
"name": "LEFT",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2025-04-26T20:36:28+00:00",
"name": "PUBLISH_STOPPED",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2025-04-26T20:30:34+00:00",
"name": "JOINED",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2025-04-26T20:30:34+00:00",
"name": "PUBLISH_STARTED",
"participantId": "abCDEf12GHIj"
},
{
"name": "REPLICATION_STARTED",
"participantId": "abCDEf12GHIj",
"eventTime": "2025-04-26T20:30:34+00:00",
"destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh",
"destinationSessionId": "st-b1c2d3e4f5g6a"
},
{
"name": "REPLICATION_STOPPED",
"participantId": "abCDEf12GHIj",
"eventTime": "2025-04-26T20:32:34+00:00",
"destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh",
"destinationSessionId": "st-b1c2d3e4f5g6a"
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
+ Untuk detail API, lihat [ListParticipantEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participant-events.html)di *Referensi AWS CLI Perintah*.
### `list-participant-replicas`
Contoh kode berikut menunjukkan cara menggunakan`list-participant-replicas`.
**AWS CLI**
**Untuk mendapatkan daftar replika peserta panggung**
`list-participant-replicas`Contoh berikut mencantumkan semua peserta tahap yang direplikasi dari ARN tahap sumber yang ditentukan (Nama Sumber Daya Amazon) ke tahap lain.
```
aws ivs-realtime list-participant-replicas \
--source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--participant-id abCDEf12GHIj
```
Output:
```
{
"replicas": [
{
"sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"participantId": "abCDEf12GHIj",
"sourceSessionId": "st-a1b2c3d4e5f6g",
"destinationStageArn": "arn:aws:ivs:us-west-2:012345678901:stage/ABCDabcdefgh",
"destinationSessionId": "st-b1c2d3e4f5g6a",
"replicationState": "ACTIVE"
}
]
}
```
Untuk informasi selengkapnya, lihat [Replikasi Peserta IVS di Panduan](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) Pengguna *Streaming Waktu Nyata Amazon IVS*.
+ Untuk detail API, lihat [ListParticipantReplicas](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participant-replicas.html)di *Referensi AWS CLI Perintah*.
### `list-participants`
Contoh kode berikut menunjukkan cara menggunakan`list-participants`.
**AWS CLI**
**Contoh 1: Untuk mendapatkan daftar peserta panggung**
`list-participants`Contoh berikut mencantumkan semua peserta untuk ID sesi tertentu dari ARN tahap tertentu (Nama Sumber Daya Amazon).
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Output:
```
{
"participants": [
{
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingState": "STOPPED",
"state": "DISCONNECTED",
"userId": ""
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
**Contoh 2: Untuk mendapatkan daftar peserta tahap, ketika peserta telah direplikasi ke tahap lain**
`list-participants`Contoh berikut mencantumkan semua peserta untuk ID sesi tertentu dari ARN tahap tertentu (Nama Sumber Daya Amazon), ketika peserta telah direplikasi ke tahap lain.
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Output:
```
{
"participants": [
{
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingState": "STOPPED",
"state": "DISCONNECTED",
"userId": "",
"replicationState": "ACTIVE",
"replicationType": "SOURCE",
"sourceStageArn": "",
"sourceSessionId": ""
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
**Contoh 3: Untuk mendapatkan daftar peserta tahap, ketika peserta telah direplikasi dari tahap lain**
`list-participants`Contoh berikut mencantumkan semua peserta untuk ID sesi tertentu dari ARN tahap tertentu (Nama Sumber Daya Amazon), ketika peserta telah direplikasi dari tahap lain.
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Output:
```
{
"participants": [
{
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingState": "STOPPED",
"state": "DISCONNECTED",
"userId": "",
"replicationState": "ACTIVE",
"replicationType": "REPLICA",
"sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"sourceSessionId": "st-a1b2c3d4e5f6g"
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
+ Untuk detail API, lihat [ListParticipants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participants.html)di *Referensi AWS CLI Perintah*.
### `list-public-keys`
Contoh kode berikut menunjukkan cara menggunakan`list-public-keys`.
**AWS CLI**
**Untuk mencantumkan kunci publik yang ada yang tersedia untuk menandatangani token peserta panggung**
`list-public-keys`Contoh berikut mencantumkan semua kunci publik yang tersedia untuk menandatangani token peserta tahap, di AWS wilayah tempat permintaan API diproses.
```
aws ivs-realtime list-public-keys
```
Output:
```
{
"publicKeys": [
{
"arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
"name": "",
"tags": {}
},
{
"arn": "arn:aws:ivs:us-west-2:123456789012:public-key/3bcdABCDefg4",
"name": "",
"tags": {}
}
]
}
```
Untuk informasi selengkapnya, lihat [Mendistribusikan Token Peserta](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) di *Panduan Pengguna Streaming Waktu Nyata Amazon IVS*.
+ Untuk detail API, lihat [ListPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-public-keys.html)di *Referensi AWS CLI Perintah*.
### `list-stage-sessions`
Contoh kode berikut menunjukkan cara menggunakan`list-stage-sessions`.
**AWS CLI**
**Untuk mendapatkan daftar sesi panggung**
`list-stage-sessions`Contoh berikut mencantumkan semua sesi untuk ARN tahap tertentu (Nama Sumber Daya Amazon).
```
aws ivs-realtime list-stage-sessions \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Output:
```
{
"stageSessions": [
{
"endTime": "2023-04-26T20:36:29+00:00",
"sessionId": "st-a1b2c3d4e5f6g",
"startTime": "2023-04-26T20:30:29.602000+00:00"
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [ListStageSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-stage-sessions.html)di *Referensi AWS CLI Perintah*.
### `list-stages`
Contoh kode berikut menunjukkan cara menggunakan`list-stages`.
**AWS CLI**
**Untuk mendapatkan informasi ringkasan tentang semua tahapan**
`list-stages`Contoh berikut mencantumkan semua tahapan untuk AWS akun Anda, di AWS wilayah tempat permintaan API diproses.
```
aws ivs-realtime list-stages
```
Output:
```
{
"stages": [
{
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"name": "stage1",
"tags": {}
},
{
"activeSessionId": "st-a123bcd456efg",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcd1234ABCD",
"name": "stage2",
"tags": {}
},
{
"activeSessionId": "st-abcDEF1234ghi",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/ABCD1234efgh",
"name": "stage3",
"tags": {}
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [ListStages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-stages.html)di *Referensi AWS CLI Perintah*.
### `list-storage-configurations`
Contoh kode berikut menunjukkan cara menggunakan`list-storage-configurations`.
**AWS CLI**
**Untuk membuat daftar konfigurasi penyimpanan komposisi**
Berikut ini `list-storage-configurations` mencantumkan semua konfigurasi penyimpanan komposisi untuk AWS akun Anda, di AWS wilayah tempat permintaan API diproses.
```
aws ivs-realtime list-storage-configurations
```
Output:
```
{
"storageConfigurations": [
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
"name": "test-sc-1",
"s3": {
"bucketName": "amzn-s3-demo-bucket-1"
},
"tags": {}
},
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABCefgEFGabc",
"name": "test-sc-2",
"s3": {
"bucketName": "amzn-s3-demo-bucket-2"
},
"tags": {}
}
]
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [ListStorageConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-storage-configurations.html)di *Referensi AWS CLI Perintah*.
### `start-composition`
Contoh kode berikut menunjukkan cara menggunakan`start-composition`.
**AWS CLI**
**Contoh 1: Untuk memulai komposisi dengan pengaturan tata letak default**
`start-composition`Contoh berikut memulai komposisi untuk tahap tertentu yang akan dialirkan ke lokasi yang ditentukan.
```
aws ivs-realtime start-composition \
--stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
--destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
{"s3":{"encoderConfigurationArns":["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
"recordingConfiguration": {"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}, \
"storageConfigurationArn":"arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"}}]'
```
Output:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"state": "STARTING"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 5
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": ""
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"videoAspectRatio": "VIDEO",
"videoFillMode": ""
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STARTING",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Perekaman Komposit IVS \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
**Contoh 2: Untuk memulai komposisi dengan tata letak PiP**
`start-composition`Contoh berikut memulai komposisi untuk tahap tertentu yang akan dialirkan ke lokasi yang ditentukan menggunakan tata letak PiP.
```
aws ivs-realtime start-composition \
--stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
--destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
{"s3":{"encoderConfigurationArns":["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
"storageConfigurationArn":"arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"}}]' \
--layout pip='{featuredParticipantAttribute="abcdefg"}'
```
Output:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"state": "STARTING"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"state": "STARTING"
}
],
"layout": {
"pip": {
"featuredParticipantAttribute": "abcdefg",
"gridGap": 0,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"pipBehavior": "STATIC",
"pipOffset": 0,
"pipParticipantAttribute": "",
"pipPosition": "BOTTOM_RIGHT",
"videoFillMode": "COVER"
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STARTING",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Perekaman Komposit IVS \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
**Contoh 3: Untuk memulai komposisi dengan perekaman thumbnail diaktifkan**
`start-composition`Contoh berikut memulai komposisi untuk tahap tertentu yang akan dialirkan ke lokasi tertentu dengan perekaman thumbnail diaktifkan.
```
aws ivs-realtime start-composition \
--stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
--destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
{"s3": {"encoderConfigurationArns": ["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
"storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", \
"thumbnailConfigurations": [{"storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}]}}]'
```
Output:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"state": "STARTING"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
"thumbnailConfigurations": [
{
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
]
}
]
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": ""
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"videoAspectRatio": "VIDEO",
"videoFillMode": ""
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STARTING",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Perekaman Komposit (Streaming Waktu Nyata)](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
**Contoh 4: Untuk memulai komposisi menggunakan tata letak kisi dengan pemesanan peserta kustom**
`start-composition`Contoh berikut memulai komposisi untuk tahap tertentu yang akan dialirkan ke lokasi yang ditentukan menggunakan tata letak kisi dengan urutan peserta kustom.
```
aws ivs-realtime start-composition \
--stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
--destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
{"s3": {"encoderConfigurationArns": ["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
"storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", \
"thumbnailConfigurations": [{"storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}]}}]' \
--layout grid='{participantOrderAttribute="abcdefg"}'
```
Output:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"state": "STARTING"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
"thumbnailConfigurations": [
{
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
]
}
]
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": ""
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "abcdefg",
"videoAspectRatio": "VIDEO",
"videoFillMode": ""
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STARTING",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Perekaman Komposit IVS \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [StartComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/start-composition.html)di *Referensi AWS CLI Perintah*.
### `start-participant-replication`
Contoh kode berikut menunjukkan cara menggunakan`start-participant-replication`.
**AWS CLI**
**Untuk mulai mereplikasi peserta dari satu tahap ke tahap lain**
`start-participant-replication`Contoh berikut mereplikasi peserta dari tahap sumber ke tahap tujuan, dengan setiap tahap ditentukan oleh ARN (Nama Sumber Daya Amazon).
```
aws ivs-realtime start-participant-replication \
--source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \
--participant-id abCDEf12GHIj
```
Output:
```
{
"accessControlAllowOrigin": "*",
"accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \
Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \
x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options",
"cacheControl": "no-store, no-cache",
"contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;",
"strictTransportSecurity": "max-age:47304000; includeSubDomains",
"xContentTypeOptions": "nosniff",
"xFrameOptions": "DENY"
}
```
Untuk informasi selengkapnya, lihat [Replikasi Peserta IVS di Panduan](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) Pengguna *Streaming Waktu Nyata Amazon IVS*.
+ Untuk detail API, lihat [StartParticipantReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/start-participant-replication.html)di *Referensi AWS CLI Perintah*.
### `stop-composition`
Contoh kode berikut menunjukkan cara menggunakan`stop-composition`.
**AWS CLI**
**Untuk menghentikan komposisi**
Berikut ini `stop-composition` menghentikan komposisi yang ditentukan oleh ARN yang diberikan (Nama Sumber Daya Amazon).
```
aws ivs-realtime stop-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Perintah ini tidak menghasilkan output.
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [StopComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/stop-composition.html)di *Referensi AWS CLI Perintah*.
### `stop-participant-replication`
Contoh kode berikut menunjukkan cara menggunakan`stop-participant-replication`.
**AWS CLI**
**Untuk berhenti mereplikasi peserta dari satu tahap ke tahap lain**
`stop-participant-replication`Contoh berikut berhenti mereplikasi peserta dari tahap sumber ke tahap tujuan, dengan setiap tahap ditentukan oleh ARN (Amazon Resource Name).
```
aws ivs-realtime stop-participant-replication \
--source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \
--participant-id abCDEf12GHIj
```
Output:
```
{
"accessControlAllowOrigin": "*",
"accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \
Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \
x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options",
"cacheControl": "no-store, no-cache",
"contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;",
"strictTransportSecurity": "max-age:47304000; includeSubDomains",
"xContentTypeOptions": "nosniff",
"xFrameOptions": "DENY"
}
```
Untuk informasi selengkapnya, lihat [Replikasi Peserta IVS di Panduan](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) Pengguna *Streaming Waktu Nyata Amazon IVS*.
+ Untuk detail API, lihat [StopParticipantReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/stop-participant-replication.html)di *Referensi AWS CLI Perintah*.
### `update-ingest-configuration`
Contoh kode berikut menunjukkan cara menggunakan`update-ingest-configuration`.
**AWS CLI**
**Untuk memperbarui konfigurasi ingest**
`update-inegst-configuration`Contoh berikut memperbarui konfigurasi ingest untuk melampirkannya ke panggung.
```
aws ivs-realtime update-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Output:
```
{
"ingestConfiguration": {
"name": "ingest1",
"arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
"ingestProtocol": "RTMPS",
"streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
"stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"participantId": "xyZ654abC321",
"state": "INACTIVE",
"userId": "",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [IVS Stream Ingest \$1 Streaming Waktu Nyata](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) di *Panduan Pengguna Layanan Video Interaktif Amazon*.
+ Untuk detail API, lihat [UpdateIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/update-ingest-configuration.html)di *Referensi AWS CLI Perintah*.
### `update-stage`
Contoh kode berikut menunjukkan cara menggunakan`update-stage`.
**AWS CLI**
**Contoh 1: Untuk memperbarui konfigurasi tahap**
`update-stage`Contoh berikut memperbarui tahap untuk ARN tahap tertentu untuk memperbarui nama panggung dan mengonfigurasi perekaman peserta individu dengan perekaman thumbnail diaktifkan.
```
aws ivs-realtime update-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
"thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}} \
"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \
--name stage1a
```
Output:
```
{
"stage": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"mediaTypes": [
"AUDIO_VIDEO"
],
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "INTERVAL"
},
"recordingReconnectWindowSeconds": 100,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 5
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
},
"name": "stage1a",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
**Contoh 2: Untuk memperbarui konfigurasi panggung, termasuk menonaktifkan rekaman replika peserta**
`update-stage`Contoh berikut memperbarui tahap untuk ARN tahap tertentu untuk memperbarui nama panggung dan mengonfigurasi perekaman peserta individu dengan perekaman thumbnail diaktifkan dan rekaman replika peserta dinonaktifkan.
```
aws ivs-realtime update-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
"thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}, "recordParticipantReplicas":false} \
"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \
--name stage1a
```
Output:
```
{
"stage": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"mediaTypes": [
"AUDIO_VIDEO"
],
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "INTERVAL"
},
"recordingReconnectWindowSeconds": 100,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 5
},
"recordParticipantReplicas": false
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
},
"name": "stage1a",
"tags": {}
}
}
```
Untuk informasi selengkapnya, lihat [Mengaktifkan Beberapa Host di Amazon IVS Stream di Panduan Pengguna Streaming](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Latensi Rendah Amazon IVS*.
+ Untuk detail API, lihat [UpdateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/update-stage.html)di *Referensi AWS CLI Perintah*.