Selezione delle funzionalità delle riunioni

Quando chiami l'CreateMeetingAPI, puoi specificare funzionalità da rendere disponibili ai client che partecipano alla sessione. Tieni presente che alcune opzioni di funzionalità richiedono una fatturazione aggiuntiva.

Le seguenti funzionalità sono disponibili per le sessioni:

• Audio.EchoReduction— Riduzione dell'eco tramite apprendimento automatico.

• Video.MaxResolution— Risoluzione video massima della webcam.

• Content.MaxResolution— Risoluzione massima di condivisione dei contenuti.

• Attendees.MaxCount— Numero massimo di partecipanti.

Utilizzo dell'audio. EchoReduction

Utilizzalo Audio.EchoReduction per evitare che il suono proveniente dall'altoparlante di un utente ricolleghi alla riunione.

La riduzione dell'eco è ideale per le situazioni in cui l'altoparlante di un utente sarà il dispositivo di uscita principale per l'audio delle riunioni. Ad esempio, quando più utenti partecipano a una riunione dallo stesso dispositivo in una sala conferenze o quando un singolo partecipante remoto non indossa le cuffie.

La riduzione dell'eco è disponibile nelle librerie client JavaScript e React. Per ulteriori informazioni, consulta la documentazione su GitHub. Sono previsti costi aggiuntivi, consulta la pagina dei prezzi di Amazon Chime SDK per i dettagli.

Utilizzo di video. MaxResolution

Utilizza Video.MaxResolution per specificare la risoluzione video massima della webcam per la riunione. La funzionalità offre le seguenti opzioni:

• None: non sono consentiti video da videocamera

• HD: videocamera ad alta definizione (1280x720p)

• FHD: full-high-definition videocamera (1920x1080)

Se viene richiesto un video FHD (1080p), viene creata una sessione WebRTC ad alta definizione. Per ulteriori informazioni, consulta la pagina dei prezzi di Amazon Chime SDK.

Se un client tenta di inviare un video dalla webcam superiore a un valore massimo specificato, il servizio rifiuta il video e invia il seguente errore:

Disabled video/content send capability, reason: Video resolution is above limit of current meeting feature selection.

Utilizzo dei contenuti. MaxResolution

Consente Content.MaxResolution di specificare la risoluzione massima di condivisione dei contenuti per la riunione. La funzionalità offre le seguenti opzioni:

• None: non è consentita la condivisione dei contenuti

• FHD: condivisione full-high-definition di contenuti (1920x1080)

• UHD: condivisione di ultra-high-definition contenuti (3840x2160)

Se viene richiesto contenuto UHD (4K), viene creata una sessione WebRTC ad alta definizione.

Se un client tenta di inviare una condivisione di contenuti oltre la risoluzione massima, tale risoluzione viene ridotta al massimo specificato. La scalabilità si applica MediaTrackConstraints alla traccia di condivisione dei contenuti. Gli esempi seguenti mostrano come ridimensionare una traccia condivisa.

const constraint: MediaTrackConstraints = {
    width: { ideal: videoQualitySettings.videoWidth },
    height: { ideal: videoQualitySettings.videoHeight },
    frameRate: { ideal: videoQualitySettings.videoFrameRate },
  };
  this.context.logger.info(
    `Video track (content = ${isContentAttendee}) with constraint: ${JSON.stringify(
      constraint
    )}, trackSettings: ${JSON.stringify(trackSettings)}`
  );
  try {
    await mediaStreamTrack.applyConstraints(constraint);
  } catch (error) {
    this.context.logger.info(
      `Could not apply constraint for video track (content = ${isContentAttendee})`
    );
  }

La tabella seguente mostra il comportamento previsto per la condivisione dei contenuti.

Funzionalità di contenuto	Risoluzione nativa per la condivisione dei contenuti	Dimensionamento	Risoluzione della codifica dei contenuti
FHD	1280 x 720	No	1280x720
FHD	1920 x 1080	No	1920x1080
FHD	3840x2160	Sì	1920 x 1080
UHD	1920 x 1080	No	1920x1080
UHD	3840x2160	No	3840x2160
UHD	4200 x 2400	Sì	3780 x2160

Utilizzo dei partecipanti. MaxCount

Viene utilizzato Attendee.MaxCount per specificare il numero massimo di partecipanti ammessi a una riunione. Il limite massimo di partecipanti. MaxCount dipende dal tipo di sessione. Per una sessione standard, puoi selezionare un massimo di 250 partecipanti. Per una sessione ad alta definizione, è necessario selezionare un valore massimo di 25 partecipanti.

Se richiedi video FHD (1080p) o contenuti UHD (4K), la sessione sarà una sessione ad alta definizione.

Per le sessioni ad alta definizione si applicano i costi relativi alla capacità dei partecipanti. Per ulteriori informazioni, consulta la pagina dei prezzi di Amazon Chime SDK.

Utilizzo delle funzionalità di riunione in un'app client

Creazione di una riunione con funzionalità specifiche

Per creare una riunione, chiama l'CreateMeetingAPI e specifica le funzionalità di riunione desiderate. L'esempio seguente mostra come specificare tutte le funzionalità.

// You must migrate to the Amazon Chime SDK Meetings namespace.
const chime = AWS.ChimeSDKMeetings({ region: "eu-central-1" });

// Create meeting 
const meetingInfo = await chime.createMeeting({
    ...
    MeetingFeatures: {
      Audio: {
        EchoReduction: 'AVAILABLE' 
      },
      Video: {
        MaxResolution: 'FHD' 
      },
      Content: {
        MaxResolution: 'UHD' 
      },
      Attendee: {
        MaxCount: 25 
      },
    } 
  }).promise();

Utilizzo delle funzionalità di riunione in un client

Dopo aver creato una riunione con le funzionalità desiderate, potete passarle al joinInfo momento della creazione dell'MeetingSessionConfigurationoggetto. Le funzionalità di riunione vengono utilizzate al momento della meetingSession creazione per impostare la risoluzione e il bitrate dei video della webcam, mentre la risoluzione e il bitrate per la condivisione dei contenuti.

const configuration = new MeetingSessionConfiguration(this.joinInfo.Meeting, this.joinInfo.Attendee);

this.meetingSession = new DefaultMeetingSession(
    configuration,
    this.meetingLogger,
    this.deviceController,
    new DefaultEventController(configuration, this.meetingLogger, this.eventReporter)
);