Menggunakan Wilayah Rapat

Rapat Amazon Chime SDK memiliki wilayah kontrol dan Wilayah media. Wilayah Kontrol memiliki titik akhir API yang digunakan untuk membuat, memperbarui, dan menghapus rapat. Media Regions menjadi tuan rumah pertemuan yang sebenarnya.

Biasanya, layanan aplikasi Anda menggunakan AWS SDK untuk menandatangani dan memanggil API di Wilayah kontrol. Klien aplikasi Anda menggunakan library klien Amazon Chime SDK untuk, JavaScriptiOS, atau Android untuk terhubung ke rapat di Kawasan media.

Wilayah kontrol dapat membuat rapat di Wilayah media mana pun di AWS partisi yang sama. Namun, Anda hanya dapat memperbarui rapat di wilayah kontrol yang digunakan untuk membuatnya. Untuk menemukan Wilayah media yang paling dekat dengan pelanggan, hubungi https://nearest-media-region.l.chime.aws.

Peristiwa rapat seperti AttendeeJoined panggilan EventBridge, Amazon Simple Queue Service (SQS), atau Amazon Simple Notification Service (SNS) di Wilayah kontrol rapat.

Untuk daftar kontrol rapat Amazon Chime SDK dan Wilayah media yang tersedia, lihat Wilayah yang Tersedia di panduan ini.

Diagram ini menunjukkan aliran data yang khas melalui daerah kontrol dan media.

Memilih wilayah kontrol

Ingat faktor-faktor ini saat memilih Wilayah kontrol untuk rapat Amazon Chime SDK:

• Persyaratan peraturan. Apakah aplikasi Anda harus berada dalam batas geopolitik, atau menggunakan titik akhir dengan modul kriptografi tervalidasi FIPS 140-2?

• Latensi API. Menggunakan wilayah kontrol terdekat dengan AWS Wilayah layanan aplikasi Anda dapat membantu mengurangi latensi jaringan API. Pada gilirannya, itu membantu mengurangi waktu yang dibutuhkan untuk membuat rapat, dan memungkinkan pengguna bergabung dengan rapat lebih cepat.

• Ketersediaan Tinggi. Anda dapat menggunakan beberapa Wilayah kontrol untuk mengimplementasikan arsitektur ketersediaan tinggi. Namun setiap wilayah kontrol beroperasi secara independen. Selain itu, Anda hanya dapat memperbarui rapat di wilayah kontrol yang digunakan untuk membuatnya. Selanjutnya, Anda harus menggunakan wilayah yang sama untuk menggunakan acara rapat dengan EventBridge, Amazon Simple Queue Service (SQS), atau Amazon Simple Notification Service (SNS).

Memilih wilayah media

catatan

Sebaiknya Anda selalu menentukan nilai dalam MediaRegion parameter dalam tindakan CreateMeetingAPI. Untuk informasi lebih lanjut tentang Wilayah, lihatWilayah yang Tersedia.

Saat memilih Wilayah media yang akan digunakan untuk rapat Amazon Chime SDK, pertimbangkan faktor-faktor umum berikut:

Persyaratan peraturan

Jika rapat Amazon Chime SDK Anda tunduk pada peraturan yang mengharuskan rapat tersebut di-host dalam batas geopolitik, pertimbangkan hard coding Wilayah pertemuan berdasarkan logika aplikasi tetap.

Misalnya, aplikasi telemedicine mungkin mengharuskan semua pertemuan diselenggarakan dalam yurisdiksi praktisi medis. Jika aplikasi mendukung klinik yang berlokasi di Eropa dan Amerika Serikat, Anda dapat menggunakan alamat masing-masing klinik untuk memilih Wilayah dalam yurisdiksinya.

Kualitas pertemuan

Saat rapat Amazon Chime SDK di-host di Wilayah media, setiap audio dan video peserta dikirim dan diterima dari Wilayah tersebut. Ketika jarak antara peserta dan Wilayah meningkat, kualitas pertemuan dapat dipengaruhi oleh latensi jaringan. Menentukan Wilayah untuk rapat Amazon Chime SDK Anda dapat membantu meningkatkan kualitas rapat untuk peserta Anda, baik yang berlokasi berdekatan atau didistribusikan secara geografis.

Anda dapat menggunakan salah satu metode berikut untuk memilih Wilayah media untuk rapat Amazon Chime SDK Anda:

Hard code sebuah media Region

Direkomendasikan jika rapat Amazon Chime SDK Anda semuanya dihosting dalam Wilayah tertentu. AWS

Pilih Region media terdekat

Direkomendasikan jika peserta rapat Amazon Chime SDK Anda berada di Wilayah yang sama, tetapi rapat Anda di-host di AWS Wilayah yang berbeda.

Menemukan Daerah Media Terdekat

Untuk menemukan Wilayah media terdekat yang mampu menghosting rapat Amazon Chime SDK, hubungi https://.l.chime.aws. nearest-media-region Titik akhir ini mengembalikan satu Wilayah, seperti{"region": "us-west-2"}. Panggil URL dari aplikasi klien Anda untuk mengidentifikasi Wilayah yang paling dekat dengan pengguna, lalu gunakan hasilnya dalam MediaRegion parameter CreateMeetingAPI untuk membuat rapat di Wilayah tersebut.

Anda biasanya memanggil URL ketika aplikasi klien dimulai, atau koneksi jaringannya berubah. Dengan menentukan Region terdekat, Anda menghindari penambahan latensi panggilan pada saat pembuatan rapat.

Menemukan Wilayah media terdekat AWS GovCloud (AS)

Untuk menemukan Wilayah AWS GovCloud (AS) terdekat yang dapat menyelenggarakan rapat Amazon Chime SDK, hubungi https://-region.l.chime.aws. nearest-us-gov-media Titik akhir ini mengembalikan wilayah terdekat, seperti{"region": "us-gov-west-1"}. Panggil URL dari aplikasi klien Anda untuk mengidentifikasi AWS GovCloud (AS) yang paling dekat dengan pengguna, dan gunakan hasilnya dalam MediaRegion parameter CreateMeetingAPI untuk membuat rapat di Wilayah tersebut.

Anda biasanya memanggil URL ketika aplikasi klien dimulai, atau koneksi jaringannya berubah. Dengan menentukan Region terdekat, Anda menghindari penambahan latensi panggilan pada saat pembuatan rapat.

JavaScript contoh

Contoh berikut menggunakan HTML dan JavaScript untuk mengembalikan Media Region terdekat dan AWS GovCloud (AS) Media Region.

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

Memeriksa status Wilayah

Hubungi https://region.status.chime.aws/ untuk mengambil kesehatan layanan Amazon Chime SDK di setiap Wilayah. Hasilnya menunjukkan Daerah yang direkomendasikan. Jika Wilayah media memiliki status selain yang direkomendasikan, titik akhir Wilayah media terdekat tidak akan mengembalikan Wilayah tersebut.

Contoh berikut menunjukkan hasil yang khas.

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