Auswahl von Meeting-Funktionen

Wenn Sie die CreateMeetingAPI aufrufen, können Sie Funktionen angeben, die den Clients zur Verfügung gestellt werden sollen, die an der Sitzung teilnehmen. Beachten Sie, dass für einige Funktionsoptionen zusätzliche Gebühren anfallen.

Die folgenden Funktionen sind für Sitzungen verfügbar:

• Audio.EchoReduction— Echoreduzierung durch maschinelles Lernen.

• Video.MaxResolution— Maximale Webcam-Videoauflösung.

• Content.MaxResolution— Maximale Auflösung für die gemeinsame Nutzung von Inhalten..

• Attendees.MaxCount— Maximale Anzahl von Teilnehmern.

Audio verwenden. EchoReduction

Wird verwendetAudio.EchoReduction, um zu verhindern, dass der Ton aus dem Lautsprecher eines Benutzers in das Meeting zurückfließt.

Die Echoreduzierung ist ideal für Situationen, in denen der Lautsprecher eines Benutzers das primäre Ausgabegerät für die Audiowiedergabe in Besprechungen sein wird. Dies ist beispielsweise der Fall, wenn mehrere Benutzer von demselben Gerät in einem Konferenzraum aus an einer Besprechung teilnehmen oder wenn ein einzelner entfernter Teilnehmer keine Kopfhörer trägt.

Die Echoreduzierung ist in den Client-Bibliotheken JavaScript und in den React-Clientbibliotheken verfügbar. Weitere Informationen finden Sie in der Dokumentation zu GitHub. Es fallen zusätzliche Kosten an. Weitere Informationen finden Sie auf der Seite mit den Amazon Chime SDK-Preisen.

Video verwenden. MaxResolution

Dient Video.MaxResolution zur Angabe der maximalen Webcam-Videoauflösung für das Meeting. Die Funktion bietet die folgenden Optionen:

• None: kein Kameravideo erlaubt

• HD: hochauflösendes Kameravideo (1280x720p)

• FHD: full-high-definition Kamera-Video (1920x1080)

Wenn FHD-Video (1080p) angefordert wird, wird eine hochauflösende WebRTC-Sitzung erstellt. Weitere Informationen finden Sie auf der Seite mit den Amazon Chime SDK-Preisen.

Wenn ein Kunde versucht, ein Webcam-Video über einem bestimmten Höchstwert zu senden, lehnt der Service das Video ab und sendet den folgenden Fehler:

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

Inhalte verwenden. MaxResolution

Verwenden Sie diese Content.MaxResolution Option, um die maximale Auflösung für die gemeinsame Nutzung von Inhalten für das Meeting festzulegen. Die Funktion bietet die folgenden Optionen:

• None: Das Teilen von Inhalten ist nicht erlaubt

• FHD: full-high-definition Inhalte teilen (1920x1080)

• UHD: ultra-high-definition Inhalte teilen (3840x2160)

Wenn UHD (4K) -Inhalte angefordert werden, wird eine hochauflösende WebRTC-Sitzung erstellt.

Wenn ein Client versucht, eine Inhaltsfreigabe zu senden, die die maximale Auflösung überschreitet, wird diese Auflösung auf das angegebene Maximum herunterskaliert. Sie skalieren, indem Sie MediaTrackConstraints es auf den Track „Content Share“ anwenden. Die folgenden Beispiele zeigen, wie Sie einen Share-Track skalieren können.

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

Die folgende Tabelle zeigt das erwartete Verhalten beim Teilen von Inhalten.

Funktion „Inhalt“	Inhalte teilen sich die native Auflösung	Skalierung	Auflösung der Inhaltscodierung
FHD	1280 x 720	Nein	1280 x 720
FHD	1920x1080	Nein	1920x1080
FHD	3840x2160	Ja	1920x1080
UHD	1920x1080	Nein	1920x1080
UHD	3840x2160	Nein	3840x2160
UHD	4200x2400	Ja	3780 x 2160

Teilnehmer verwenden. MaxCount

Verwenden Sie diese Attendee.MaxCount Option, um die maximale Anzahl von Teilnehmern anzugeben, die an einer Besprechung teilnehmen dürfen. Die Obergrenze für Teilnehmer. MaxCount hängt vom Sitzungstyp ab. Für eine Standardsitzung können Sie maximal 250 Teilnehmer auswählen. Für eine Sitzung mit hoher Auflösung müssen Sie einen Wert von bis zu 25 Teilnehmern auswählen.

Wenn Sie FHD-Video (1080p) oder UHD-Inhalte (4K) anfordern, handelt es sich bei Ihrer Sitzung um eine Sitzung mit hoher Auflösung.

Für Sitzungen mit hoher Auflösung fallen Kapazitätskosten für die Teilnehmer an. Weitere Informationen finden Sie auf der Seite mit den Amazon Chime SDK-Preisen.

Verwenden von Meeting-Funktionen in einer Client-App

Ein Meeting mit bestimmten Funktionen erstellen

Um ein Meeting zu erstellen, rufen Sie die CreateMeetingAPI auf und geben Sie die gewünschten Meeting-Funktionen an. Das folgende Beispiel zeigt, wie Sie alle Funktionen angeben.

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

Verwenden von Besprechungsfunktionen in einem Client

Nachdem Sie ein Meeting mit den gewünschten Funktionen erstellt haben, können Sie das joinInfo bei der Erstellung des MeetingSessionConfiguration Objekts übergeben. Die Meeting-Funktionen werden bei der meetingSession Erstellung verwendet, um die Auflösung und Bitrate des Webcam-Videos sowie die Auflösung und Bitrate für die gemeinsame Nutzung von Inhalten festzulegen.

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