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
Il Web RTC ingest con supporto per più visualizzatori (Anteprima) viene fornito in Preview come definito nei Termini di AWS servizio ed è soggetto a modifiche. Attualmente è disponibile solo in IAD us-east-1 ().
Per partecipare all'anteprima, inviaci un'e-mail a kvs-webrtc-multi-view -preview@amazon.com.
Nota
Prima di utilizzarloAPI, è necessario chiamare il GetSignalingChannelEndpoint API per richiedere l'WEBRTCendpoint. È quindi necessario specificare l'endpoint e la regione nella richiesta JoinStorageSessionAsViewerAPI.
JoinStorageSessionAsViewerconsente a uno spettatore di partecipare a una sessione di streaming Web RTC in corso registrata nel cloud. Ciò API avvia una RTC connessione Web inviando un'SDPofferta e ICE dei candidati tra lo spettatore 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 del visualizzatore, se fornito, viene inoltrato a tutti gli altri peer connessi, incluso il partecipante principale, e viene incorporato nel RTC flusso Web salvato nello stream Kinesis Video.
Importante
Gli spettatori al momento 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 e audio H.264. 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 di 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 GetImagesgenerazione di immagini tramite e altro ancora con contenuti multimediali Web acquisiti. RTC
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ò richiamarlo API con lo stesso ID client per ricongiungersi alla sessione senza consumare una quota di spettatori aggiuntiva. Dopo 1 minuto, la quota di spettatori viene rilasciata ed è disponibile per l'adesione di altri spettatori.
Informazioni aggiuntive
-
Idempotente: questo API non è idempotente.
-
Comportamento del nuovo tentativo: 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"
}URIParametri della richiesta
La richiesta non utilizza alcun URI parametro.
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- channelArn
-
L'Amazon Resource Name (ARN) del canale di segnalazione.
Importante
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]+$Campo obbligatorio: sì
- clientId
-
L'identificatore univoco del client mittente.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
^[a-zA-Z0-9_.-]+$Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200 con un corpo vuotoHTTP.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AccessDeniedException
-
Non hai le autorizzazioni necessarie per eseguire questa operazione.
HTTPCodice di stato: 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.
HTTPCodice di stato: 400
- InvalidArgumentException
-
Il valore di questo parametro di input non è valido.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
La risorsa specificata non è stata trovata.
HTTPCodice di stato: 404
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
