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à. # JoinStorageSessionAsViewer **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. `JoinStorageSessionAsViewer` `JoinStorageSessionAsViewer`consente a uno spettatore di partecipare a una sessione di streaming WebRTC registrata nel cloud in corso. Questa API avvia una connessione WebRTC inviando un'offerta SDP e candidati ICE tra il visualizzatore e l'agente di registrazione, permettendo allo spettatore di ricevere video in tempo reale dal master tramite l'agente di registrazione e partecipare alla comunicazione audio bidirezionale tramite l'agente di registrazione. Una volta connesso, l'audio dello spettatore, se fornito, viene inoltrato a tutti gli altri peer connessi, incluso il partecipante principale, e viene incorporato nel flusso WebRTC salvato nello stream Kinesis Video. **Importante** Al momento gli spettatori non possono inviare alcuna traccia video. Gli spettatori possono inviare una traccia audio opzionale o non inviare alcuna traccia. Requisiti di invio per il partecipante attuale spettatore: Traccia video: non supportata Traccia audio (opzionale): Opus Se il partecipante principale è attualmente connesso al dispositivo di produzione video, il video acquisito risultante nel flusso video Kinesis avrà i seguenti parametri: video H.264 e audio AAC. **Nota** I partecipanti al visualizzatore si connettono direttamente alla sessione di archiviazione e non direttamente al partecipante principale. La sessione di archiviazione si occupa della miscelazione, della duplicazione e del routing dei file multimediali verso la destinazione appropriata. **Nota** Se il partecipante principale non è presente, gli spettatori non potranno ascoltarsi. Una volta che il partecipante spettatore ha negoziato una connessione tramite WebRTC, la sessione audio acquisita verrà archiviata nel flusso video Kinesis a condizione che anche il partecipante principale sia connesso alla sessione di archiviazione. 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. **Limiti** I limiti attuali sono validi: + **Numero massimo di spettatori: 3** + **Tempo massimo per cui i partecipanti allo spettatore rimangono connessi alla sessione di archiviazione senza la presenza di un partecipante principale: 3 minuti** **Importante** Se uno spettatore si disconnette dalla sessione di archiviazione (chiude la connessione peer), la sua quota (limite di spettatori) rimane utilizzata per 1 minuto. Durante questo periodo di 1 minuto, lo spettatore può richiamare questa API con lo stesso ID client per ricongiungersi alla sessione senza consumare una quota di visualizzatori aggiuntiva. Dopo 1 minuto, la quota di spettatori viene rilasciata ed è disponibile per l'adesione di altri spettatori. **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 /joinStorageSessionAsViewer HTTP/1.1 Content-type: application/json { "channelArn": "{{string}}", "clientId": "{{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_JoinStorageSessionAsViewer_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ì ** [clientId](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) ** L'identificatore univoco del client mittente. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri. Modello: `[a-zA-Z0-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 disponi 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/JoinStorageSessionAsViewer) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK per C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)