Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples de diffusion en temps réel d'Amazon IVS à l'aide d'Amazon IVS AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le streaming en temps réel AWS Command Line Interface avec Amazon IVS.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `create-encoder-configuration`
L'exemple de code suivant montre comment utiliser`create-encoder-configuration`.
**AWS CLI**
**Pour créer une configuration d’encodeur de montage**
L’exemple `create-encoder-configuration` suivant crée une configuration d’encodeur de montage avec les propriétés spécifiées.
```
aws ivs-realtime create-encoder-configuration \
--name test-ec --video bitrate=3500000,framerate=30.0,height=1080,width=1920
```
Sortie :
```
{
"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
}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [CreateEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-encoder-configuration.html)à la section *Référence des AWS CLI commandes*.
### `create-ingest-configuration`
L'exemple de code suivant montre comment utiliser`create-ingest-configuration`.
**AWS CLI**
**Pour créer une configuration d’ingestion**
L’exemple `create-ingest-configuration` suivant crée une configuration d’ingestion à l’aide du protocole RTMPS.
```
aws ivs-realtime create-ingest-configuration \
--name ingest1 \
--ingest-protocol rtmps
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Ingestion de flux IVS \$1 Diffusion en temps réel](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [CreateIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-ingest-configuration.html)à la section *Référence des AWS CLI commandes*.
### `create-participant-token`
L'exemple de code suivant montre comment utiliser`create-participant-token`.
**AWS CLI**
**Pour créer un jeton de participant à l’étape**
L’exemple `create-participant-token` suivant crée un jeton de participant pour l’étape spécifiée.
```
aws ivs-realtime create-participant-token \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--user-id bob
```
Sortie :
```
{
"participantToken": {
"expirationTime": "2023-03-07T09:47:43+00:00",
"participantId": "ABCDEfghij01234KLMN6789",
"token": "abcd1234defg5678"
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [CreateParticipantToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-participant-token.html)à la section *Référence des AWS CLI commandes*.
### `create-stage`
L'exemple de code suivant montre comment utiliser`create-stage`.
**AWS CLI**
**Exemple 1 : pour créer une étape**
L’exemple `create-stage` suivant crée une étape et un jeton de participant à l’étape pour un utilisateur spécifié.
```
aws ivs-realtime create-stage \
--name stage1 \
--participant-token-configurations userId=alice
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
**Exemple 2 : pour créer une étape et configurer l'enregistrement individuel des participants**
L’exemple `create-stage` suivant crée une étape et configure l’enregistrement individuel des participants.
```
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}}'
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
**Exemple 3 : pour créer une étape et configurer l'enregistrement individuel des participants avec l'enregistrement des vignettes activé**
L’exemple `create-stage` suivant crée une étape et configure l’enregistrement individuel des participants avec l’enregistrement des miniatures activé.
```
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}}'
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [CreateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-stage.html)à la section *Référence des AWS CLI commandes*.
### `create-storage-configuration`
L'exemple de code suivant montre comment utiliser`create-storage-configuration`.
**AWS CLI**
**Pour créer une configuration de stockage de montage**
L’exemple `create-storage-configuration` suivant crée une configuration de stockage de montage avec les propriétés spécifiées.
```
aws ivs-realtime create-storage-configuration \
--name "test-sc" --s3 "bucketName=amzn-s3-demo-bucket"
```
Sortie :
```
{
"storageConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef",
"name": "test-sc",
"s3": {
"bucketName": "amzn-s3-demo-bucket"
},
"tags": {}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [CreateStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-storage-configuration.html)à la section *Référence des AWS CLI commandes*.
### `delete-encoder-configuration`
L'exemple de code suivant montre comment utiliser`delete-encoder-configuration`.
**AWS CLI**
**Pour supprimer la configuration d’un encodeur de montage**
`delete-encoder-configuration` ci-dessous supprime la configuration de l’encodeur de montage spécifiée par l’ARN (Amazon Resource Name) donné.
```
aws ivs-realtime delete-encoder-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-encoder-configuration.html)à la section *Référence des AWS CLI commandes*.
### `delete-ingest-configuration`
L'exemple de code suivant montre comment utiliser`delete-ingest-configuration`.
**AWS CLI**
**Exemple 1 : pour supprimer une configuration d’ingestion inactive**
L’exemple `delete-ingest-configuration` suivant supprime la configuration d’ingestion inactive pour un ARN (Amazon Resource Name) de configuration d’ingestion spécifié.
```
aws ivs-realtime delete-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Ingestion de flux IVS \$1 Diffusion en temps réel](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
**Exemple 2 : pour forcer la suppression d’une configuration d’ingestion active**
L’exemple `delete-ingest-configuration` suivant force la suppression de la configuration d’ingestion active pour un ARN (Amazon Resource Name) de configuration d’ingestion spécifié.
```
aws ivs-realtime delete-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \
--force
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Ingestion de flux IVS \$1 Diffusion en temps réel](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-ingest-configuration.html)à la section *Référence des AWS CLI commandes*.
### `delete-public-key`
L'exemple de code suivant montre comment utiliser`delete-public-key`.
**AWS CLI**
**Pour supprimer une clé publique**
`delete-public-key` ci-dessous supprime la clé publique spécifiée.
```
aws ivs-realtime delete-public-key \
--arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Distribuer des jetons de participants](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) dans le *Guide de l’utilisateur de la diffusion en temps réel d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [DeletePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-public-key.html)à la section *Référence des AWS CLI commandes*.
### `delete-stage`
L'exemple de code suivant montre comment utiliser`delete-stage`.
**AWS CLI**
**Pour supprimer une étape**
L’exemple `delete-stage` suivant supprime l’étape spécifiée.
```
aws ivs-realtime delete-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-stage.html)à la section *Référence des AWS CLI commandes*.
### `delete-storage-configuration`
L'exemple de code suivant montre comment utiliser`delete-storage-configuration`.
**AWS CLI**
**Pour supprimer une configuration de stockage de montage**
`delete-storage-configuration` ci-dessous supprime la configuration du stockage de montage spécifiée par l’ARN (Amazon Resource Name) donné.
```
aws ivs-realtime delete-storage-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-storage-configuration.html)à la section *Référence des AWS CLI commandes*.
### `disconnect-participant`
L'exemple de code suivant montre comment utiliser`disconnect-participant`.
**AWS CLI**
**Pour déconnecter un participant à l’étape**
L’exemple `disconnect-participant` suivant déconnecte le participant spécifié de l’étape spécifiée.
```
aws ivs-realtime disconnect-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--participant-id ABCDEfghij01234KLMN5678
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [DisconnectParticipant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/disconnect-participant.html)à la section *Référence des AWS CLI commandes*.
### `get-composition`
L'exemple de code suivant montre comment utiliser`get-composition`.
**AWS CLI**
**Exemple 1 : pour obtenir un montage avec les paramètres de mise en page par défaut**
L’exemple `get-composition` suivant obtient le montage de l’ARN (Amazon Resource Name) spécifié.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez [IVS Composite Recording \$1 Real-Time Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) dans le *guide de l'utilisateur d'Amazon Interactive Video Service*.
**Exemple 2 : pour obtenir un montage avec une mise en page PiP**
L’exemple `get-composition` suivant obtient le montage de l’ARN (Amazon Resource Name) spécifié, qui utilise la mise en page PiP.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs"
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez [IVS Composite Recording \$1 Real-Time Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) dans le *guide de l'utilisateur d'Amazon Interactive Video Service*.
**Exemple 3 : pour obtenir un montage avec l’enregistrement des miniatures activé**
L’exemple `get-composition` suivant obtient le montage de l’ARN (Amazon Resource Name) spécifié, pour lequel l’enregistrement des miniatures est activé avec les paramètres par défaut.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez [IVS Composite Recording \$1 Real-Time Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) dans le *guide de l'utilisateur d'Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [GetComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-composition.html)à la section *Référence des AWS CLI commandes*.
### `get-encoder-configuration`
L'exemple de code suivant montre comment utiliser`get-encoder-configuration`.
**AWS CLI**
**Pour obtenir la configuration d’un encodeur de montage**
L’exemple `get-encoder-configuration` suivant obtient la configuration d’un encodeur de montage spécifiée par l’ARN (Amazon Resource Name) donné.
```
aws ivs-realtime get-encoder-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh"
```
Sortie :
```
{
"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
}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [GetEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-encoder-configuration.html)à la section *Référence des AWS CLI commandes*.
### `get-ingest-configuration`
L'exemple de code suivant montre comment utiliser`get-ingest-configuration`.
**AWS CLI**
**Pour obtenir des informations de configuration d’ingestion**
L’exemple `get-ingest-configuration` suivant obtient la configuration d’ingestion pour un ARN (Amazon Resource Name) de configuration d’ingestion spécifié.
```
aws ivs-realtime get-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Ingestion de flux IVS \$1 Diffusion en temps réel](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [GetIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-ingest-configuration.html)à la section *Référence des AWS CLI commandes*.
### `get-participant`
L'exemple de code suivant montre comment utiliser`get-participant`.
**AWS CLI**
**Exemple 1 : pour obtenir un participant à l’étape**
L’exemple `get-participant` suivant obtient le participant à l’étape pour un ID de participant et un identifiant de session spécifiés dans l’ARN (Amazon Resource Name) de l’étape spécifié.
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Sortie :
```
{
"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": ""
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
**Exemple 2 : pour obtenir un participant à l’étape qui a été répliqué sur une autre étape**
L’exemple `get-participant` suivant obtient le participant à l’étape pour un ID de participant et un identifiant de session spécifiés dans l’ARN (Amazon Resource Name) de l’étape spécifié, lorsque le participant a également été répliqué sur une autre étape.
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Sortie :
```
{
"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": ""
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
**Exemple 3 : pour obtenir un participant à une étape qui a été répliqué depuis une autre étape**
L’exemple `get-participant` suivant obtient le participant à l’étape pour un ID de participant et un identifiant de session spécifiés dans l’ARN (Amazon Resource Name) de l’étape spécifié, lorsque le participant a été répliqué depuis une autre étape.
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Sortie :
```
{
"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": ""
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [GetParticipant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-participant.html)à la section *Référence des AWS CLI commandes*.
### `get-public-key`
L'exemple de code suivant montre comment utiliser`get-public-key`.
**AWS CLI**
**Pour obtenir une clé publique existante utilisée pour signer les jetons des participants à l’étape**
L’exemple `get-public-key` suivant obtient une clé publique spécifiée par l’ARN fourni, pour signer les jetons des participants à l’étape.
```
aws ivs-realtime get-public-key \
--arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Distribuer des jetons de participants](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) dans le *Guide de l’utilisateur de la diffusion en temps réel d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [GetPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-public-key.html)à la section *Référence des AWS CLI commandes*.
### `get-stage-session`
L'exemple de code suivant montre comment utiliser`get-stage-session`.
**AWS CLI**
**Pour obtenir une session d’étape**
L’exemple `get-stage-session` suivant obtient la session d’étape pour un ID de session spécifié d’un ARN (Amazon Resource Name) d’étape spécifié.
```
aws ivs-realtime get-stage-session \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Sortie :
```
{
"stageSession": {
"endTime": "2023-04-26T20:36:29+00:00",
"sessionId": "st-a1b2c3d4e5f6g",
"startTime": "2023-04-26T20:30:29.602000+00:00"
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [GetStageSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-stage-session.html)à la section *Référence des AWS CLI commandes*.
### `get-stage`
L'exemple de code suivant montre comment utiliser`get-stage`.
**AWS CLI**
**Pour obtenir les informations de configuration d’une étape**
L’exemple `get-stage` suivant obtient la configuration d’une étape pour un ARN (Amazon Resource Name) d’étape spécifié.
```
aws ivs-realtime get-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [GetStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-stage.html)à la section *Référence des AWS CLI commandes*.
### `get-storage-configuration`
L'exemple de code suivant montre comment utiliser`get-storage-configuration`.
**AWS CLI**
**Pour obtenir une configuration de stockage de montage**
L’exemple `get-storage-configuration` suivant obtient la configuration de stockage de montage spécifiée par l’ARN (Amazon Resource Name) donné.
```
aws ivs-realtime get-storage-configuration \
--name arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh"
```
Sortie :
```
{
"storageConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
"name": "test-sc",
"s3": {
"bucketName": "amzn-s3-demo-bucket"
},
"tags": {}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [GetStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-storage-configuration.html)à la section *Référence des AWS CLI commandes*.
### `import-public-key`
L'exemple de code suivant montre comment utiliser`import-public-key`.
**AWS CLI**
**Pour importer une clé publique existante à utiliser pour signer les jetons des participants à l’étape**
L’exemple `import-public-key` suivant importe une clé publique à partir d’un fichier matériel, à utiliser pour signer les jetons des participants à l’étape.
```
aws ivs-realtime import-public-key \
--public-key-material="`cat public.pem`"
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Distribuer des jetons de participants](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) dans le *Guide de l’utilisateur de la diffusion en temps réel d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [ImportPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/import-public-key.html)à la section *Référence des AWS CLI commandes*.
### `list-compositions`
L'exemple de code suivant montre comment utiliser`list-compositions`.
**AWS CLI**
**Pour obtenir une liste des montages**
Vous trouverez ci-dessous la `list-compositions` liste de toutes les compositions pour votre AWS compte, dans la AWS région où la demande d'API est traitée.
```
aws ivs-realtime list-compositions
```
Sortie :
```
{
"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": {}
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [ListCompositions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-compositions.html)à la section *Référence des AWS CLI commandes*.
### `list-encoder-configurations`
L'exemple de code suivant montre comment utiliser`list-encoder-configurations`.
**AWS CLI**
**Pour répertorier les configurations des encodeurs de montage**
Vous trouverez ci-dessous la `list-encoder-configurations` liste de toutes les configurations d'encodeur de composition pour votre AWS compte, dans la AWS région où la demande d'API est traitée.
```
aws ivs-realtime list-encoder-configurations
```
Sortie :
```
{
"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": {}
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [ListEncoderConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-encoder-configurations.html)à la section *Référence des AWS CLI commandes*.
### `list-ingest-configurations`
L'exemple de code suivant montre comment utiliser`list-ingest-configurations`.
**AWS CLI**
**Pour obtenir des informations récapitulatives sur toutes les configurations d’ingestion**
L'`list-ingest-configurations`exemple suivant répertorie toutes les configurations d'ingestion pour votre AWS compte, dans la AWS région où la demande d'API est traitée.
```
aws ivs-realtime list-ingest-configurations
```
Sortie :
```
{
"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": "",
}
]
}
```
Pour plus d’informations, consultez [Ingestion de flux IVS \$1 Diffusion en temps réel](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [ListIngestConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-ingest-configurations.html)à la section *Référence des AWS CLI commandes*.
### `list-participant-events`
L'exemple de code suivant montre comment utiliser`list-participant-events`.
**AWS CLI**
**Exemple 1 : pour obtenir une liste des événements des participants à l’étape**
L’exemple `list-participant-events` suivant répertorie tous les événements des participants pour un ID de participant et un ID de session spécifiés pour un ARN (Amazon Resource Name) d’étape spécifié.
```
aws ivs-realtime list-participant-events \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
**Exemple 2 : pour obtenir une liste des événements des participants à l’étape, y compris l’arrêt et le démarrage de la réplication des participants**
L’exemple `list-participant-events` suivant répertorie tous les événements des participants pour un ID de session spécifié ou un ARN (Amazon Resource Name) d’étape spécifiés, lorsqu’un participant est répliqué vers une autre étape.
```
aws ivs-realtime list-participant-events \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [ListParticipantEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participant-events.html)à la section *Référence des AWS CLI commandes*.
### `list-participant-replicas`
L'exemple de code suivant montre comment utiliser`list-participant-replicas`.
**AWS CLI**
**Pour obtenir une liste des réplicas des participants à l’étape**
L’exemple `list-participant-replicas` suivant répertorie tous les participants à l’étape répliqués depuis l’ARN (Amazon Resource Name) de l’étape source spécifié vers une autre étape.
```
aws ivs-realtime list-participant-replicas \
--source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--participant-id abCDEf12GHIj
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d’informations, consultez [Réplication du participant IVS](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) dans le *Guide de l’utilisateur de la diffusion en temps réel d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [ListParticipantReplicas](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participant-replicas.html)à la section *Référence des AWS CLI commandes*.
### `list-participants`
L'exemple de code suivant montre comment utiliser`list-participants`.
**AWS CLI**
**Exemple 1 : pour obtenir la liste des participants à l’étape**
L’exemple `list-participants` suivant répertorie tous les participants pour un ID de session spécifié d’un ARN (Amazon Resource Name) d’étape spécifié.
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Sortie :
```
{
"participants": [
{
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingState": "STOPPED",
"state": "DISCONNECTED",
"userId": ""
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
**Exemple 2 : pour obtenir une liste des participants à une étape, lorsqu’un participant a été répliqué vers une autre étape**
L’exemple `list-participants` suivant répertorie tous les participants pour un ID de session spécifié d’un ARN (Amazon Resource Name) d’étape spécifié, lorsqu’un participant a été répliqué vers une autre étape.
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Sortie :
```
{
"participants": [
{
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingState": "STOPPED",
"state": "DISCONNECTED",
"userId": "",
"replicationState": "ACTIVE",
"replicationType": "SOURCE",
"sourceStageArn": "",
"sourceSessionId": ""
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
**Exemple 3 : pour obtenir une liste des participants à l’étape, lorsqu’un participant a été répliqué depuis une autre étape**
L’exemple `list-participants` suivant répertorie tous les participants pour un ID de session spécifié d’un ARN (Amazon Resource Name) d’étape spécifié, lorsqu’un participant a été répliqué depuis une autre étape.
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [ListParticipants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participants.html)à la section *Référence des AWS CLI commandes*.
### `list-public-keys`
L'exemple de code suivant montre comment utiliser`list-public-keys`.
**AWS CLI**
**Pour répertorier les clés publiques existantes disponibles pour signer les jetons des participants**
L'`list-public-keys`exemple suivant répertorie toutes les clés publiques disponibles pour signer les jetons des participants à l'étape, dans la AWS région où la demande d'API est traitée.
```
aws ivs-realtime list-public-keys
```
Sortie :
```
{
"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": {}
}
]
}
```
Pour plus d’informations, consultez [Distribuer des jetons de participants](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) dans le *Guide de l’utilisateur de la diffusion en temps réel d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [ListPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-public-keys.html)à la section *Référence des AWS CLI commandes*.
### `list-stage-sessions`
L'exemple de code suivant montre comment utiliser`list-stage-sessions`.
**AWS CLI**
**Pour obtenir une liste des sessions d’étape**
L’exemple `list-stage-sessions` suivant répertorie toutes les sessions pour un ARN (Amazon Resource Name) d’étape spécifié.
```
aws ivs-realtime list-stage-sessions \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Sortie :
```
{
"stageSessions": [
{
"endTime": "2023-04-26T20:36:29+00:00",
"sessionId": "st-a1b2c3d4e5f6g",
"startTime": "2023-04-26T20:30:29.602000+00:00"
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [ListStageSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-stage-sessions.html)à la section *Référence des AWS CLI commandes*.
### `list-stages`
L'exemple de code suivant montre comment utiliser`list-stages`.
**AWS CLI**
**Pour obtenir des informations récapitulatives sur toutes les étapes**
L'`list-stages`exemple suivant répertorie toutes les étapes de votre AWS compte, dans la AWS région où la demande d'API est traitée.
```
aws ivs-realtime list-stages
```
Sortie :
```
{
"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": {}
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [ListStages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-stages.html)à la section *Référence des AWS CLI commandes*.
### `list-storage-configurations`
L'exemple de code suivant montre comment utiliser`list-storage-configurations`.
**AWS CLI**
**Pour répertorier les configurations de stockage de montage**
Vous trouverez ci-dessous la `list-storage-configurations` liste de toutes les configurations de stockage des compositions pour votre AWS compte, dans la AWS région où la demande d'API est traitée.
```
aws ivs-realtime list-storage-configurations
```
Sortie :
```
{
"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": {}
}
]
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [ListStorageConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-storage-configurations.html)à la section *Référence des AWS CLI commandes*.
### `start-composition`
L'exemple de code suivant montre comment utiliser`start-composition`.
**AWS CLI**
**Exemple 1 : pour démarrer un montage avec les paramètres de mise en page par défaut**
L’exemple `start-composition` suivant démarre un montage pour l’étape spécifiée à diffuser vers les emplacements spécifiés.
```
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"}}]'
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez [IVS Composite Recording \$1 Real-Time Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) dans le *guide de l'utilisateur d'Amazon Interactive Video Service*.
**Exemple 2 : pour démarrer un montage avec une mise en page PiP**
L’exemple `start-composition` suivant démarre un montage pour l’étape spécifiée à diffuser vers les emplacements spécifiés à l’aide d’une mise en page 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"}'
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez [IVS Composite Recording \$1 Real-Time Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) dans le *guide de l'utilisateur d'Amazon Interactive Video Service*.
**Exemple 3 : pour démarrer un montage avec l’enregistrement des miniatures activé**
L’exemple `start-composition` suivant démarre un montage pour l’étape spécifiée à diffuser vers les emplacements spécifiés avec l’enregistrement des miniatures activé.
```
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}]}}]'
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez la section [Enregistrement composite (diffusion en temps réel)](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) dans le *guide de l'utilisateur d'Amazon Interactive Video Service*.
**Exemple 4 : Pour démarrer une composition à l'aide d'une mise en page en grille avec un ordre personnalisé des participants**
L'`start-composition`exemple suivant lance une composition pour l'étape spécifiée à diffuser aux emplacements spécifiés en utilisant une disposition en grille avec un ordre personnalisé des participants.
```
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"}'
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d'informations, consultez [IVS Composite Recording \$1 Real-Time Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) dans le *guide de l'utilisateur d'Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [StartComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/start-composition.html)à la section *Référence des AWS CLI commandes*.
### `start-participant-replication`
L'exemple de code suivant montre comment utiliser`start-participant-replication`.
**AWS CLI**
**Pour commencer à répliquer un participant d’une étape à l’autre**
L’exemple `start-participant-replication` suivant réplique un participant d’une étape source vers une étape de destination, chaque étape étant spécifiée par son ARN (Amazon Resource Name).
```
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
```
Sortie :
```
{
"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"
}
```
Pour plus d’informations, consultez [Réplication du participant IVS](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) dans le *Guide de l’utilisateur de la diffusion en temps réel d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [StartParticipantReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/start-participant-replication.html)à la section *Référence des AWS CLI commandes*.
### `stop-composition`
L'exemple de code suivant montre comment utiliser`stop-composition`.
**AWS CLI**
**Pour arrêter un montage**
`stop-composition` ci-dessous arrête le montage spécifié par l’ARN (Amazon Resource Name) donné.
```
aws ivs-realtime stop-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [StopComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/stop-composition.html)à la section *Référence des AWS CLI commandes*.
### `stop-participant-replication`
L'exemple de code suivant montre comment utiliser`stop-participant-replication`.
**AWS CLI**
**Pour arrêter de répliquer un participant d’une étape à l’autre**
L’exemple `stop-participant-replication` suivant arrêter de répliquer un participant d’une étape source vers une étape de destination, chaque étape étant spécifiée par son 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
```
Sortie :
```
{
"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"
}
```
Pour plus d’informations, consultez [Réplication du participant IVS](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) dans le *Guide de l’utilisateur de la diffusion en temps réel d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [StopParticipantReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/stop-participant-replication.html)à la section *Référence des AWS CLI commandes*.
### `update-ingest-configuration`
L'exemple de code suivant montre comment utiliser`update-ingest-configuration`.
**AWS CLI**
**Pour mettre à jour une configuration d’ingestion**
L’exemple `update-inegst-configuration` suivant met à jour une configuration d’ingestion pour l’associer à une étape.
```
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
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Ingestion de flux IVS \$1 Diffusion en temps réel](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) dans le *Guide de l’utilisateur Amazon Interactive Video Service*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/update-ingest-configuration.html)à la section *Référence des AWS CLI commandes*.
### `update-stage`
L'exemple de code suivant montre comment utiliser`update-stage`.
**AWS CLI**
**Exemple 1 : pour mettre à jour la configuration d’une étape**
L’exemple `update-stage` suivant met à jour une étape pour un ARN d’étape spécifié afin de mettre à jour le nom de l’étape et de configurer l’enregistrement individuel des participants avec l’enregistrement des miniatures activé.
```
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
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
**Exemple 2 : pour mettre à jour la configuration d’une étape, notamment en désactivant l’enregistrement des réplicas des participants**
L’exemple `update-stage` suivant met à jour une étape pour un ARN d’étape spécifié afin de mettre à jour le nom de l’étape et de configurer l’enregistrement individuel des participants avec l’enregistrement des miniatures activé et l’enregistrement des réplicas des participants désactivé.
```
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
```
Sortie :
```
{
"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": {}
}
}
```
Pour plus d’informations, consultez [Activation d’hôtes multiples sur un flux Amazon IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) dans le *Guide de l’utilisateur de la diffusion à faible latence d’Amazon IVS*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/update-stage.html)à la section *Référence des AWS CLI commandes*.