Meeting-Regionen verwenden

Amazon Chime SDK-Meetings haben Kontrollregionen und Medienregionen. Kontrollregionen verfügen über einen API-Endpunkt, der zum Erstellen, Aktualisieren und Löschen von Besprechungen verwendet wird. In den Medienregionen finden die eigentlichen Treffen statt.

In der Regel verwendet Ihr Anwendungsdienst das AWSSDK, um APIs in Kontrollregionen zu signieren und aufzurufen. Ihr Anwendungsclient verwendet die Amazon Chime SDK-Clientbibliotheken für JavaScriptiOS oder Android, um eine Verbindung zum Meeting in Media Regions herzustellen.

Eine Kontrollregion kann ein Meeting in jeder Medienregion in derselben AWS Partition erstellen. Sie können ein Meeting jedoch nur in der Kontrollregion aktualisieren, in der es erstellt wurde. Um die Medienregion zu finden, die einem Kunden am nächsten ist, rufen Sie https://nearest-media-region.l.chime.aws an.

Besprechungsereignisse wie AttendeeJoined Anruf EventBridge, Amazon Simple Queue Service (SQS) oder Amazon Simple Notification Service (SNS) in der Meeting-Kontrollregion.

Eine Liste der verfügbaren Amazon Chime SDK-Regionen zur Steuerung von Besprechungen und Medien finden Sie Verfügbare Regionen in diesem Handbuch.

Dieses Diagramm zeigt den typischen Datenfluss durch die Kontroll- und Medienregionen.

Auswahl einer Kontrollregion

Beachten Sie bei der Auswahl einer Kontrollregion für ein Amazon Chime SDK-Meeting die folgenden Faktoren:

• Regulatorische Anforderungen. Muss sich Ihre Anwendung innerhalb einer geopolitischen Grenze befinden oder muss sie einen Endpunkt mit FIPS 140-2-validierten kryptografischen Modulen verwenden?

• API-Latenz. Die Verwendung der Kontrollregion, die der AWS Region Ihres Anwendungsdienstes am nächsten liegt, kann dazu beitragen, die Netzwerklatenz der APIs zu reduzieren. Dies wiederum trägt dazu bei, den Zeitaufwand für die Erstellung von Besprechungen zu reduzieren und die Benutzer können schneller an Besprechungen teilnehmen.

• Hohe Verfügbarkeit. Sie können mehrere Kontrollregionen verwenden, um Hochverfügbarkeitsarchitekturen zu implementieren. Jede Kontrollregion arbeitet jedoch unabhängig. Außerdem können Sie Besprechungen nur in der Kontrollregion aktualisieren, in der sie erstellt wurden. Außerdem müssen Sie dieselbe Region verwenden, um Besprechungsereignisse mit EventBridgeAmazon Simple Queue Service (SQS) oder Amazon Simple Notification Service (SNS) zu nutzen.

Wählen Sie eine Medienregion

Anmerkung

Wir empfehlen, dass Sie in der CreateMeetingAPI-Aktion immer einen Wert im MediaRegion Parameter angeben. Weitere Informationen zu den Regionen finden Sie unterVerfügbare Regionen.

Berücksichtigen Sie bei der Auswahl einer Medienregion, die Sie für Ihr Amazon Chime SDK-Meeting verwenden möchten, die folgenden gemeinsamen Faktoren:

Regulatorische Anforderungen

Wenn Ihre Amazon Chime SDK-Meetings gesetzlichen Bestimmungen unterliegen, die vorschreiben, dass sie innerhalb einer geopolitischen Grenze abgehalten werden müssen, sollten Sie erwägen, die Meeting-Region auf der Grundlage einer festen Anwendungslogik fest zu codieren.

Für eine Telemedizin-Anwendung könnte es beispielsweise erforderlich sein, dass alle Besprechungen im Zuständigkeitsbereich des Arztes abgehalten werden. Wenn die Anwendung Kliniken unterstützt, die sich sowohl in Europa als auch in den Vereinigten Staaten befinden, können Sie anhand der Adresse jeder Klinik eine Region in ihrem Zuständigkeitsbereich auswählen.

Qualität des Treffens

Wenn ein Amazon Chime SDK-Meeting in einer Medienregion veranstaltet wird, werden die Audio- und Videodaten aller Teilnehmer aus dieser Region gesendet und empfangen. Mit zunehmender Entfernung zwischen dem Teilnehmer und der Region kann die Qualität des Meetings durch die Netzwerklatenz beeinträchtigt werden. Die Angabe einer Region für Ihr Amazon Chime SDK-Meeting kann dazu beitragen, die Meeting-Qualität für Ihre Teilnehmer zu verbessern, unabhängig davon, ob sie sich nahe beieinander befinden oder geografisch verteilt sind.

Sie können eine der folgenden Methoden verwenden, um eine Medienregion für Ihr Amazon Chime SDK-Meeting auszuwählen:

Eine Medienregion fest codieren

Empfohlen, wenn Ihre Amazon Chime SDK-Meetings alle in einer bestimmten AWS Region gehostet werden.

Wählen Sie die nächstgelegene Medienregion

Empfohlen, wenn sich Ihre Amazon Chime SDK-Meeting-Teilnehmer in derselben AWS Region befinden, Ihre Meetings jedoch in verschiedenen Regionen veranstaltet werden.

Finden Sie die nächstgelegene Medienregion

