Utilizzo delle aree di riunione - SDK Amazon Chime
Scelta di una regione di controlloScelta di una regione multimedialeIndividuazione della regione multimediale più vicinaIndividuazione della regione multimediale AWS GovCloud (Stati Uniti) più vicinaJavaScript esempioVerifica dello stato della regione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo delle aree di riunione

Le riunioni di Amazon Chime SDK hanno regioni di controllo e regioni multimediali. Le regioni di controllo dispongono di un endpoint API utilizzato per creare, aggiornare ed eliminare riunioni. Le aree multimediali ospitano le riunioni effettive.

In genere, il servizio applicativo utilizza l'AWS SDK per firmare e chiamare le API nelle regioni di controllo. Il client dell'applicazione utilizza le librerie client Amazon Chime SDK per JavaScriptiOS o Android per connettersi alla riunione nelle regioni multimediali.

Una regione di controllo può creare una riunione in qualsiasi regione multimediale nella stessa AWS partizione. Tuttavia, è possibile aggiornare una riunione solo nell'area di controllo utilizzata per crearla. Per trovare la regione multimediale più vicina a un cliente, chiama https://nearest-media-region.l.chime.aws.

Eventi di riunione come AttendeeJoined chiamate EventBridge, Amazon Simple Queue Service (SQS) o Amazon Simple Notification Service (SNS) nella regione di controllo delle riunioni.

Per un elenco delle regioni multimediali e di controllo delle riunioni di Amazon Chime SDK disponibili, consulta questa guidaRegioni disponibili.

Questo diagramma mostra il flusso tipico di dati attraverso le regioni di controllo e media.

Diagramma che mostra il flusso di dati attraverso le regioni di controllo e multimediali dell'SDK Amazon Chime.

Scelta di una regione di controllo

Ricorda questi fattori quando scegli una regione di controllo per una riunione Amazon Chime SDK:

  • Requisiti normativi. La tua applicazione deve trovarsi all'interno di un confine geopolitico o utilizzare un endpoint con moduli crittografici convalidati FIPS 140-2?

  • Latenza delle API. L'utilizzo della regione di controllo più vicina alla AWS regione del servizio applicativo può aiutare a ridurre la latenza di rete delle API. A sua volta, ciò aiuta a ridurre il tempo necessario per creare riunioni e consente agli utenti di partecipare più rapidamente alle riunioni.

  • Alta disponibilità. È possibile utilizzare più regioni di controllo per implementare architetture ad alta disponibilità. Tuttavia, ogni regione di controllo opera in modo indipendente. Inoltre, puoi aggiornare solo le riunioni nella regione di controllo utilizzata per crearle. Inoltre, devi utilizzare la stessa regione per assistere agli eventi di riunione con EventBridgeAmazon Simple Queue Service (SQS) o Amazon Simple Notification Service (SNS).

Scelta di una regione multimediale

Nota

Ti consigliamo di specificare sempre un valore nel MediaRegion parametro nell'azione CreateMeetingAPI. Per ulteriori informazioni sulle regioni, fare riferimento aRegioni disponibili.

Quando scegli una regione multimediale da utilizzare per la tua riunione Amazon Chime SDK, considera questi fattori comuni:

Requisiti normativi

Se le riunioni dell'SDK Amazon Chime sono soggette a normative che richiedono che siano ospitate all'interno di un confine geopolitico, prendi in considerazione la possibilità di codificare la regione della riunione in base a una logica applicativa fissa.

Ad esempio, un'applicazione di telemedicina potrebbe richiedere che tutte le riunioni siano ospitate all'interno della giurisdizione del medico. Se l'applicazione supporta cliniche situate sia in Europa che negli Stati Uniti, è possibile utilizzare l'indirizzo di ciascuna clinica per selezionare una regione all'interno della propria giurisdizione.

Qualità delle riunioni

Quando una riunione Amazon Chime SDK viene ospitata in una regione multimediale, l'audio e il video di ogni partecipante vengono inviati e ricevuti da quella regione. All'aumentare della distanza tra il partecipante e la regione, la qualità della riunione può essere influenzata dalla latenza della rete. Specificare una regione per la riunione Amazon Chime SDK può contribuire a migliorare la qualità della riunione per i partecipanti, indipendentemente dal fatto che si trovino vicini l'uno all'altro o distribuiti geograficamente.

Puoi utilizzare uno dei seguenti metodi per scegliere una regione multimediale per la tua riunione Amazon Chime SDK:

Codifica rigida una regione multimediale

Consigliato se le riunioni dell'SDK Amazon Chime sono tutte ospitate in una regione specifica. AWS

Scegli la regione multimediale più vicina

Consigliato se i partecipanti alla riunione Amazon Chime SDK si trovano nella stessa AWS regione, ma le riunioni sono ospitate in regioni diverse.

Individuazione della regione multimediale più vicina

Per trovare la regione multimediale più vicina in grado di ospitare una riunione Amazon Chime SDK, chiama https://.l.chime.aws. nearest-media-region Questo endpoint restituisce una singola regione, ad esempio. {"region": "us-west-2"} Chiama l'URL dall'applicazione client per identificare la regione più vicina all'utente, quindi utilizza il risultato nel MediaRegion parametro dell'CreateMeetingAPI per creare la riunione in quella regione.

In genere si richiama l'URL all'avvio dell'applicazione client o quando la connessione di rete cambia. Predeterminando la regione più vicina, si evita di aggiungere la latenza della chiamata al momento della creazione della riunione.

Individuazione della regione multimediale AWS GovCloud (Stati Uniti) più vicina

Per trovare la regione AWS GovCloud (Stati Uniti) più vicina che può ospitare una riunione Amazon Chime SDK, chiama https://-region.l.chime.aws. nearest-us-gov-media Questo endpoint restituisce la regione più vicina, ad esempio. {"region": "us-gov-west-1"} Richiama l'URL dall'applicazione client per identificare gli AWS GovCloud (Stati Uniti) più vicini all'utente e utilizza il risultato nel MediaRegion parametro dell'CreateMeetingAPI per creare la riunione in quella regione.

In genere si richiama l'URL all'avvio dell'applicazione client o quando la connessione di rete cambia. Predeterminando la regione più vicina, si evita di aggiungere la latenza della chiamata al momento della creazione della riunione.

JavaScript esempio

L'esempio seguente utilizza HTML e restituisce JavaScript la regione multimediale e la regione multimediale AWS GovCloud (Stati Uniti) più vicine.

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

Verifica dello stato della regione

Chiama https://region.status.chime.aws/ per verificare lo stato del servizio Amazon Chime SDK in ogni regione. Il risultato mostra le regioni consigliate. Se una regione multimediale ha uno stato diverso da quello consigliato, l'endpoint della regione multimediale più vicino non restituirà quella regione.

L'esempio seguente mostra un risultato tipico.

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