Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# JoinStorageSession
**Nota**
Prima di utilizzare questa API, è necessario chiamare l'`GetSignalingChannelEndpoint`API per richiedere l'endpoint WEBRTC. È quindi necessario specificare l'endpoint e la regione nella richiesta API. `JoinStorageSession`
Partecipa alla sessione WebRTC and/or audio multidirezionale in corso con video unidirezionale come dispositivo di produzione video per un canale di ingresso. Se non esiste una sessione esistente per il canale, crea una nuova sessione di streaming e fornisci l'Amazon Resource Name (ARN) del canale di segnalazione.
Attualmente, per `SINGLE_MASTER` questo tipo di dispositivo, un dispositivo di produzione video è in grado di importare contenuti audio e video in uno stream. Solo i dispositivi per la produzione di video possono partecipare alla sessione e registrare contenuti multimediali.
**Importante**
Attualmente sono necessarie sia le tracce audio che quelle video per l'ingestione di WebRTC.
Requisiti attuali:
Traccia video: H.264
Traccia audio: Opus
Video:
La risoluzione massima è SQFHD (1920x1920)
L'ingestione di KVS WebRTC attualmente supporta un set specifico di profili H264:
linea di base vincolata
della deviazione del bias
principale
high
elevato e vincolato
progressivo-alto
Il video acquisito risultante nel flusso video Kinesis avrà i seguenti parametri: video H.264 e audio AAC.
Una volta che un partecipante principale ha negoziato una connessione tramite WebRTC, la sessione multimediale acquisita verrà archiviata nel flusso video di Kinesis. Più spettatori saranno quindi in grado di riprodurre contenuti multimediali in tempo reale tramite il nostro Playback. APIs
Puoi anche utilizzare le `HLS` funzionalità esistenti di Kinesis Video Streams `DASH` come la riproduzione, la [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)generazione di immagini tramite e altro ancora con i contenuti multimediali WebRTC incorporati.
**Nota**
La consegna e le notifiche delle immagini S3 non sono attualmente supportate.
**Nota**
Supponiamo che sia possibile associare un solo dispositivo client per la produzione di video a una sessione per il canale. Se più di un client si unisce alla sessione di un canale specifico come dispositivo di produzione video, la richiesta più recente del client ha la precedenza.
**Informazioni aggiuntive**
+ **Idempotente: questa API non è idempotente**.
+ **Comportamento dei tentativi**: viene conteggiata come una nuova chiamata API.
+ **Chiamate simultanee: le chiamate** simultanee sono consentite. Un'offerta viene inviata una volta per ogni chiamata.
## Sintassi della richiesta
```
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "{{string}}"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [channelArn](#API_webrtc_JoinStorageSession_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del canale di segnalazione.
Nota le lettere maiuscole di questo parametro di input.
Tipo: stringa
Modello: `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponete delle autorizzazioni necessarie per eseguire questa operazione.
Codice di stato HTTP: 403
** ClientLimitExceededException **
Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di chiamate client consentite. Prova a effettuare la chiamata più tardi.
Codice di stato HTTP: 400
** InvalidArgumentException **
Il valore di questo parametro di input non è valido.
Codice di stato HTTP: 400
** ResourceNotFoundException **
La risorsa specificata non è stata trovata.
Codice di stato HTTP: 404
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)