Rufen Sie https://nearest-media-region.l.chime.aws an, um die nächste Medienregion zu finden, in der ein Amazon Chime SDK-Meeting abgehalten werden kann. Dieser Endpunkt gibt eine einzelne Region zurück, z. B. {"region": "us-west-2"} Rufen Sie die URL von Ihrer Client-Anwendung aus auf, um die Region zu identifizieren, die dem Benutzer am nächsten ist, und verwenden Sie dann das Ergebnis im MediaRegion CreateMeetingAPI-Parameter, um das Meeting in dieser Region zu erstellen.

Normalerweise rufen Sie die URL auf, wenn die Client-Anwendung gestartet wird oder wenn sich ihre Netzwerkverbindung ändert. Indem Sie die nächstgelegene Region im Voraus festlegen, vermeiden Sie, dass die Latenz des Anrufs zum Zeitpunkt der Erstellung des Meetings erhöht wird.

Finden Sie die nächstgelegene Medienregion AWS GovCloud (USA)

Rufen Sie nearest-us-gov-mediahttps://-region.l.chime.aws an, um die nächstgelegene Region AWS GovCloud (USA) zu finden, in der ein Amazon Chime SDK-Meeting stattfinden kann. Dieser Endpunkt gibt die nächstgelegene Region zurück, z. B. {"region": "us-gov-west-1"} Rufen Sie die URL in Ihrer Client-Anwendung auf, um die AWS GovCloud (USA), die dem Benutzer am nächsten ist, zu identifizieren, und verwenden Sie das Ergebnis im MediaRegion CreateMeetingAPI-Parameter, um das Meeting in dieser Region zu erstellen.

Normalerweise rufen Sie die URL auf, wenn die Client-Anwendung gestartet wird oder wenn sich ihre Netzwerkverbindung ändert. Indem Sie die nächstgelegene Region im Voraus festlegen, vermeiden Sie, dass die Latenz des Anrufs zum Zeitpunkt der Erstellung des Meetings erhöht wird.

JavaScript Beispiel

Das folgende Beispiel verwendet HTML und JavaScript , um die nächstgelegene Medienregion und AWS GovCloud (US) Medienregion zurückzugeben.

<html>
<head>
  <title>Amazon Chime SDK - Nearest Media Region</title>
  <script>

async function getNearestMediaRegion(partition)  {

    console.log('Nearest media region partition: ' + partition);

    const url = ('aws-us-gov' == partition) ? 'https://nearest-us-gov-media-region.l.chime.aws' : 'https://nearest-media-region.l.chime.aws';
    let result = ('aws-us-gov' == partition) ? 'us-gov-west-1' : 'us-west-2';

    try { //Find the nearest media region
        console.log('Nearest media region URL: ' + url);
        const response = await fetch(url, {method: 'GET'} );
        const body = await response.json();
        result = body.region;
    } catch (error) {
        console.log(error.message);
    } finally {
        console.log('Nearest media region found: ' + result);
        return result;
    }
}

async function findRegions(partition) {
  aws.innerText = await getNearestMediaRegion();
  awsusgov.innerText = await getNearestMediaRegion('aws-us-gov');
}
  </script>
</head>
<body>
  <h3>Nearest media region, by AWS partition</h3>
  <table>
    <tr><th>Partition</th><th>Media Region</th></tr>
    <tr><td>aws</td><td id="aws">Finding...</td></tr>
    <tr><td>aws-us-gov</td><td id="awsusgov">Finding...</td></tr>
  </table>
  <script>
    findRegions();
  </script>
</body>
</html>

Der Status der Region wird überprüft

Rufen Sie https://region.status.chime.aws/ auf, um den Status des Amazon Chime SDK-Service in jeder Region abzurufen. Das Ergebnis zeigt die empfohlenen Regionen. Wenn eine Medienregion einen anderen Status als empfohlen hat, gibt der nächstgelegene Endpunkt der Medienregion diese Region nicht zurück.

Das folgende Beispiel zeigt ein typisches Ergebnis.

{
  "MeetingsControlRegions": {
    "us-east-1": "recommended",
    "us-west-2": "recommended",
    "ap-southeast-1": "recommended",
    "eu-central-1": "recommended"
  },
  "MeetingsMediaRegions": {
    "af-south-1": "recommended",
    "ap-northeast-1": "recommended",
    "ap-northeast-2": "recommended",
    "ap-south-1": "recommended",
    "ap-southeast-1": "recommended",
    "ap-southeast-2": "recommended",
    "ca-central-1": "recommended",
    "eu-central-1": "recommended",
    "eu-north-1": "recommended",
    "eu-south-1": "recommended",
    "eu-west-1": "recommended",
    "eu-west-2": "recommended",
    "eu-west-3": "recommended",
    "sa-east-1": "recommended",
    "us-east-1": "recommended",
    "us-east-2": "recommended",
    "us-west-1": "recommended",
    "us-west-2": "recommended"
  },
  "MediaPipelineControlRegions": {
    "ap-southeast-1": "recommended",
    "eu-central-1": "recommended",
    "us-east-1": "recommended",
    "us-west-2": "recommended"
  },
  "MediaPipelineDataRegions": {
    "af-south-1": "recommended",
    "ap-northeast-1": "recommended",
    "ap-northeast-2": "recommended",
    "ap-south-1": "recommended",
    "ap-southeast-1": "recommended",
    "ap-southeast-2": "recommended",
    "ca-central-1": "recommended",
    "eu-central-1": "recommended",
    "eu-north-1": "recommended",
    "eu-south-1": "recommended",
    "eu-west-1": "recommended",
    "eu-west-2": "recommended",
    "eu-west-3": "recommended",
    "sa-east-1": "recommended",
    "us-east-1": "recommended",
    "us-east-2": "recommended",
    "us-west-1": "recommended",
    "us-west-2": "recommended"
  }
}