Selección de las características de reunión mediante Amazon Chime SDK

Cuando llamas al CreateMeetingAPI, puede especificar funciones para ponerlas a disposición de los clientes que se unan a la sesión. Tenga en cuenta que algunas opciones de características conllevan una facturación adicional.

Las siguientes características están disponibles para sesiones:

• Audio.EchoReduction: reducción del eco de machine learning.

• Video.MaxResolution: resolución máxima de video de la cámara web.

• Content.MaxResolution: resolución máxima para compartir contenido.

• Attendees.MaxCount: número máximo de asistentes.

Uso del audio. EchoReduction

Use Audio.EchoReduction para evitar que el sonido del altavoz de un usuario vuelva a circular en una reunión.

La reducción del eco es ideal para situaciones en las que el altavoz del usuario será el principal dispositivo de salida del audio de una reunión. Por ejemplo, cuando varios usuarios asisten a una reunión desde el mismo dispositivo en una sala de conferencias o cuando un asistente remoto individual no lleva auriculares.

La reducción de eco está disponible en las bibliotecas cliente JavaScript y React. Para obtener más información, consulte la documentación en GitHub. Se aplican costos adicionales; consulte la página de precios de Amazon Chime SDK para obtener más información.

Uso del vídeo. MaxResolution

Utilice Video.MaxResolution para especificar la resolución máxima de video de la cámara web para la reunión. La característica proporciona las siguientes opciones:

• None: no se permite el video de cámara

• HD: video de cámara de alta definición (1280x720p)

• FHD: full-high-definition cámara de vídeo (1920x1080)

Si se solicita video FHD (1080p), se crea una sesión de WebRTC de alta definición. Consulte la página de precios de Amazon Chime SDK para obtener más información.

Si un cliente intenta enviar un video de la cámara web por encima de un máximo especificado, el servicio lo rechaza y envía el siguiente mensaje de error:

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

Uso del contenido. MaxResolution

Utilice Content.MaxResolution para especificar la resolución máxima para compartir contenido para la reunión. La característica proporciona las siguientes opciones:

• None: no se permite compartir contenido

• FHD: compartir full-high-definition contenido (1920 x 1080)

• UHD: intercambio de ultra-high-definition contenido (3840x2160)

Si se solicita contenido UHD (4K), se crea una sesión de WebRTC de alta definición.

Si un cliente intenta enviar un contenido compartido más allá de la resolución máxima, esa resolución se reduce verticalmente al máximo especificado. Se escala mediante la aplicación de MediaTrackConstraints a la pista de contenido compartido. Los siguientes ejemplos muestran cómo escalar una pista compartida.

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 siguiente tabla muestra el comportamiento esperado para el intercambio de contenido.

Característica de contenido	Resolución nativa para compartir contenido	Escalado	Resolución de codificación de contenido
FHD	1280x720	No	1280x720
FHD	1920x1080	No	1920x1080
FHD	3840 x 2160	Sí	1920x1080
UHD	1920x1080	No	1920x1080
UHD	3840 x 2160	No	3840 x 2160
UHD	4200x2400	Sí	3780x2160

Uso de asistentes. MaxCount

Use Attendee.MaxCount para especificar el número máximo de asistentes permitidos a una reunión. El límite superior de asistentes. MaxCount depende del tipo de sesión. Para una sesión estándar, puede seleccionar un máximo de 250 asistentes. Para una sesión de alta definición, debe seleccionar un valor de hasta 25 asistentes.

Si solicita contenido de video FHD (1080p) o UHD (4K), la sesión será de alta definición.

Se aplican costos de capacidad de los asistentes para las sesiones de alta definición. Consulte la página de precios de Amazon Chime SDK para obtener más información.

Uso de las características de reunión en una aplicación cliente

Creación de una reunión con características específicas

Para crear una reunión, llame al CreateMeetingAplica la API y especifica las funciones de reunión deseadas. En el siguiente ejemplo, se muestra cómo especificar todas las características.

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

Uso de las características de reunión en un cliente

Después de crear una reunión con las características deseadas, puede transferir joinInfo al crear el objeto MeetingSessionConfiguration. Las características de la reunión se utilizan en la creación de meetingSession para establecer la resolución y la velocidad de bits del video de la cámara web y la resolución y la velocidad de bits para compartir contenido.

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