Sélection des fonctionnalités de réunion à l'aide du SDK Amazon Chime

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Lorsque vous appelez le CreateMeetingAPI, vous pouvez spécifier les fonctionnalités à mettre à la disposition des clients qui rejoignent la session. Notez que certaines options de fonctionnalités entraînent une facturation supplémentaire.

Les fonctionnalités suivantes sont disponibles pour les sessions :

Utilisation de l'audio. EchoReduction

Audio.EchoReductionÀ utiliser pour empêcher le son émis par le haut-parleur d'un utilisateur de circuler à nouveau dans la réunion.

La réduction d'écho est idéale pour les situations dans lesquelles le haut-parleur de l'utilisateur sera le principal périphérique de sortie audio pour les réunions. Par exemple, lorsque plusieurs utilisateurs participent à une réunion depuis le même appareil dans une salle de conférence, ou lorsqu'un participant distant ne porte pas d'écouteurs.

La réduction d'écho est disponible dans les bibliothèques clientes JavaScript et React. Pour plus d'informations, reportez-vous à la documentation sur GitHub. Des frais supplémentaires s'appliquent. Consultez la page de tarification du SDK Amazon Chime pour plus de détails.

Utilisation de la vidéo. MaxResolution

Permet Video.MaxResolution de spécifier la résolution vidéo maximale de la webcam pour la réunion. Cette fonctionnalité propose les options suivantes :

Si une vidéo FHD (1080p) est demandée, une session WebRTC haute définition est créée. Consultez la page de tarification du SDK Amazon Chime pour plus de détails.

Si un client tente d'envoyer une vidéo par webcam au-dessus d'un maximum spécifié, le service rejette la vidéo et envoie le message d'erreur suivant :

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

Utilisation du contenu. MaxResolution

Content.MaxResolutionÀ utiliser pour spécifier la résolution maximale de partage de contenu pour la réunion. Cette fonctionnalité propose les options suivantes :

Si du contenu UHD (4K) est demandé, une session WebRTC haute définition est créée.

Si un client tente d'envoyer un partage de contenu au-delà de la résolution maximale, cette résolution est réduite au maximum spécifié. Vous pouvez effectuer une mise à l'échelle MediaTrackConstraints en l'appliquant à la piste de partage de contenu. Les exemples suivants montrent comment redimensionner une piste de partage.

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})`
    );
  }

Le tableau suivant indique le comportement attendu pour le partage de contenu.

Utilisation des participants. MaxCount

Attendee.MaxCountÀ utiliser pour spécifier le nombre maximum de participants autorisés à participer à une réunion. La limite supérieure du nombre de participants. MaxCount dépend du type de session. Pour une session standard, vous pouvez sélectionner un maximum de 250 participants. Pour une session haute définition, vous devez sélectionner une valeur maximale de 25 participants.

Si vous demandez une vidéo FHD (1080p) ou du contenu UHD (4K), votre session sera une session haute définition.

Les coûts de capacité des participants s'appliquent aux sessions haute définition. Consultez la page de tarification du SDK Amazon Chime pour plus de détails.

Utilisation des fonctionnalités de réunion dans une application cliente

Création d'une réunion avec des fonctionnalités spécifiques

Pour créer une réunion, appelez le CreateMeetingAPI et spécifiez les fonctionnalités de réunion souhaitées. L'exemple suivant montre comment spécifier toutes les fonctionnalités.

// 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();

Utilisation des fonctionnalités de réunion dans un client

Après avoir créé une réunion avec les fonctionnalités souhaitées, vous pouvez indiquer le joinInfo moment où vous créez l'MeetingSessionConfigurationobjet. Les fonctionnalités de réunion sont utilisées lors de meetingSession la création pour définir la résolution et le débit vidéo de la webcam, et le contenu partage la résolution et le débit.

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)
);