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.
# JoinStorageSessionAsViewer
**Note**
Avant d'utiliser cette API, vous devez appeler l'`GetSignalingChannelEndpoint`API pour demander le point de terminaison WEBRTC. Vous spécifiez ensuite le point de terminaison et la région dans votre demande d'`JoinStorageSessionAsViewer`API.
`JoinStorageSessionAsViewer`permet à un utilisateur de rejoindre une session de streaming WebRTC en cours enregistrée dans le cloud. Cette API établit une connexion WebRTC en envoyant une offre SDP et des candidats ICE entre le spectateur et l'agent d'enregistrement, permettant au spectateur de recevoir une vidéo en temps réel du maître via l'agent d'enregistrement et de participer à une communication audio bidirectionnelle via l'agent d'enregistrement. Une fois connecté, le son du spectateur, s'il est fourni, est transmis à tous les autres pairs connectés, y compris le participant principal, et est intégré au flux WebRTC enregistré dans le flux Kinesis Video.
**Important**
Les spectateurs ne peuvent actuellement pas envoyer de pistes vidéo. Les spectateurs peuvent envoyer une piste audio facultative ou ne pas envoyer de piste du tout.
Exigences actuelles relatives à l'envoi des spectateurs par les participants :
Piste vidéo : non prise en charge
Piste audio (en option) : Opus
Si le participant principal est actuellement connecté à l'appareil de production vidéo, la vidéo ingérée qui en résulte dans le flux vidéo Kinesis comportera les paramètres suivants : vidéo H.264 et audio AAC.
**Note**
Les participants spectateurs se connectent directement à la session de stockage et non directement au participant principal. La session de stockage se charge du mixage, de la duplication et du routage du média vers la destination appropriée.
**Note**
Si le participant principal n'est pas présent, les spectateurs ne pourront pas s'entendre.
Une fois que le participant téléspectateur a négocié une connexion via WebRTC, la session audio ingérée est stockée dans le flux vidéo Kinesis tant que le participant principal est également connecté à la session de stockage.
Vous pouvez également utiliser les fonctionnalités existantes de Kinesis Video Streams, `HLS` telles que `DASH` la lecture, la génération d'images [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)via, etc., avec du contenu WebRTC ingéré.
**Note**
La livraison d'images et les notifications S3 ne sont actuellement pas prises en charge.
**Note**
Supposons qu'un seul appareil de production vidéo client puisse être associé à une session pour le canal. Si plusieurs clients rejoignent la session d'une chaîne spécifique en tant que périphérique de production vidéo, la demande la plus récente du client a priorité.
**Restrictions**
Les limites actuelles sont en place :
+ **Nombre maximum de spectateurs :** 3
+ **Durée maximale pendant laquelle les spectateurs restent connectés à la session de stockage en l'absence d'un participant principal :** 3 minutes
**Important**
Si un utilisateur se déconnecte de la session de stockage (ferme la connexion homologue), son quota (limite de spectateurs) reste consommé pendant 1 minute. Pendant cette période d'une minute, le spectateur peut invoquer cette API avec le même ID client pour rejoindre la session sans consommer un quota de spectateurs supplémentaire. Au bout d'une minute, le quota de spectateurs est libéré et les autres spectateurs peuvent le rejoindre.
**Informations supplémentaires**
+ **Idempotent** - Cette API n'est pas idempotente.
+ **Comportement des** nouvelles tentatives : cela est considéré comme un nouvel appel d'API.
+ **Appels simultanés** - Les appels simultanés sont autorisés. Une offre est envoyée une fois par appel.
## Syntaxe de la demande
```
POST /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json
{
"channelArn": "{{string}}",
"clientId": "{{string}}"
}
```
## Paramètres de demande URI
La demande n’utilise pas de paramètres URI.
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
** [channelArn](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) **
L'Amazon Resource Name (ARN) du canal de signalisation.
Notez la capitalisation de ce paramètre d'entrée.
Type : Chaîne
Modèle : `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`
Obligatoire : oui
** [clientId](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) **
Identifiant unique du client expéditeur.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle : `[a-zA-Z0-9_.-]+`
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations requises pour effectuer cette opération.
Code d’état HTTP : 403
** ClientLimitExceededException **
Kinesis Video Streams a limité la demande car vous avez dépassé le nombre maximal d'appels clients autorisés. Essayez de passer l'appel plus tard.
Code d’état HTTP : 400
** InvalidArgumentException **
La valeur de ce paramètre d'entrée n'est pas valide.
Code d’état HTTP : 400
** ResourceNotFoundException **
La ressource spécifiée est introuvable.
Code d’état HTTP :404
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)