Elegir una región de control Selección de una región multimedia Buscar la región multimedia más cercana Búsqueda de la región multimedia AWS GovCloud (EE. UU.) más cercana JavaScript ejemplo Comprobación del estado de región

Uso de las regiones de reunión

Las reuniones de Amazon Chime SDK tienen regiones de Control y regiones multimedia. Las regiones de control tienen un punto de conexión de API que se utiliza para crear, actualizar y eliminar reuniones. Las regiones multimedia albergan las reuniones propiamente dichas.

Por lo general, el servicio de aplicaciones utiliza el SDK de AWS para firmar y llamar a las API en las regiones de control. El cliente de su aplicación utiliza las bibliotecas de clientes del SDK de Amazon Chime para JavaScript iOS o Android para conectarse a la reunión en las regiones multimedia.

Una región de control puede crear una reunión en cualquier región multimedia de la misma AWS partición. Sin embargo, solo puede actualizar una reunión en la región de control utilizada para crearla. Para encontrar la región multimedia más cercana a un cliente, llama a nearest-media-regionhttps://.l.chime.aws.

Eventos de reuniones como una AttendeeJoined llamada EventBridge, Amazon Simple Queue Service (SQS) o Amazon Simple Notification Service (SNS) en la región de control de reuniones.

Para obtener una lista de las regiones multimedia y de control de reuniones de Amazon Chime SDK disponibles, consulte AWSRegiones disponibles para el servicio Amazon Chime SDK en esta guía.

Este diagrama muestra el flujo de datos típico a través de las regiones de control y multimedia.

Diagrama que muestra el flujo de datos a través de las regiones multimedia y de control de Amazon Chime SDK.

Elegir una región de control

Recuerde estos factores al elegir una región de control para una reunión de Amazon Chime SDK:

Requisitos reglamentarios. ¿Su aplicación debe estar dentro de una frontera geopolítica o utilizar un punto de conexión con módulos criptográficos validados por el FIPS 140-2?
Latencia de la API. El uso de la región de control más cercana a la AWS región del servicio de aplicaciones puede ayudar a reducir la latencia de la red de las API. A su vez, esto ayuda a reducir el tiempo necesario para crear reuniones y permite a los usuarios unirse a las reuniones más rápido.
Alta disponibilidad. Puede utilizar varias regiones de control para implementar arquitecturas de alta disponibilidad. Sin embargo, cada región de control funciona de forma independiente. Además, solo puede actualizar las reuniones en la región de control utilizada para crearlas. Además, debe usar esa misma región para consumir eventos de reuniones con EventBridgeAmazon Simple Queue Service (SQS) o Amazon Simple Notification Service (SNS).

Selección de una región multimedia

nota

Le recomendamos que especifique siempre un valor en el MediaRegion parámetro de la acción de la CreateMeetingAPI. Para obtener más información acerca de las regiones, consulte AWSRegiones disponibles para el servicio Amazon Chime SDK.

Al elegir una región multimedia para su reunión de Amazon Chime SDK, tenga en cuenta estos factores comunes:

Requisitos reglamentarios

Si sus reuniones de Amazon Chime SDK están sujetas a normas que exigen que se celebren dentro de una frontera geopolítica, considere la posibilidad de realizar una codificación rígida de la región de la reunión según una lógica de aplicación fija.

Por ejemplo, una aplicación de telemedicina puede requerir que todas las reuniones se celebren dentro de la jurisdicción del médico. Si la aplicación es compatible con clínicas ubicadas tanto en Europa como en los Estados Unidos, puede usar la dirección de cada clínica para seleccionar una región dentro de su jurisdicción.

Calidad de las reuniones

Cuando una reunión de Amazon Chime SDK se celebra en una región multimedia, el audio y el video de cada asistente se envían y reciben desde esa región. A medida que aumenta la distancia entre el asistente y la región, la latencia de la red puede afectar a la calidad de la reunión. Especificar una región para la reunión de Amazon Chime SDK puede ayudar a mejorar la calidad de la reunión para los asistentes, tanto si se encuentran cerca unos de otros como si están distribuidos geográficamente.

Puede utilizar uno de los métodos siguientes para elegir una región multimedia para la reunión de Amazon Chime SDK:

Realizar una codificación rígida de una región multimedia: Se recomienda si todas las reuniones del SDK de Amazon Chime se organizan en una región específica AWS .
Seleccionar la región multimedia más cercana: Se recomienda si los asistentes a la reunión del SDK de Amazon Chime se encuentran en la misma AWS región, pero las reuniones se celebran en regiones diferentes.

Buscar la región multimedia más cercana

Para encontrar la región multimedia más cercana capaz de organizar una reunión del SDK de Amazon Chime, llame a nearest-media-regionhttps://.l.chime.aws. Este punto de conexión devuelve una sola región, como {"region": "us-west-2"}. Llame a la URL desde la aplicación cliente para identificar la región más cercana al usuario y, a continuación, utilice el resultado en el MediaRegion parámetro de la CreateMeetingAPI para crear la reunión en esa región.

Por lo general, se llama a la URL cuando se inicia la aplicación cliente o cuando cambia su conexión de red. Al predeterminar la región más cercana, se evita añadir la latencia de la llamada en el momento de la creación de la reunión.

Búsqueda de la región multimedia AWS GovCloud (EE. UU.) más cercana

Para encontrar la región AWS GovCloud (EE. UU.) más cercana que pueda organizar una reunión del SDK de Amazon Chime, llame a nearest-us-gov-mediahttps://-region.l.chime.aws. Este punto de conexión devuelve la región más cercana, como {"region": "us-gov-west-1"}. Llame a la URL de su aplicación cliente para identificar la AWS GovCloud (EE. UU.) más cercana al usuario y utilice el resultado en el MediaRegion parámetro de la CreateMeetingAPI para crear la reunión en esa región.

JavaScript ejemplo

El siguiente ejemplo utiliza HTML JavaScript para devolver la región multimedia y la región multimedia AWS GovCloud (EE. UU.) más cercanas.


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

Comprobación del estado de región

Llame a https://region.status.chime.aws/ para obtener información sobre el estado del servicio de Amazon Chime SDK en cada región. El resultado muestra las regiones recomendadas. Si una región multimedia tiene un estado diferente al recomendado, el punto de conexión de la región multimedia más cercano no devolverá esa región.

A continuación se muestra un ejemplo típico.


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

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Migración al espacio de nombres de reuniones de Amazon SDK Chime

Crear reuniones