Utilizzo della replica dei supporti - SDK Amazon Chime

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à.

Utilizzo della replica dei supporti

È possibile utilizzare la replica multimediale per collegare una sessione WebRTC principale con più sessioni di replica per raggiungere un pubblico più ampio. Ogni sessione multimediale WebRTC supporta 250 connessioni ed è possibile replicare una sessione principale in più sessioni di replica. I partecipanti collegati a una sessione di replica ricevono solo l'audio e il video dei relatori collegati alla sessione principale. Non conoscono i partecipanti collegati alla sessione replicata, il che rende la replica multimediale ideale per webinar e altri casi d'uso in cui è richiesta la privacy.

L'immagine seguente mostra la replica multimediale tra una sessione principale con relatori che condividono audio e video e una sessione di replica con i partecipanti che utilizzano i file multimediali.

Relatori che condividono una sessione principale.
Nota

La quota di servizio Chime SDK Meetings - replica meetings per riunione principale ha un valore predefinito di 4 ed è possibile aumentare tale limite su richiesta. Per ulteriori informazioni sulle quote, consulta le quote di AWS servizio nel Riferimento generale.AWS

Partecipanti interattivi

Ai partecipanti connessi a una sessione di replica può essere concesso l'accesso per partecipare alla sessione principale. Poiché tutti utilizzano una connessione WebRTC, relatori e partecipanti non subiscono ritardi nella transcodifica. Quando i partecipanti passano dalla sessione principale a quella replicata, riutilizzano le loro connessioni WebRTC, quindi il passaggio è estremamente veloce. Ciò consente ai partecipanti di contribuire alla conversazione dal vivo senza perdere alcun contenuto.

L'immagine seguente mostra un partecipante a una sessione di replica che utilizza la propria connessione WebRTC per passare alla sessione principale.

Diagramma che mostra due partecipanti che passano da una riunione di replica alla riunione principale.

Partecipanti globali

Puoi scegliere la AWS regione per ogni sessione multimediale WebRTC. Ciò consente di creare sessioni di replica nelle regioni più vicine ai partecipanti rispetto alla regione della sessione principale. Quando si esegue questa operazione, i file multimediali vengono trasferiti dalla sessione principale alle sessioni di replica attraverso la rete AWS, quindi dalla sessione di replica al partecipante tramite Internet. Quando si presenta una presentazione a un pubblico globale, tenere sessioni di replica vicino ai partecipanti può contribuire a garantire che i media viaggiino in tutto il mondo sulla rete AWS, anziché su Internet, per una migliore esperienza di riunione.

L'immagine seguente mostra una sessione principale e sessioni replicate in diverse regioni.

Diagramma che mostra i partecipanti di 3 regioni che guardano una presentazione.

Ciclo di vita della sessione

Creazione di sessioni

Si utilizzano le CreateMeetingo CreateMeetingWithAttendeesAPI per creare sessioni multimediali WebRTC. Per impostazione predefinita, le API creano una sessione principale a meno che non si crei specificamente una sessione di replica.

È possibile creare una sessione di replica specificando MeetingId la sessione principale PrimaryMeetingId nella chiamata o API. CreateMeeting CreateMeetingWithAttendees

Nota

Se si specifica come data MeetingId di una sessione di replicaPrimaryMeetingId, la chiamata API avrà esito negativo.

Creazione di partecipanti

Per creare le credenziali dei partecipanti necessarie per partecipare a una sessione multimediale WebRTC, puoi utilizzare le, o API. CreateMeetingWithAttendeesBatchCreateAttendeeCreateAttendee

Nota

Quando create sessioni per un numero elevato di partecipanti, utilizzate CreateMeetingWithAttendees o riducete BatchCreateAttendee al minimo il numero di chiamate API richieste.

Eliminazione dei partecipanti

L'DeleteAttendeeAPI viene utilizzata per revocare le credenziali di un partecipante per una sessione multimediale WebRTC. Se il partecipante è connesso alla sessione, verrà disconnesso e non potrà rientrare.

Quando si utilizza l'DeleteMeetingAPI per eliminare una sessione multimediale WebRTC, l'API elimina automaticamente tutti i partecipanti e non è necessario chiamare. DeleteAttendee

Cambio di sessione

Per consentire a un partecipante di passare da una sessione di replica a una sessione principale, è necessario creare le relative credenziali nella riunione principale. Fate riferimento alla sezione Creazione dei partecipanti all'inizio di questo elenco. Utilizza le credenziali con il promoteToPrimaryMeeting metodo nella libreria client Amazon Chime SDK per passare alla sessione principale.

Per riportare i partecipanti a una sessione di replica, utilizza il demoteFromPrimaryMeeting metodo nella libreria client Amazon Chime SDK o utilizza l'API per invalidare DeleteAttendeele credenziali della sessione principale.

Nota

Un relatore che si connette direttamente a una sessione principale non può passare a una sessione di replica.

Per ulteriori informazioni sul passaggio da una sessione all'altra, consulta la documentazione della libreria client:

Eliminazione delle sessioni

L'DeleteMeetingAPI viene utilizzata per eliminare le sessioni multimediali WebRTC.

Se si elimina una sessione principale, l'DeleteMeetingAPI elimina automaticamente tutte le sessioni di replica collegate. Quindi, per eliminare tutte le sessioni, è sufficiente eliminare la principale.

Il servizio elimina automaticamente una sessione principale se nessun partecipante si connette per 5 minuti contigui. Il servizio elimina automaticamente le sessioni di replica solo quando elimina una sessione principale. Ciò significa che è possibile creare sessioni di replica quando si crea una sessione principale e le repliche saranno disponibili per tutta la durata della sessione principale.