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 utilizzarloAPI, è necessario chiamare il GetSignalingChannelEndpoint API per richiedere l'WEBRTCendpoint. È quindi necessario specificare l'endpoint e la regione nella richiesta JoinStorageSessionAPI.
Partecipa alla RTC sessione Web in corso con video unidirezionale e/o audio multidirezionale 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'RTCinserimento sul Web.
Requisiti attuali:
-
Traccia video: H.264
-
Traccia audio: Opus
Il video acquisito risultante nel flusso video Kinesis avrà i seguenti parametri: video e audio H.264. 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 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.
Informazioni aggiuntive
-
Idempotente: non è idempotente. API
-
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 /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "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ì
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 HTTP corpo vuoto.
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 di questo API codice in una delle lingue specifiche AWS SDKs, consulta quanto segue:
