Choix d'une région de contrôle Choix d'une région multimédia Trouver la région média la plus proche Trouver la région médiatique AWS GovCloud (États-Unis) la plus proche JavaScript exemple Vérification de l'état de la région

Utilisation des régions de réunion

Les réunions du SDK Amazon Chime contrôlent les régions et les régions multimédia. Les régions de contrôle disposent d'un point de terminaison d'API utilisé pour créer, mettre à jour et supprimer des réunions. Les régions médiatiques accueillent les réunions proprement dites.

Généralement, votre service d'application utilise le AWS SDK pour signer et appeler des API dans les régions de contrôle. Le client de votre application utilise les bibliothèques clientes du SDK Amazon Chime pour JavaScript iOS ou Android pour se connecter à la réunion dans les régions multimédia.

Une région de contrôle peut créer une réunion dans n'importe quelle région multimédia de la même AWS partition. Toutefois, vous ne pouvez mettre à jour une réunion que dans la région de contrôle utilisée pour la créer. Pour trouver la région multimédia la plus proche d'un client, appelez https ://nearest-media-region.l.chime.aws.

Événements de réunion tels qu'un AttendeeJoined appel EventBridge, Amazon Simple Queue Service (SQS) ou Amazon Simple Notification Service (SNS) dans la région de contrôle des réunions.

Pour obtenir la liste des régions multimédia et de contrôle des réunions disponibles dans le SDK Amazon Chime, reportez-vous AWSRégions disponibles pour le service Amazon Chime SDK à ce guide.

Ce diagramme montre le flux typique de données à travers les régions de contrôle et multimédia.

Schéma illustrant le flux de données via le contrôle du SDK Amazon Chime et les régions multimédia.

Choix d'une région de contrôle

N'oubliez pas ces facteurs lorsque vous choisissez une région de contrôle pour une réunion du SDK Amazon Chime :

Les exigences réglementaires. Votre application doit-elle se trouver à l'intérieur d'une frontière géopolitique ou utiliser un point de terminaison doté de modules cryptographiques validés par la norme FIPS 140-2 ?
Latence de l'API. L'utilisation de la région de contrôle la plus proche de la AWS région de votre service d'application peut contribuer à réduire la latence réseau des API. Cela permet à son tour de réduire le temps nécessaire à la création de réunions et de permettre aux utilisateurs de rejoindre les réunions plus rapidement.
Haute disponibilité. Vous pouvez utiliser plusieurs régions de contrôle pour implémenter des architectures de haute disponibilité. Cependant, chaque région de contrôle fonctionne de manière indépendante. En outre, vous ne pouvez mettre à jour les réunions que dans la région de contrôle utilisée pour les créer. En outre, vous devez utiliser cette même région pour participer à des événements de réunion avec EventBridgeAmazon Simple Queue Service (SQS) ou Amazon Simple Notification Service (SNS).

Choix d'une région multimédia

Note

Nous vous recommandons de toujours spécifier une valeur dans le MediaRegion paramètre de l'action d'CreateMeetingAPI. Pour plus d'informations sur les régions, reportez-vous àAWSRégions disponibles pour le service Amazon Chime SDK.

Lorsque vous choisissez une région multimédia à utiliser pour votre réunion du SDK Amazon Chime, tenez compte des facteurs courants suivants :

Exigences réglementaires

Si vos réunions du SDK Amazon Chime sont soumises à des réglementations exigeant qu'elles soient organisées à l'intérieur d'une frontière géopolitique, pensez à coder en dur la région de réunion en fonction d'une logique d'application fixe.

Par exemple, une application de télémédecine peut exiger que toutes les réunions soient organisées dans la juridiction du médecin. Si l'application prend en charge les cliniques situées à la fois en Europe et aux États-Unis, vous pouvez utiliser l'adresse de chaque clinique pour sélectionner une région relevant de sa juridiction.

Qualité des réunions

Lorsqu'une réunion du SDK Amazon Chime est organisée dans une région multimédia, le son et la vidéo de chaque participant sont envoyés et reçus depuis cette région. À mesure que la distance entre le participant et la région augmente, la qualité de la réunion peut être affectée par la latence du réseau. La spécification d'une région pour votre réunion du SDK Amazon Chime peut contribuer à améliorer la qualité de la réunion pour vos participants, qu'ils soient proches les uns des autres ou répartis géographiquement.

Vous pouvez utiliser l'une des méthodes suivantes pour choisir une région multimédia pour votre réunion Amazon Chime SDK :

Coder en dur une région multimédia: Recommandé si vos réunions du SDK Amazon Chime sont toutes organisées dans une région spécifique. AWS
Choisissez la région multimédia la plus proche: Recommandé si les participants à vos réunions du SDK Amazon Chime se trouvent dans la même AWS région, mais que vos réunions sont organisées dans des régions différentes.

Trouver la région média la plus proche

Pour trouver la région multimédia la plus proche capable d'accueillir une réunion Amazon Chime SDK, appelez https ://.l.chime.aws. nearest-media-region Ce point de terminaison renvoie une seule région, telle que{"region": "us-west-2"}. Appelez l'URL depuis votre application cliente pour identifier la région la plus proche de l'utilisateur, puis utilisez le résultat dans le MediaRegion paramètre de l'CreateMeetingAPI pour créer la réunion dans cette région.

Vous appelez généralement l'URL lorsque l'application cliente démarre ou que sa connexion réseau change. En prédéterminant la région la plus proche, vous évitez d'ajouter la latence de l'appel au moment de la création de la réunion.

Trouver la région médiatique AWS GovCloud (États-Unis) la plus proche

Pour trouver la région AWS GovCloud (États-Unis) la plus proche pouvant accueillir une réunion du SDK Amazon Chime, appelez https ://-region.l.chime.aws. nearest-us-gov-media Ce point de terminaison renvoie la région la plus proche, telle que{"region": "us-gov-west-1"}. Appelez l'URL depuis votre application cliente pour identifier la AWS GovCloud personne (États-Unis) la plus proche de l'utilisateur, et utilisez le résultat dans le MediaRegion paramètre de l'CreateMeetingAPI pour créer la réunion dans cette région.

JavaScript exemple

L'exemple suivant utilise le langage HTML JavaScript pour renvoyer la région multimédia et la région multimédia AWS GovCloud (États-Unis) les plus proches.


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

Vérification de l'état de la région

Appelez https://region.status.chime.aws/ pour connaître l'état du service Amazon Chime SDK dans chaque région. Le résultat indique les régions recommandées. Si le statut d'une région multimédia n'est pas recommandé, le point de terminaison de la région multimédia le plus proche ne renverra pas cette région.

L'exemple suivant montre un résultat typique.


{
  "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"
  }
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Migration vers l'espace de noms des réunions Amazon SDK Chime

Création de réunions