Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan rapat Amazon Chime SDK
<a name="mtgs-sdk-mtgs"></a>

Topik di bagian ini menjelaskan cara menggunakan rapat Amazon Chime SDK untuk membuat aplikasi rapat kustom. Kami merekomendasikan mengikuti topik-topik ini dalam urutan yang tercantum. 

**Topics**
+ [Migrasi ke namespace rapat Amazon Chime SDK](meeting-namespace-migration.md)
+ [Menggunakan Wilayah rapat untuk rapat Amazon Chime SDK](chime-sdk-meetings-regions.md)
+ [Membuat rapat menggunakan Amazon Chime SDK](create-mtgs.md)
+ [Memilih fitur rapat menggunakan Amazon Chime SDK](js-meeting-features.md)
+ [Bagaimana rapat Amazon Chime SDK menggunakan media WebRTC](webrtc-media.md)
+ [Mengonfigurasi codec video untuk rapat Amazon Chime SDK](js-meeting-manage-codecs.md)
+ [Mengonfigurasi jaringan Anda untuk rapat Amazon Chime SDK](network-config.md)
+ [Memahami peristiwa siklus hidup rapat Amazon Chime SDK](using-events.md)
+ [Memahami CloudWatch metrik Amazon untuk rapat Amazon Chime SDK](sdk-usage-metrics.md)
+ [Membuat saluran media Amazon Chime SDK](media-pipelines.md)
+ [Menggunakan transkripsi langsung Amazon Chime SDK](meeting-transcription.md)
+ [Menggunakan replikasi media untuk rapat Amazon Chime SDK](media-replication.md)
+ [Memecahkan masalah dan men-debug rapat Amazon Chime SDK](troubleshoot-sdk-meetings.md)

# Migrasi ke namespace rapat Amazon Chime SDK
<a name="meeting-namespace-migration"></a>

Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) adalah tempat khusus bagi mereka yang membuat dan mengelola sumber daya APIs rapat Amazon Chime SDK. Anda menggunakan namespace untuk mengatasi titik akhir API rapat Amazon Chime SDK di Wilayah AWS mana pun yang tersedia. Gunakan namespace ini jika Anda baru mulai menggunakan Amazon Chime SDK. Untuk informasi lebih lanjut tentang Wilayah, lihat [Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md) di panduan ini.

Aplikasi yang ada yang menggunakan namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) harus berencana untuk bermigrasi ke namespace khusus untuk menggunakan fitur dan fitur terbaru. APIs 

**Topics**
+ [Alasan untuk bermigrasi](#migration-reasons)
+ [Sebelum Anda bermigrasi](#before-migrating)
+ [Perbedaan antara ruang nama](#namespace-differences)

## Alasan untuk bermigrasi
<a name="migration-reasons"></a>

Kami mendorong Anda untuk bermigrasi ke namespace [Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) Meetings karena alasan berikut:

**Pilihan Endpoint API**  
[Namespace Amazon Chime SDK Meetings adalah satu-satunya namespace API yang dapat menggunakan titik akhir API di wilayah mana pun yang membuatnya tersedia.](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html) Jika Anda ingin menggunakan titik akhir API selain`us-east-1`, Anda harus menggunakan namespace Amazon Chime SDK Meetings.  
Untuk informasi selengkapnya tentang cara rapat Amazon Chime SDK menggunakan AWS Wilayah, lihat [Wilayah Rapat](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html) di panduan ini.

**Pertemuan yang diperbarui dan baru APIs**  
Kami hanya menambahkan atau memperbarui rapat APIs di namespace Amazon Chime SDK Meetings.

## Sebelum Anda bermigrasi
<a name="before-migrating"></a>

Sebelum Anda bermigrasi, perhatikan perbedaan antara ruang nama. Tabel berikut mencantumkan dan menjelaskannya.


|  | Ruang nama Rapat Amazon Chime SDK | Ruang nama Amazon Chime | 
| --- | --- | --- | 
| AWS Ruang nama SDK | Lonceng SDKMeetings | Lonceng | 
| Daerah | Beberapa | us-east-1 saja | 
| Titik akhir | https://meetings-chime. wilayah .amazonaws.com | https://service.chime.aws.amazon.com | 
| Prinsipal layanan | meetings.chime.amazonaws.com | chime.amazonaws.com | 
| APIs | Hanya APIs untuk pertemuan | APIs untuk pertemuan dan bagian lain dari Amazon Chime | 
| [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html) | ExternalMeetingIddan MediaRegion diperlukan. | ExternalMeetingIddan MediaRegion bersifat opsional. | 
| [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeetingWithAttendees.html) | ExternalMeetingIddan MediaRegion diperlukan.  | ExternalMeetingIddan MediaRegion bersifat opsional. | 
| ListMeetings | Tidak tersedia | Tersedia | 
| ExternalMeetingId | Validasi mencakup pencocokan pola | Tersedia | 
| ExternalUserId | Validasi mencakup pencocokan pola  | Tersedia | 
| Tag Rapat APIs | TagResource, UntagResource, ListTagsForResource | TagMeeting, UntagMeeting, ListMeetingTags | 
| Tag Peserta | Tidak tersedia | Tersedia | 
| Pengurangan gema | Tersedia | Tidak tersedia | 
| Identifikasi bahasa transkripsi langsung | Tersedia | Tidak tersedia | 
| Kemampuan peserta | Tersedia | Tidak tersedia | 
| Replikasi media | Tersedia | Tidak tersedia | 
| AppKeys dan TenantIds | Tersedia | Tidak tersedia | 
| Pipa media | Saluran media mendukung beberapa wilayah di namespace Amazon Chime SDK Meetings. Untuk informasi selengkapnya, lihat [Migrasi ke namespace saluran pipa media Amazon Chime SDK](migrate-pipelines.md). | Tersedia melalui titik akhir us-east-1 | 
| Aplikasi media SIP | JoinChimeMeetingtindakan membutuhkan MeetingId | JoinChimeMeetingtindakan tidak memerlukan MeetingId | 
|  **Integrasi SIP langsung**  | Tidak tersedia | Tersedia | 

## Perbedaan antara ruang nama
<a name="namespace-differences"></a>

Bagian berikut menjelaskan perbedaan antara `Amazon Chime SDK Meetings` ruang nama `Amazon Chime` dan ruang nama.

### AWS Ruang nama SDK
<a name="namespace-diffs"></a>

Namespace Amazon Chime SDK menggunakan nama formal. `Chime` Namespace Amazon Chime SDK Meetings menggunakan nama formal. `ChimeSDKMeetings` Format nama yang tepat bervariasi menurut platform.

Misalnya, jika Anda menggunakan AWS SDK di Node.js untuk membuat rapat, Anda menggunakan baris kode untuk menangani namespace.

```
const chimeMeetings = AWS.Chime();
```

Untuk bermigrasi ke Amazon Chime Meetings SDK, perbarui baris kode ini dengan namespace baru dan wilayah titik akhir.

```
const chimeMeetings = AWS.ChimeSDKMeetings({ region: "eu-central-1" });
```

### Wilayah
<a name="region-diffs"></a>

Namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) hanya dapat menangani titik akhir API di Wilayah us-east-1. Namespace [Amazon Chime SDK Meetings dapat mengatasi titik akhir API rapat](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) Amazon Chime SDK di Wilayah mana pun yang tersedia. Untuk daftar Wilayah pertemuan saat ini, lihat [Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md) di panduan ini.

### Titik akhir
<a name="endpoint-diffs"></a>

[Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) menggunakan titik akhir API yang berbeda dari namespace Amazon Chime.](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html)

Hanya titik akhir yang digunakan untuk membuat rapat yang dapat digunakan untuk memodifikasinya. Ini berarti pertemuan yang dibuat melalui titik akhir di EU-CENTRAL-1 hanya dapat dimodifikasi melalui EU-CENTRAL-1. Ini juga berarti Anda tidak dapat menangani rapat yang dibuat melalui `Chime` namespace dengan namespace di`ChimeSDKMeetings`. `US-EAST-1` Untuk informasi lebih lanjut tentang titik akhir saat ini, lihat [Pemetaan API](migrate-from-chm-namespace.md#name-end-map) di panduan ini.

### Pemimpin layanan
<a name="service-principal-diffs"></a>

Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) menggunakan prinsip layanan baru:. `meetings.chime.amazonaws.com` Jika Anda memiliki SQS, SNS, atau kebijakan akses IAM lainnya yang memberikan akses ke layanan, Anda perlu memperbarui kebijakan tersebut untuk memberikan akses ke prinsipal layanan baru.

### APIs
<a name="api-diffs"></a>

Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) hanya berisi APIs untuk membuat dan mengelola rapat. Namespace [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) termasuk APIs untuk rapat dan bagian lain dari layanan Amazon Chime.

### CreateMeeting bidang yang diperlukan
<a name="create-meeting-diffs"></a>

Di namespace Amazon Chime SDK Meetings, [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html) APIs membutuhkan `ExternalMeetingId` dan `MediaRegion` bidang yang akan ditentukan.

### Nilai ID eksternal
<a name="external-id-diffs"></a>

Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) memberlakukan validasi penambahan pada nilai yang dapat digunakan untuk dan. `ExternalMeetingId` `ExternalUserId`

### Pengurangan gema
<a name="echo-reduction-diffs"></a>

Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) menawarkan pengurangan gema berbasis pembelajaran mesin untuk membantu menghilangkan kebisingan dan suara dari pengeras suara lokal agar tidak beredar kembali ke rapat. Lihat panduan GitHub untuk informasi lebih lanjut.

### Kemampuan peserta
<a name="capabilities-diffs"></a>

Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) menyediakan kontrol terperinci atas kemampuan peserta dalam rapat untuk mengirim dan menerima audio, video, dan konten.

### Replikasi media
<a name="media-replication-diffs"></a>

Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) menawarkan replikasi media untuk menautkan rapat utama ke rapat replika guna mempertemukan hingga 10.000 orang untuk sesi waktu nyata. Peserta yang terhubung ke sesi replika menerima media dari presenter yang terhubung ke sesi utama, tetapi mereka dapat dipromosikan ke pertemuan utama. Untuk informasi lebih lanjut, lihat [Menggunakan replikasi media untuk rapat Amazon Chime SDK](media-replication.md) di panduan ini.

### AppKeys dan TenantIds
<a name="app-keys-diffs"></a>

Namespace [Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) menyediakan cara untuk membatasi akses dari jaringan ke rapat Amazon Chime SDK tertentu. Untuk informasi lebih lanjut, lihat [Menggunakan AppKeys dan Penyewa IDs untuk Amazon Chime SDK](app-keys-tenant-ids.md) di panduan ini.

### Pipa media
<a name="media-pipe-diffs"></a>

[Saluran media Amazon Chime SDK berfungsi dengan rapat yang dibuat oleh titik akhir rapat apa pun, baik dengan Rapat Amazon Chime [SDK atau namespace Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html).](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) Lihat [Wilayah yang Tersedia](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html) untuk daftar terbaru wilayah pipa media.

### Aplikasi media SIP
<a name="sip-app-diffs"></a>

[Aplikasi media SIP Amazon Chime SDK bekerja dengan rapat yang dibuat oleh titik akhir rapat apa pun, baik dengan Rapat Amazon Chime SDK [atau namespace Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html).](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) Saat menggunakan aplikasi media SIP dengan rapat yang dibuat melalui namespace Amazon Chime SDK Meetings, tindakan memerlukan parameter. [JoinChimeMeeting](join-chime-meeting.md) `MeetingId`

### Tambahan APIs
<a name="additional-api-diffs"></a>

Namespace Meetings memiliki daftar yang berkembang yang APIs tidak dimiliki namespace Chime. Jika Anda memulai dengan Amazon Chime SDK, gunakan namespace Rapat untuk mengakses fitur terbaru. 

# Menggunakan Wilayah rapat untuk rapat Amazon Chime SDK
<a name="chime-sdk-meetings-regions"></a>

*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](https://aws.amazon.com/tools/) untuk [menandatangani dan memanggil](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) APIs Wilayah kontrol. Klien aplikasi Anda menggunakan library klien Amazon Chime SDK untuk, [JavaScript](js-sdk-intro.md)[iOS](sdk-for-ios.md), atau [Android](sdk-for-android.md) 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](https://nearest-media-region.l.chime.aws).

[Peristiwa](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#sdk-events) rapat seperti `AttendeeJoined` panggilan [EventBridge, Amazon Simple Queue Service (SQS), atau Amazon Simple Notification Service (SNS)](https://docs.aws.amazon.com/chime-sdk/latest/dg/mtgs-sdk-notifications.html) di Wilayah kontrol rapat.

 Untuk daftar kontrol rapat Amazon Chime SDK dan Wilayah media yang tersedia, lihat [Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md) di panduan ini.

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

![\[Diagram yang menunjukkan aliran data melalui kontrol Amazon Chime SDK dan Wilayah media.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/control-media-regions.png)


## Memilih wilayah kontrol
<a name="choose-meeting-region"></a>

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 kontrol Wilayah terdekat dengan AWS Wilayah layanan aplikasi Anda dapat membantu mengurangi APIs 'latensi jaringan. 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)](https://docs.aws.amazon.com/chime-sdk/latest/dg/mtgs-sdk-notifications.html).

## Memilih wilayah media
<a name="choose-media-region"></a>

**catatan**  
Sebaiknya Anda selalu menentukan nilai dalam `MediaRegion` parameter dalam tindakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html)API. Untuk informasi lebih lanjut tentang Wilayah, lihat[Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md).

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
<a name="choose-nearest-media-region"></a>

Untuk menemukan Wilayah media terdekat yang mampu menghosting rapat Amazon Chime SDK, hubungi [https://](https://nearest-media-region.l.chime.aws).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 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html)API 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)
<a name="choose-gov-cloud-region"></a>

Untuk menemukan Wilayah AWS GovCloud (AS) terdekat yang dapat menyelenggarakan rapat Amazon Chime SDK, hubungi [https://](https://nearest-us-gov-media-region.l.chime.aws)-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 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html)API 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
<a name="region-javascript"></a>

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
<a name="region-status"></a>

Hubungi [https://region.status.chime.aws/](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",
    "eu-central-1": "recommended",
    "eu-west-2": "recommended",
    "ap-south-1": "recommended",
    "ap-southeast-1": "recommended",
    "ap-southeast-2": "recommended",
    "ap-northeast-1": "recommended",
    "ap-northeast-2": "recommended",
    "il-central-1": "recommended",
    "ca-central-1": "recommended",
    "af-south-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-west-2": "recommended",
    "us-east-2": "recommended",
    "us-west-1": "recommended",
    "il-central-1": "recommended"
  },
  "MediaPipelineControlRegions": {
    "us-east-1": "recommended",
    "us-west-2": "recommended",
    "eu-central-1": "recommended",
    "eu-west-2": "recommended",
    "ap-south-1": "recommended",
    "ap-southeast-1": "recommended",
    "ap-southeast-2": "recommended",
    "ap-northeast-1": "recommended",
    "ap-northeast-2": "recommended",
    "ca-central-1": "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-west-2": "recommended",
    "us-east-2": "recommended",
    "us-west-1": "recommended"
  }
}
```

# Membuat rapat menggunakan Amazon Chime SDK
<a name="create-mtgs"></a>

Prosedur berikut menunjukkan cara membuat rapat dengan audio dan video untuk aplikasi server dan klien Anda. Sebelum memulai, Anda harus mengintegrasikan aplikasi klien Anda dengan library klien Amazon Chime SDK. Untuk informasi lebih lanjut, lihat[Pelajari tentang library klien Amazon Chime SDK](mtgs-sdk-client-lib.md).

**Untuk membuat pertemuan dengan audio dan video**

1. Lengkapi langkah-langkah berikut dari aplikasi server Anda:

   1. Gunakan tindakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html)API di *Referensi API Amazon Chime SDK* untuk membuat rapat. Tentukan AWS Wilayah menggunakan `MediaRegion` parameter. Untuk informasi selengkapnya tentang memilih Wilayah Rapat, lihat[Daerah Pertemuan](sdk-available-regions.md#sdk-meeting-regions).

   1. Tambahkan peserta ke rapat menggunakan tindakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html)API atau tindakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html)API. Transfer rapat dan peserta dengan aman dari aplikasi server Anda ke klien yang diotorisasi sebagai peserta masing-masing. Untuk informasi selengkapnya tentang rapat dan peserta, lihat [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_Meeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_Meeting.html)dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_Attendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_Attendee.html)di Referensi API *Amazon Chime SDK*.

1. Lengkapi langkah-langkah berikut dari aplikasi klien Anda:

   1. Gunakan library klien Amazon Chime SDK untuk membuat objek. `MeetingSessionConfiguration` Gunakan informasi rapat dan peserta dari langkah-langkah sebelumnya.

   1. Menerapkan `AudioVideoObserver` antarmuka.

   1. Buat `MeetingSession` menggunakan`MeetingSessionConfiguration`.

   1. Gunakan `AudioVideoFacade` dari `MeetingSession` untuk mengontrol media real-time.

      1. Daftarkan instance `AudioVideoObserver` antarmuka. Ini memungkinkan Anda menerima acara saat status rapat berubah.

      1. Pilih perangkat awal untuk input audio, output audio, dan input video.

      1. Mulai sesi audiovisual.

      1. Mulai pengambilan video lokal saat pengguna ingin berbagi video.

      1. Untuk menampilkan ubin video, kelola acara ubin video, dan ikat ubin ke permukaan video dalam aplikasi klien.

      1. Kelola interaksi pengguna lain seperti mematikan dan tidak mematikan, atau memulai dan menghentikan pengambilan video lokal.

      1. Untuk meninggalkan rapat, hentikan sesi audiovisual.

   1. (Opsional) Gunakan `AudioVideoFacade` dari `MeetingSession` untuk berbagi konten media, seperti tangkapan layar, dengan klien lain.

      1. Mulai sesi berbagi layar. Konten bergabung dengan pertemuan sebagai peserta tambahan.

      1. Untuk melihat konten bersama, kelola peristiwa ubin video dan ikat ubin ke permukaan dalam aplikasi klien.

      1. Kelola interaksi lain, seperti menjeda, memulai ulang, atau menghentikan pembagian konten.

Rapat berakhir saat Anda menjalankan tindakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html)API. Juga, rapat berakhir secara otomatis ketika:
+ Waktu pertemuan melebihi 24 jam.
+ Pertemuan adalah pertemuan [replika dan pertemuan](media-replication.md) utama berakhir.
+ Dalam pertemuan non-replika, tidak ada peserta yang terhubung selama lima menit terus menerus.

# Memilih fitur rapat menggunakan Amazon Chime SDK
<a name="js-meeting-features"></a>

Saat memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html)API, Anda dapat menentukan fitur yang akan tersedia bagi klien yang bergabung dengan sesi. Perhatikan bahwa beberapa opsi fitur dikenakan tagihan tambahan.

Fitur-fitur berikut tersedia untuk sesi:
+ `Audio.EchoReduction`— Pengurangan gema pembelajaran mesin.
+ `Video.MaxResolution`— Resolusi video webcam maksimum.
+ `Content.MaxResolution`— Resolusi berbagi konten maksimum..
+ `Attendees.MaxCount`— Jumlah maksimum peserta.

**Topics**
+ [Menggunakan Audio. EchoReduction](#audio-echo-reduction)
+ [Menggunakan Video. MaxResolution](#video-max-resolution)
+ [Menggunakan Konten. MaxResolution](#js-content-resolution)
+ [Menggunakan Peserta. MaxCount](#js-max-attendees)
+ [Menggunakan fitur rapat di aplikasi klien](#meeting-features-client-app)

## Menggunakan Audio. EchoReduction
<a name="audio-echo-reduction"></a>

Gunakan `Audio.EchoReduction` untuk membantu menjaga suara dari pengeras suara pengguna agar tidak beredar kembali ke rapat.

Pengurangan gema sangat ideal untuk situasi di mana loudspeaker pengguna akan menjadi perangkat keluaran utama untuk memenuhi audio. Misalnya, ketika beberapa pengguna menghadiri rapat dari perangkat yang sama di ruang konferensi, atau ketika peserta jarak jauh individu tidak mengenakan headphone.

Pengurangan gema tersedia di pustaka klien JavaScript dan React. Untuk informasi lebih lanjut, lihat [dokumentasi di GitHub](https://aws.github.io/amazon-chime-sdk-js/modules/amazonvoice_focus.html#what-is-echo-reduction). Biaya tambahan berlaku, lihat [halaman Harga Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk/pricing/) untuk detailnya.

## Menggunakan Video. MaxResolution
<a name="video-max-resolution"></a>

Gunakan `Video.MaxResolution` untuk menentukan resolusi video webcam maksimum untuk rapat. Fitur ini menyediakan opsi berikut:
+ `None`: tidak ada video kamera yang diizinkan
+ `HD`: video kamera definisi tinggi (1280x720p)
+ `FHD`: full-high-definition kamera video (1920x1080)

Jika FHD (1080p) Video diminta, sesi WebRTC definisi tinggi dibuat. Lihat [halaman Harga Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk/pricing/) untuk detailnya.

Jika klien berusaha mengirim video webcam di atas maksimum yang ditentukan, layanan menolak video dan mengirimkan kesalahan berikut:

`Disabled video/content send capability, reason: Video resolution is above limit of current meeting feature selection.`

## Menggunakan Konten. MaxResolution
<a name="js-content-resolution"></a>

Gunakan `Content.MaxResolution` untuk menentukan resolusi berbagi konten maksimum untuk rapat. Fitur ini menyediakan opsi berikut: 
+ `None`: tidak ada pembagian konten yang diizinkan
+ `FHD`: berbagi full-high-definition konten (1920x1080)
+ `UHD`: berbagi ultra-high-definition konten (3840x2160)

Jika konten UHD (4K) diminta, sesi WebRTC definisi tinggi dibuat.

Jika klien ingin mengirim pembagian konten di luar resolusi maksimum, resolusi tersebut diperkecil hingga maksimum yang ditentukan. Anda menskalakan dengan menerapkan `MediaTrackConstraints` ke trek berbagi konten. Contoh berikut menunjukkan cara menskalakan trek berbagi.

```
const constraint: MediaTrackConstraints = {
    width: { ideal: videoQualitySettings.videoWidth },
    height: { ideal: videoQualitySettings.videoHeight },
    frameRate: { ideal: videoQualitySettings.videoFrameRate },
  };
  this.context.logger.info(
    `Video track (content = ${isContentAttendee}) with constraint: ${JSON.stringify(
      constraint
    )}, trackSettings: ${JSON.stringify(trackSettings)}`
  );
  try {
    await mediaStreamTrack.applyConstraints(constraint);
  } catch (error) {
    this.context.logger.info(
      `Could not apply constraint for video track (content = ${isContentAttendee})`
    );
  }
```

Tabel berikut menunjukkan perilaku yang diharapkan untuk berbagi konten.


| Fitur konten | Berbagi konten resolusi asli | Penskalaan | Resolusi pengkodean konten | 
| --- | --- | --- | --- | 
|  FHD | 1280x720  | Tidak | 1280x720 | 
| FHD | 1920x1080 | Tidak | 1920x1080 | 
| FHD | 3840x2160 | Ya | 1920x1080 | 
| UHD | 1920x1080 | Tidak | 1920x1080 | 
| UHD | 3840x2160 | Tidak | 3840x2160 | 
| UHD | 4200x2400 | Ya | 3780x2160 | 

## Menggunakan Peserta. MaxCount
<a name="js-max-attendees"></a>

Gunakan `Attendee.MaxCount` untuk menentukan jumlah maksimum peserta yang diizinkan masuk ke rapat. Batas atas Peserta. MaxCount tergantung pada jenis sesi. Untuk sesi standar, Anda dapat memilih maksimal 250 peserta. Untuk sesi definisi tinggi, Anda *harus* memilih nilai hingga 25 peserta. 

Jika Anda meminta konten video FHD (1080p) atau UHD (4K), sesi Anda akan menjadi sesi definisi tinggi.

Biaya kapasitas peserta berlaku untuk sesi definisi tinggi. Lihat [halaman Harga Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk/pricing/) untuk detailnya.

## Menggunakan fitur rapat di aplikasi klien
<a name="meeting-features-client-app"></a>



### Membuat pertemuan dengan fitur tertentu
<a name="js-create-meetings-sdk-namespace"></a>

Untuk membuat rapat, panggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html)API dan tentukan fitur rapat yang diinginkan. Contoh berikut menunjukkan cara menentukan semua fitur.

```
// You must migrate to the Amazon Chime SDK Meetings namespace.
const chime = AWS.ChimeSDKMeetings({ region: "eu-central-1" });

// Create meeting 
const meetingInfo = await chime.createMeeting({
    ...
    MeetingFeatures: {
      Audio: {
        EchoReduction: 'AVAILABLE' 
      },
      Video: {
        MaxResolution: 'FHD' 
      },
      Content: {
        MaxResolution: 'UHD' 
      },
      Attendee: {
        MaxCount: 25 
      },
    } 
  }).promise();
```

### Menggunakan fitur rapat di klien
<a name="js-client-level"></a>

Setelah Anda membuat rapat dengan fitur yang diinginkan, Anda dapat meneruskan `joinInfo` ketika Anda membuat `MeetingSessionConfiguration` objek. Fitur rapat digunakan saat `meetingSession` pembuatan untuk mengatur resolusi video webcam dan bitrate, serta resolusi berbagi konten dan bitrate.

```
const configuration = new MeetingSessionConfiguration(this.joinInfo.Meeting, this.joinInfo.Attendee);

this.meetingSession = new DefaultMeetingSession(
    configuration,
    this.meetingLogger,
    this.deviceController,
    new DefaultEventController(configuration, this.meetingLogger, this.eventReporter)
);
```

# Bagaimana rapat Amazon Chime SDK menggunakan media WebRTC
<a name="webrtc-media"></a>

Amazon Chime SDK mendukung dua jenis sesi WebRTC, standar dan definisi tinggi. Topik berikut menjelaskan media yang tersedia di setiap jenis sesi saat menggunakan library klien Amazon Chime SDK untuk, JavaScript React, iOS, dan Android.

**Topics**
+ [Audio](#webrtc-audio)
+ [Video](#video)
+ [Berbagi konten](#content-share)
+ [Pesan data](#data-messages)

## Audio
<a name="webrtc-audio"></a>

Setiap klien Amazon Chime mengirimkan satu aliran audio ke sesi dan menerima satu aliran audio dari sesi tersebut. Biasanya, mikrofon pada perangkat lokal menghasilkan audio. Audio yang diterima adalah campuran audio yang dikirim dari klien sesi lainnya.

Kedua jenis sesi mendukung laju sampel hingga 48kHz dan hingga 2 saluran (stereo) yang dikodekan dengan bitrate hingga 128kbps menggunakan codec Opus. Namun, aliran audio yang dikirim dan diterima bervariasi menurut jenis pustaka klien:
+ Library klien Amazon Chime SDK untuk JavaScript dan React mendukung pengiriman dan penerimaan audio mono dan stereo pada laju sampel tertinggi yang didukung oleh perangkat dan browser, hingga maksimum 48kHz.
+ Pustaka klien Amazon Chime SDK untuk iOS dan Android mendukung pengiriman audio mono hingga 48kHz, dan menerima audio stereo pada 48kHz.

## Video
<a name="video"></a>

Setiap klien Amazon Chime dapat mengirim satu aliran video ke sesi dan menerima hingga 25 aliran video dari sesi tersebut. Video yang dikirim biasanya bersumber dari webcam perangkat lokal. Setiap klien dapat memilih hingga 25 aliran video untuk diterima, dan mengubah pilihan kapan saja selama sesi berlangsung. 

Sesi standar mendukung resolusi video hingga 1280x720 pada 30 frame per detik yang dikodekan dengan bitrate hingga 1500kbps menggunakan H.264,,, dan. VP8 VP9 AV1

Sesi definisi tinggi mendukung resolusi video hingga 1920x1080 pada 30 frame per detik yang dikodekan dengan bitrate hingga 2500kbps menggunakan H.264,,, dan. VP8 VP9 AV1

Library klien Amazon Chime SDK untuk JavaScript dan React mendukung pengiriman video dalam simulcast pada 15 frame per detik, atau dengan scalable video coding (SVC). SVC mengkodekan aliran video tunggal dengan tiga lapisan spasial dan tiga lapisan temporal pada 100%, 50%, dan 25% dari nilai target Anda. Layanan secara otomatis memilih lapisan untuk dikirim ke setiap penampil berdasarkan bandwidth pemirsa yang tersedia.

Library klien Amazon Chime SDK untuk iOS dan Android mendukung pengiriman hingga 15 frame per detik. Namun, frame rate dan resolusi aktual dikelola secara otomatis oleh Amazon Chime SDK.

Pengkodean dan decoding video menggunakan akselerasi perangkat keras jika tersedia untuk meningkatkan kinerja.

 Jika klien mengirim video dengan bitrate lebih besar dari bitrate maksimum yang diizinkan, sesi pertama mulai mengirim pesan Bitrate Maksimum Penerima Estimasi Klien melalui Protokol Kontrol Waktu Nyata. Jika klien terus mengirim video dengan bitrate lebih besar dari bitrate maksimum yang diizinkan, sesi akan membuang paket aliran video yang masuk.

## Berbagi konten
<a name="content-share"></a>

Hingga dua klien dapat berbagi konten ke sesi. Berbagi konten dapat mencakup trek video, trek audio, atau keduanya. Contoh umum dari berbagi konten adalah berbagi layar, yang menggunakan tangkapan layar sebagai sumber konten. Contoh lain adalah berbagi konten yang direkam sebelumnya dengan trek video dan audio.

Audio konten dicampur ke dalam aliran audio yang dikirim oleh sesi. Audio konten mendukung kecepatan sampel hingga 48kHz dan hingga 2 saluran (stereo) yang dikodekan dengan bitrate hingga 128kbps menggunakan codec Opus.

Konten video dikirim ke sesi dan diteruskan ke klien dalam aliran video terpisah. Sesi standar mendukung video konten hingga 1920x1080 pada 30 frame per detik. Sesi definisi tinggi mendukung video konten hingga 3840 x 2160 pada 30 frame per detik.

Tangkapan layar untuk berbagi konten menggunakan resolusi layar atau jendela yang ditangkap, hingga resolusi konten maksimum untuk jenis sesi, dan hingga 30 frame per detik. Namun, kemampuan perangkat dan browser dapat membatasi nilai-nilai tersebut.

Library klien Amazon Chime SDK untuk JavaScript dan React mendukung berbagi konten dari tangkapan layar dan sumber lainnya.

Library klien Amazon Chime SDK untuk iOS dan Android hanya mendukung berbagi konten dari tangkapan layar.

## Pesan data
<a name="data-messages"></a>

Pesan data menyediakan cara bagi klien untuk menyiarkan informasi ke klien lain dalam sesi tersebut. Misalnya, aplikasi dapat menggunakan pesan data untuk berbagi reaksi emoji selama sesi.

Setiap pesan data meliputi:
+ Sebuah topik, string hingga 64 karakter.
+ Hingga 2 KB data, termasuk topik.

Klien mengirim pesan data ke sesi, dan sesi mengirimkan pesan data ke semua klien yang terhubung.

Sesi ini secara opsional dapat menyimpan pesan data hingga lima menit. Jika klien bergabung atau menyambung kembali ke sesi, sesi akan secara otomatis mengirim klien pesan data cache yang belum dikirim sebelumnya. Cache sesi menyimpan maksimal 1024 pesan data.

Sesi mendukung hingga 100 pesan data terkirim per detik. Saat menggunakan [transkripsi langsung](https://docs.aws.amazon.com/chime-sdk/latest/dg/meeting-transcription.html), setiap klien menerima pesan [transkripsi melalui pesan](https://docs.aws.amazon.com/chime-sdk/latest/dg/process-msgs.html) data, yang dihitung terhadap total pesan yang dikirim per detik.

# Mengonfigurasi codec video untuk rapat Amazon Chime SDK
<a name="js-meeting-manage-codecs"></a>

Perangkat klien menggunakan codec video untuk mengompres video mentah sebelum dikirim ke layanan, dan untuk mendekompresi video yang diterima sebelum dirender.

Saat menggunakan library klien Amazon Chime SDK untuk JavaScript, Anda dapat menentukan preferensi codec untuk mengirim video. 

Library klien Amazon Chime SDK untuk iOS dan Android secara otomatis memilih codec untuk Anda, berdasarkan kemampuan perangkat.

## Mengatur preferensi codec video
<a name="codec-list"></a>

Di pustaka klien Amazon Chime SDK untuk JavaScript, Anda dapat menentukan preferensi codec video independen untuk webcam dan video konten. 

Gunakan [ AudioVideoControllerFacade. setVideoCodecSendPreferences ](https://aws.github.io/amazon-chime-sdk-js/interfaces/audiovideocontrollerfacade.html#setvideocodecsendpreferences)berfungsi untuk mengatur preferensi codec Anda untuk mengirim video webcam. Tautan membawa Anda ke GitHub.

Preferensi Anda diteruskan sebagai array yang diurutkan, dengan codec yang paling Anda sukai terlebih dahulu dan codec yang paling tidak Anda sukai terakhir. 

Saat memberikan beberapa preferensi codec, layanan secara otomatis memilih codec yang paling disukai yang dapat didekode oleh semua peserta sesi.

Contoh berikut menunjukkan cara mengatur preferensi codec video VP9 dengan opsi fallback: VP8

```
// A meeting session has already been created and stored in `this.meetingSession`
this.meetingSession.audioVideo.setVideoCodecSendPreferences(
	[
		VideoCodecCapability.vp9(), 
		VideoCodecCapability.vp8()
	]
);
```

Skenario berikut berlaku untuk preferensi:
+ **Optimal** — Klien mengkodekan video menggunakan VP9 codec.
+ **Local Fallback** — Jika klien tidak mendukung VP9 pengkodean, itu kembali ke pengkodean. VP8 Jika klien tidak mendukung VP8 pengkodean, itu akan kembali ke codec apa pun yang didukung oleh browser dan layanan.
+ **Remote Fallback** — Jika klien lain dalam sesi tidak memiliki VP9 decoder, klien ini kembali ke pengkodean. VP8 
+ **Kegagalan Lokal** — Jika klien tidak mendukung VP9 atau VP8 menyandikan, itu tidak akan mengirim video.

Untuk mengatur preferensi untuk berbagi konten, gunakan [ ContentShareControllerFacade. setContentShareVideoCodecPreferences ](https://aws.github.io/amazon-chime-sdk-js/interfaces/contentsharecontrollerfacade.html#setcontentsharevideocodecpreferences)berfungsi untuk mengatur preferensi codec Anda untuk mengirim video konten. Tautan ini membawa Anda ke GitHub.

 Contoh berikut menetapkan preferensi codec video konten VP9 dengan opsi fallback. VP8

```
// A meeting session has already been created and stored in `this.meetingSession`
    this.meetingSession.audioVideo.setContentShareVideoCodecPreferences(
	[
	VideoCodecCapability.vp9(), 
	VideoCodecCapability.vp8()
	]
);
```

# Mengonfigurasi jaringan Anda untuk rapat Amazon Chime SDK
<a name="network-config"></a>

Saat Anda mengintegrasikan Amazon Chime SDK ke dalam aplikasi klien, SDK akan terhubung ke layanan back-endnya untuk mengirim dan menerima pesan audio, video, berbagi konten, dan data. Jika jaringan pengguna Anda memblokir lalu lintas ke layanan Amazon Chime SDK, kemampuan mereka untuk menggunakan layanan akan terganggu. Administrator jaringan dapat menggunakan informasi ini untuk mengkonfigurasi ulang jaringan mereka untuk memungkinkan akses ke layanan Amazon Chime SDK.

**catatan**  
Ketika Anda mengkonfigurasi jaringan Anda, Anda harus mengaktifkan Mekanisme Ekstensi untuk DNS (EDNS0) secara default. Hal ini memungkinkan aplikasi Anda untuk mencapai layanan Amazon Chime SDK dengan memastikan bahwa informasi host adalah ukuran yang benar untuk paket UDP.

**Topics**
+ [Mengkonfigurasi untuk media dan pensinyalan](#media-signaling)
+ [Mengkonfigurasi untuk Amazon Voice Focus](#voice-focus-config)
+ [Mengkonfigurasi untuk pengurangan gema](#echo-reduction)
+ [Mengkonfigurasi untuk penggantian latar belakang dan blur](#config-blur)
+ [Mengkonfigurasi kebijakan keamanan konten browser](#configure-browser-policy)
+ [Menggunakan AppKeys dan Penyewa IDs untuk Amazon Chime SDK](app-keys-tenant-ids.md)

## Mengkonfigurasi untuk media dan pensinyalan
<a name="media-signaling"></a>

Audio, video, dan konten Amazon Chime SDK menggunakan transportasi User Datagram Protocol (UDP) bila memungkinkan. Jika UDP diblokir, Amazon Chime SDK mencoba membuat koneksi Transport Layer Security (TLS) untuk transportasi media dua arah. Pensinyalan Amazon Chime SDK dan pesan data menggunakan Transmission Control Protocol (TCP) dan koneksi. WebSocket 

Diagram berikut menunjukkan jaringan tipikal dengan aplikasi yang menjalankan Amazon Chime SDK. 

![\[Jaringan yang dikonfigurasi untuk menjalankan aplikasi Amazon Chime SDK, dengan komunikasi dua arah antara SDK dan rapat.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/net-config-diagram.png)


Amazon Chime SDK menggunakan tujuan dan port berikut untuk media dan pensinyalan.


| Domain | IPv4 Subnet | IPv6 Subnet | Port | 
| --- | --- | --- | --- | 
| \$1.chime.aws | 99.77.128.0/18 | 2600:f0f 0:4100: :/40 | TCP:443 UDP:3478 | 

Subnet ini adalah `CHIME_MEETINGS` layanan dalam [rentang alamat AWS IP](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html).

## Mengkonfigurasi untuk Amazon Voice Focus
<a name="voice-focus-config"></a>

Pustaka klien Amazon Chime SDK untuk iOS dan Android menyertakan modul Amazon Voice Focus. Pustaka klien Amazon Chime SDK untuk JavaScript mengunduh modul Amazon Voice Focus dari Amazon. CloudFront Pustaka klien Amazon Chime SDK untuk Windows tidak mendukung Voice Focus.

Amazon Voice Focus menggunakan tujuan dan port berikut.


| Domain | Port | 
| --- | --- | 
| \$1.sdkassets.chime.aws | TCP:443 | 

Subnet ini adalah `CLOUDFRONT` layanan dalam [rentang alamat AWS IP](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html).

## Mengkonfigurasi untuk pengurangan gema
<a name="echo-reduction"></a>

Pustaka klien Amazon Chime SDK untuk JavaScript mengunduh modul pengurangan gema dari Amazon. CloudFront

Pengurangan gema menggunakan tujuan dan port berikut.


| Domain | Port | 
| --- | --- | 
| \$1.sdkassets.chime.aws | TCP:443 | 

Subnet ini adalah `CLOUDFRONT` layanan dalam [rentang alamat AWS IP](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html).

## Mengkonfigurasi untuk penggantian latar belakang dan blur
<a name="config-blur"></a>

Pustaka klien Amazon Chime SDK untuk JavaScript mengunduh penggantian latar belakang dan modul blur dari Amazon. CloudFront

Penggantian latar belakang dan blur menggunakan tujuan dan port berikut.


| Domain | Port | 
| --- | --- | 
| \$1.sdkassets.chime.aws | TCP:443 | 

Subnet ini adalah `CLOUDFRONT` layanan dalam [rentang alamat AWS IP](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html).

## Mengkonfigurasi kebijakan keamanan konten browser
<a name="configure-browser-policy"></a>

Saat Anda membuat aplikasi dengan library klien Amazon Chime SDK untuk JavaScript, Anda perlu mengonfigurasi kebijakan keamanan konten browser di aplikasi Anda. Untuk informasi selengkapnya, lihat [Panduan Kebijakan Keamanan Konten](https://aws.github.io/amazon-chime-sdk-js/modules/contentsecurity_policy.html) di GitHub. 

# Menggunakan AppKeys dan Penyewa IDs untuk Amazon Chime SDK
<a name="app-keys-tenant-ids"></a>

Anda dapat menggunakan AppKeys dan Tenant IDs untuk membatasi akses *dari jaringan ke sesi* media Amazon Chime SDK WebRTC aplikasi tertentu.

Pengembang menggunakan Amazon Chime SDK untuk membuat aplikasi yang mengirim dan menerima video real-time melalui UDP. Pengguna aplikasi memerlukan akses UDP ke [https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html)subnet. Organizations (pemilik jaringan) dapat menggunakan AppKeys dan Tenant IDs untuk membatasi akses dari jaringan mereka ke hanya sesi media WebRTC aplikasi tertentu.

**Contoh 1: Menggunakan AppKeys**  
Jika App-A dan App-B menggunakan Amazon Chime SDK, organisasi dapat mengizinkan App-A mengakses sesi media WebRTC dari jaringannya, tetapi memblokir App-B dan aplikasi lain yang menggunakan Amazon Chime SDK. Organizations dapat melakukannya dengan App-A AppKey dan proxy HTTPS. Untuk informasi lebih lanjut, lihat[Membatasi akses ke aplikasi tertentu](#limit-app-access), nanti dalam topik ini.

**Contoh 2: Menggunakan AppKeys dan Penyewa IDs**  
Jika App-A tersedia untuk umum dan digunakan oleh banyak pelanggan, organisasi mungkin ingin mengizinkan App-A mengakses sesi media WebRTC dari jaringan mereka hanya ketika pengguna mereka menjadi bagian dari sesi, dan memblokir akses ke semua sesi App-A lainnya. Organizations dapat melakukan ini dengan menggunakan aplikasi AppKey, TenanID organisasi, dan proxy HTTPS. Untuk informasi lebih lanjut, lihat[Membatasi akses ke penyewa tertentu](#limit-tenant-access), nanti dalam topik ini.

Untuk menggunakan AppKeys dan TenantIDs, Anda harus memiliki server proxy HTTPS yang memungkinkan menambahkan header HTTPS ke permintaan. Diagram berikut menunjukkan bagaimana AppKeys dan Tenant IDs bekerja.

![\[Diagram yang menunjukkan bagaimana AppKeys dan aplikasi IDs kontrol Penyewa dan akses penyewa ke sesi WebRTC.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/app-key-diagram.png)


Dalam gambar, App-A memiliki penyewa A-1 dan A-2, dan App-B memiliki penyewa B-1 dan B-2. Dalam hal ini, AppKey hanya memungkinkan App-A untuk terhubung ke sesi media WebRTC, dan ID penyewa hanya mengakui Tenant A-1 ke sesi.

**Topics**
+ [Membatasi akses ke aplikasi tertentu](#limit-app-access)
+ [Membatasi akses ke penyewa tertentu](#limit-tenant-access)
+ [Contoh header HTTPS](#header-examples)

## Membatasi akses ke aplikasi tertentu
<a name="limit-app-access"></a>

An *AppKey*adalah nilai 256-bit yang konsisten dan unik yang dibuat Amazon Chime untuk setiap akun. AWS Jika Anda tidak memiliki AppKey, Anda dapat memintanya dari Amazon Support. Jika Anda memiliki beberapa AWS akun, Anda dapat meminta akun umum AppKey untuk semua akun Anda.

**catatan**  
Anda dapat berbagi AppKeys secara publik dengan aman dan memungkinkan organisasi lain untuk membatasi akses dari jaringan mereka. 

Amazon Chime SDK secara otomatis mengaitkan setiap sesi media WebRTC dengan berdasarkan ID akun yang digunakan untuk AppKey membuat sesi. AWS Untuk membatasi akses *dari jaringan Anda* ke aplikasi tertentu, lakukan hal berikut:

1. Rutekan semua permintaan keluar ke `CHIME_MEETINGS` subnet melalui server proxy HTTPS. 

1. Konfigurasikan server proxy untuk menambahkan header berikut ke semua permintaan keluar ke `CHIME_MEETINGS` subnet:

   `X-Amzn-Chime-App-Keys:` *comma-separated list of allowed AppKeys*.

   Misalnya, `X-Amzn-Chime-App-Keys:AppKey-A,AppKey-B,AppKey-C` memungkinkan aplikasi yang terkait dengan mereka AppKeys untuk mengakses subnet.

Amazon Chime SDK memeriksa koneksi sesi media WebRTC masuk untuk header dan menerapkan logika berikut: `X-Amzn-Chime-App-Keys`

1. Jika `X-Amzn-Chime-App-Keys` header hadir dan termasuk sesi AppKey, terima koneksi.

1. Jika `X-Amzn-Chime-App-Keys` header hadir tetapi tidak termasuk sesi AppKey, tolak koneksi dengan kesalahan 403.

1. Jika `X-Amzn-Chime-App-Keys` header tidak ada, terima koneksi. Jika pengguna dapat mengakses aplikasi dari luar jaringan organisasi, mereka juga dapat mengakses sesi.

## Membatasi akses ke penyewa tertentu
<a name="limit-tenant-access"></a>

*TenanID* adalah pengidentifikasi buram yang dibuat oleh pengembang. Ingat hal berikut tentang PenyewaIDs:
+ Penyewa tidak IDs dijamin unik antar aplikasi, jadi Anda harus menentukan AppKey untuk setiap daftar TenanID. 
+ Penyewa IDs adalah case senstitive. Masukkan persis seperti yang ditentukan oleh pengembang.
+ Sebuah organisasi dapat membatasi akses ke beberapa aplikasi, tetapi hanya menentukan Penyewa IDs untuk beberapa aplikasi tersebut. Aplikasi tanpa Tenant IDs dapat terhubung ke semua sesi media WebRTC. 

Untuk mengaitkan sesi media dengan PenyewaIDs, pengembang harus terlebih dahulu menambahkan `TenantIds` properti dan daftar Penyewa IDs ke [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html)permintaan.

Sebagai contoh:

`CreateMeeting(..., TenantIds : [ tenantId1, tenantId2 ] )`

Untuk membatasi akses dari jaringan organisasi ke sesi media WebRTC mereka di aplikasi tertentu, lakukan hal berikut:

1. Ikuti langkah-langkah di [Membatasi akses ke aplikasi tertentu](#limit-app-access).

1. Konfigurasikan server proxy HTTPS untuk menambahkan `X-Amzn-Chime-Tenants` header pada koneksi keluar. Sertakan daftar AppKeys dan PenyewaIDs, dibatasi seperti yang ditunjukkan dalam contoh ini: `X-Amzn-Chime-Tenants: AppKey-A:tenantId-A-1,tenantId-A-2;AppKey-B:tenantId-B-1,tenantId-B-2`

Amazon Chime SDK memeriksa koneksi sesi media WebRTC masuk untuk header dan menerapkan logika berikut: `X-Amzn-Chime-Tenants`
+ Jika header menyertakan sesi`AppKey:tenantId`, terima koneksi.
+ Jika header menyertakan sesi `AppKey` tetapi tidak cocok`tenantId`, tolak koneksi dengan kesalahan 403.
+ Jika header *tidak* menyertakan sesi`AppKey`, terima koneksi.
+ Jika header menyertakan sesi`AppKey`, tetapi sesi tidak memiliki setidaknya satu yang diizinkan`tenantId`, tolak koneksi dengan kesalahan 403. Ini mungkin bug pengembang.
+ Jika header tidak ada, terima koneksi. Jika pengguna dapat mengakses aplikasi dari luar jaringan organisasi, mereka juga dapat mengakses semua sesi.

## Contoh header HTTPS
<a name="header-examples"></a>

Contoh berikut menunjukkan beberapa cara untuk menggunakan AppKeys dan Tenant IDs di header HTTPS.

**Satu aplikasi dengan satu penyewa**  
`X-Amzn-Chime-App-Keys: AppKey`  
`X-Amzn-Chime-Tenants: AppKey:orgId`  
Pengguna hanya dapat mengakses sesi media WebRTC organisasi di aplikasi yang ditentukan. Semua aplikasi lain diblokir.

**Satu aplikasi dengan dua penyewa**  
`X-Amzn-Chime-App-Keys: AppKey`  
`X-Amzn-Chime-Tenants: AppKey:engineeringId,salesId`  
Pengguna hanya dapat mengakses sesi media untuk rekayasa dan penjualan di aplikasi yang ditentukan. Semua aplikasi lain diblokir.

**Dua Aplikasi, Satu terbatas untuk Penyewa**  
`X-Amzn-Chime-App-Keys: AppKey1,AppKey2`  
`X-Amzn-Chime-Tenants: AppKey1:orgId`  
Pengguna hanya dapat mengakses sesi media organisasi di Aplikasi 1, dan sesi apa pun di Aplikasi 2. Semua aplikasi lain diblokir.

# Memahami peristiwa siklus hidup rapat Amazon Chime SDK
<a name="using-events"></a>

Amazon Chime SDK mengirimkan peristiwa siklus hidup rapat, yang dapat Anda gunakan untuk memicu notifikasi dan memulai alur kerja hilir. Beberapa contoh penggunaan acara rapat meliputi: 
+ Memperbarui metadata saat peserta bergabung atau meninggalkan rapat Amazon Chime SDK.
+ Menerapkan pemberitahuan push atau daftar nama untuk rapat Amazon Chime SDK.
+ Mengukur penggunaan video dan berbagi konten dalam rapat Amazon Chime SDK.

Anda dapat mengirim acara ke Amazon EventBridge, Amazon Simple Notification Service (SNS), dan Amazon Simple Queue Service (SQS). Untuk informasi selengkapnya, lihat [Acara dari AWS layanan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) di *Panduan EventBridge Pengguna Amazon*.

## Pertemuan Amazon Chime SDK dimulai
<a name="sdk-start-mtg"></a>

Amazon Chime SDK mengirimkan acara ini saat rapat baru dimulai.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:MeetingStarted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",    
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Pertemuan Amazon Chime SDK berakhir
<a name="sdk-end-mtg"></a>

Amazon Chime SDK mengirimkan acara ini saat rapat aktif berakhir.

**catatan**  
Untuk efisiensi, layanan juga mengirimkan acara ini ketika Anda menelepon [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html)API.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:MeetingEnded",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",    
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK ditambahkan
<a name="sdk-add-attendee"></a>

Amazon Chime SDK mengirimkan acara ini saat peserta baru ditambahkan ke rapat aktif.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeAdded",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK dihapus
<a name="sdk-remove-attendee"></a>

Amazon Chime SDK mengirimkan acara ini saat Anda menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteAttendee.html)API untuk menghapus peserta dari rapat aktif. 

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeDeleted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK diotorisasi
<a name="sdk-auth-attendee"></a>

Amazon Chime SDK mengirimkan acara ini ketika pengguna, yang sudah bergabung ke rapat, menggunakan token gabungan yang sama untuk bergabung lagi dalam rapat. Misalnya, pengguna dapat beralih dari mesin desktop ke perangkat seluler. Ini secara efektif “menyerahkan” rapat ke perangkat baru. 

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeAuthorized",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK bergabung dalam rapat
<a name="sdk-join-attendee"></a>

Amazon Chime SDK mengirimkan peristiwa ini ketika peserta yang ada bergabung dengan rapat Amazon Chime SDK menggunakan transportasi jaringan yang ditentukan.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeJoined",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",    
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK meninggalkan rapat
<a name="sdk-leave-attendee"></a>

Amazon Chime SDK mengirimkan peristiwa ini ketika peserta yang ada meninggalkan rapat Amazon Chime SDK menggunakan transportasi jaringan yang ditentukan.

**catatan**  
Layanan tidak pernah mengirim `chime:AttendeeLeft` DAN `chime:AttendeeDropped` acara untuk tindakan “cuti” yang sama. Menjatuhkan dan meninggalkan adalah tindakan yang berbeda, dan sistem mengirimkan acara yang sesuai dengan setiap tindakan.  
Misalnya, katakanlah seorang peserta dengan koneksi yang buruk bergabung dengan rapat pada pukul 11 pagi. Anda dapat mengharapkan tindakan berikut:  

```
11:00 API – CreateAttendee, CreateMeetingWithAttendee, or BatchCreateAttendee
11:00   Event – chime:AttendeeAdded
11:01 Action – user joins meeting
11:01   Event – chime:AttendeeJoined
11:02 Action – user's connection drops
11:02   Event – chime:AttendeeDropped
11:03 Action – user's connection restored
11:03   Event – chime:AttendeeJoined
11:30 Action – user leaves meeting
11:30   Event – chime:AttendeeLeft
```

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeLeft",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK dikeluarkan dari rapat
<a name="sdk-drop-attendee"></a>

Amazon Chime SDK mengirimkan acara ini ketika peserta saat ini dijatuhkan dari rapat Amazon Chime SDK, biasanya karena koneksi yang buruk. Ketika layanan tidak menerima paket selama 10-15 detik, ia menganggap cient dijatuhkan dan mengeluarkan acara tersebut.

Layanan ini biasanya memicu tindakan drop, tetapi klien juga dapat memicunya. Misalnya, katakanlah pengguna mengganti laptop mereka dari Wi-Fi ke Ethernet. Itu merupakan perubahan adaptor jaringan, dan koneksi diatur ulang. Pada gilirannya, itu mengatur ulang soket web dan memicu tindakan drop-join gabungan.

**catatan**  
Layanan tidak pernah mengirim `chime:AttendeeLeft` DAN `chime:AttendeeDropped` acara untuk tindakan “cuti” yang sama. Menjatuhkan dan meninggalkan adalah tindakan yang berbeda, dan sistem mengirimkan acara yang sesuai dengan setiap tindakan.  
Misalnya, katakanlah seorang peserta dengan koneksi yang buruk bergabung dengan rapat pada pukul 11 pagi. Anda dapat mengharapkan tindakan berikut:  

```
11:00 API – CreateAttendee, CreateMeetingWithAttendee, or BatchCreateAttendee
11:00   Event – chime:AttendeeAdded
11:01 Action – user joins meeting
11:01   Event – chime:AttendeeJoined
11:02 Action – user's connection drops
11:02   Event – chime:AttendeeDropped
11:03 Action – user's connection restored
11:03   Event – chime:AttendeeJoined
11:30 Action – user leaves meeting
11:30   Event – chime:AttendeeLeft
```

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeDropped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",  
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK mulai streaming video
<a name="sdk-attendee-video-start"></a>

Amazon Chime SDK mengirimkan acara ini saat peserta yang sudah ada mulai streaming video.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeVideoStarted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK berhenti streaming video
<a name="sdk-attendee-video-stop"></a>

Amazon Chime SDK mengirimkan acara ini ketika peserta yang ada berhenti streaming video.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeVideoStopped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK mulai berbagi layar
<a name="sdk-attendee-screenshare-start"></a>

Amazon Chime SDK mengirimkan acara ini ketika peserta yang ada mulai membagikan layar mereka.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentVideoStarted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Peserta Amazon Chime SDK berhenti berbagi layar
<a name="sdk-attendee-screenshare-stop"></a>

Amazon Chime SDK mengirimkan acara ini ketika peserta yang ada berhenti berbagi layar mereka.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentVideoStopped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Kemampuan peserta Amazon Chime SDK diperbarui
<a name="sdk-attendee-capability-updated"></a>

Amazon Chime SDK mengirimkan acara ini saat kemampuan peserta yang ada diperbarui.

**Example Data peristiwa**  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",
  "id": "12345678-1234-1234-1234-111122223333",
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": [],
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeCapabilitiesUpdated",
    "success": "1", // value can be 1 or 0. 1 means success, 0 means failure
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "mymeeting",
    "attendeeId": "attendeeId",
    "externalUserId": "externalUserId"
    "mediaRegion": "us-east-1"
    "attendeeCapabilities": {
    "audio": "SendReceive",
    "video": "SendReceive",
    "content": "SendReceive"
   }
  }
}
```

## Konten peserta Amazon Chime SDK bergabung dengan rapat
<a name="sdk-content-join"></a>

Amazon Chime SDK mengirimkan peristiwa ini saat berbagi konten bergabung dengan rapat Amazon Chime SDK menggunakan transportasi jaringan yang ditentukan.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentJoined",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Konten peserta Amazon Chime SDK meninggalkan rapat
<a name="sdk-content-leave"></a>

Amazon Chime SDK mengirimkan peristiwa ini saat berbagi konten meninggalkan rapat Amazon Chime SDK menggunakan transportasi jaringan yang ditentukan.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentLeft",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Konten peserta Amazon Chime SDK turun dari rapat
<a name="sdk-content-drop"></a>

Amazon Chime SDK mengirimkan peristiwa ini ketika pembagian konten turun dari rapat Amazon Chime SDK, biasanya karena bandwidth rendah.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentDropped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Konten peserta Amazon Chime SDK mulai streaming video
<a name="sdk-content-start-stream"></a>

Amazon Chime SDK mengirimkan acara ini saat pembagian konten mulai streaming video.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentVideoStarted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

## Konten peserta Amazon Chime SDK berhenti streaming video
<a name="sdk-content-stop-stream"></a>

Amazon Chime SDK mengirimkan acara ini saat pembagian konten berhenti streaming video.

**Example Data peristiwa**  
Contoh berikut menunjukkan data untuk acara ini.  

```
{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentVideoStopped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}
```

# Memahami CloudWatch metrik Amazon untuk rapat Amazon Chime SDK
<a name="sdk-usage-metrics"></a>

Saat Anda menggunakan Amazon Chime SDK, ia mengirimkan metrik layanan dan penggunaan ke. CloudWatch Metrik memungkinkan Anda menggunakan CloudWatch grafik dan dasbor untuk memantau cara Anda menggunakan layanan Amazon Chime SDK. Metrik menangkap data untuk setiap API yang Anda panggil.

Bagian berikut mencantumkan dan menjelaskan metriknya.

**Topics**
+ [Metrik Layanan](#service-metrics)
+ [Metrik penggunaan API](#usage-metrics)

## Metrik Layanan
<a name="service-metrics"></a>

Amazon Chime SDK menerbitkan metrik layanan berikut ke namespace: `AWS/ChimeSDK`


| Metrik | Unit | Deskripsi | 
| --- | --- | --- | 
| `AttendeeAuthorizationSuccess` | Hitung | Jumlah total upaya otorisasi yang berhasil. Sukses berarti bahwa peserta diizinkan untuk bergabung dalam pertemuan. | 
| `AttendeeAuthorizationError` | Hitung | Jumlah total kegagalan otorisasi, menunjukkan bahwa peserta tidak dapat bergabung dalam rapat. | 
| `AttendeeAudioDrops` | Hitung | Jumlah total penurunan audio. | 
| `AttendeeContentDrops` | Hitung | Jumlah total pembagian konten turun. | 
| `MeetingSQSNotificationErrors` | Hitung | Jumlah total kesalahan Pemberitahuan SQS. | 
| `MeetingSNSNotificationErrors` | Hitung | Jumlah total kesalahan Pemberitahuan SNS. | 

## Metrik penggunaan API
<a name="usage-metrics"></a>

Metrik penggunaan API sesuai dengan kuota AWS layanan. Anda dapat mengonfigurasi alarm yang memberi tahu Anda saat penggunaan mendekati kuota layanan. Untuk informasi selengkapnya tentang CloudWatch integrasi dengan kuota layanan, lihat [metrik penggunaan AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html) di * CloudWatch Panduan Pengguna Amazon*.

Amazon Chime SDK menerbitkan metrik API berikut di `AWS/Usage` namespace, dengan nama layanan. `ChimeSDK`


| Metrik | Deskripsi | 
| --- | --- | 
| `CallCount` | Jumlah total panggilan yang dilakukan ke API di Amazon Chime SDK. SUM mewakili jumlah total panggilan ke API selama periode yang ditentukan. | 
| `ErrorCount` | Jumlah total kesalahan yang dilemparkan oleh API di Amazon Chime SDK. SUM mewakili jumlah total panggilan ke API selama periode yang ditentukan. | 
| `ThrottleCount` | Jumlah total kesalahan pelambatan yang dilemparkan oleh API di Amazon Chime SDK. SUM yang mewakili jumlah total panggilan ke API selama periode yang ditentukan. | 

Amazon Chime SDK menerbitkan metrik penggunaan ke `AWS/Usage` namespace dengan dimensi berikut:


| Dimensi | Deskripsi | 
| --- | --- | 
| Layanan | Nama AWS layanan yang berisi sumber daya. Untuk metrik penggunaan Amazon Chime SDK, nilai untuk dimensi ini adalah. `ChimeSDK` | 
| Tipe | Jenis entitas yang dilaporkan. Satu-satunya nilai yang valid untuk metrik penggunaan Amazon Chime SDK adalah. `API` | 
| Sumber Daya | Jenis sumber daya yang melaporkan metrik. Untuk metrik penggunaan Amazon Chime SDK, nilai untuk dimensi ini adalah nama API. | 
| Kelas | Kelas sumber daya yang akan dilacak. Satu-satunya nilai yang valid untuk metrik Amazon Chime SDK adalah. `None` | 

# Membuat saluran media Amazon Chime SDK
<a name="media-pipelines"></a>

Di bagian ini, kami menunjukkan cara membuat saluran media, yang digunakan untuk menangkap atau mengalirkan rapat Amazon Chime SDK. Sebelum memulai, Anda harus mengintegrasikan aplikasi klien Anda dengan library klien Amazon Chime SDK. Untuk informasi selengkapnya, lihat [Pelajari tentang library klien Amazon Chime SDK](mtgs-sdk-client-lib.md). *Untuk informasi selengkapnya tentang saluran media, lihat [Menangkap Rapat Amazon Chime SDK Menggunakan pipeline media](https://aws.amazon.com/blogs//business-productivity/capture-amazon-chime-sdk-meetings-using-media-capture-pipelines/) di AWS Blog Produktivitas Bisnis.*

**penting**  
Anda dan pengguna akhir Anda harus memahami bahwa merekam rapat Amazon Chime SDK mungkin tunduk pada undang-undang atau peraturan terkait pencatatan komunikasi elektronik. Adalah tanggung jawab Anda dan pengguna akhir Anda untuk mematuhi semua hukum yang berlaku mengenai rekaman, termasuk memberi tahu semua peserta dalam sesi rekaman dengan benar bahwa sesi atau komunikasi sedang direkam, dan mendapatkan persetujuan mereka.   
Anda dan pengguna akhir Anda bertanggung jawab atas semua streaming konten menggunakan layanan konektor langsung media, dan harus memastikan bahwa konten tersebut tidak melanggar hukum, melanggar atau menyalahgunakan hak pihak ketiga mana pun, atau melanggar ketentuan material perjanjian Anda dengan Amazon.

**Topics**
+ [Pertimbangan untuk membuat pipeline media Amazon Chime SDK](creating-media-pipelines-considerations.md)
+ [Memahami batas default untuk pipeline media Amazon Chime SDK aktif](media-pipelines-limits.md)
+ [Migrasi ke namespace saluran pipa media Amazon Chime SDK](migrate-pipelines.md)
+ [Memahami pembuatan pipa media Amazon Chime SDK](create-pipeline.md)
+ [Membuat pipeline pengambilan media untuk rapat Amazon Chime SDK](capture-pipe-config.md)
+ [Membuat pipeline penggabungan media untuk rapat Amazon Chime SDK](create-concat-pipe.md)
+ [Membuat pipeline konektor langsung media untuk rapat Amazon Chime SDK](connector-pipe-config.md)
+ [Membuat pipeline aliran media menggunakan Amazon Chime SDK](create-media-stream-pipeline.md)
+ [Mengomposisikan audio dan video ke dalam satu tampilan dalam rapat Amazon Chime SDK](pipeline-compositing.md)
+ [Membuat peran terkait layanan untuk pipeline media Amazon Chime SDK](create-pipeline-role.md)
+ [Menggunakan acara pipeline media Amazon Chime SDK](media-pipe-events.md)
+ [Praktik terbaik untuk menghentikan saluran media Amazon Chime SDK](stop-pipe-best-practices.md)

# Pertimbangan untuk membuat pipeline media Amazon Chime SDK
<a name="creating-media-pipelines-considerations"></a>

Pipa media dapat terdiri dari salah satu saluran pipa ini: 
+ **Pengambilan media** — Gunakan saluran pengambilan media untuk merekam aliran berbagi audio, video, dan konten, ditambah acara rapat dan pesan data. Semua pipeline pengambilan media menyimpan datanya ke bucket [Amazon Simple Storage Service](https://aws.amazon.com/s3/) (S3) yang Anda buat. Anda dapat membuat satu pipeline pengambilan media per rapat Amazon Chime SDK. Untuk informasi lebih lanjut, lihat[Memahami pembuatan pipa media Amazon Chime SDK](create-pipeline.md).
+ **Penggabungan media — Gunakan jaringan pipa penggabungan** media untuk menggabungkan artefak dari pipa penangkapan media. Pipa penggabungan bekerja secara independen dari penangkapan media dan pipa konektor langsung. Untuk informasi lebih lanjut, lihat[Membuat pipeline penggabungan media untuk rapat Amazon Chime SDK](create-concat-pipe.md).
+ **Konektor langsung media** — Gunakan saluran pipa konektor langsung media untuk menyambung ke layanan yang memungkinkan Anda melakukan streaming rapat Amazon Chime SDK ke titik akhir RTMP. Anda dapat membuat hingga satu saluran konektor langsung media per rapat Amazon Chime SDK. Untuk informasi lebih lanjut, lihat[Membuat pipeline konektor langsung media untuk rapat Amazon Chime SDK](connector-pipe-config.md).
+ **Aliran media** — Gunakan saluran aliran media untuk menangkap audio individual untuk semua peserta dalam rapat, ditambah audio campuran yang dihasilkan oleh pipa rangkaian media. Semua saluran aliran media menyimpan datanya ke [Amazon Kinesis Video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/what-is-kinesis-video.html) Streams (KVS). Untuk informasi lebih lanjut, lihat[Membuat pipeline aliran media menggunakan Amazon Chime SDK](create-media-stream-pipeline.md).

Pipeline yang Anda buat bergantung pada namespace yang Anda gunakan. Jika Anda menggunakan `Chime` namespace, Anda hanya dapat membuat pipeline pengambilan media. Jika Anda menggunakan `ChimeSdkMediaPipelines` namespace, Anda juga dapat membuat rangkaian media dan pipeline konektor langsung media, dan menggunakan fitur pengomposisian. Jika Anda ingin bermigrasi ke `ChimeSdkMediaPipelines` namespace, lihat. [Migrasi ke namespace saluran pipa media Amazon Chime SDK](migrate-pipelines.md)

# Memahami batas default untuk pipeline media Amazon Chime SDK aktif
<a name="media-pipelines-limits"></a>

Tabel berikut mencantumkan batas default untuk saluran media aktif di setiap Wilayah. Setiap jenis pipa dihitung menuju batas. Jika Anda melebihi batas untuk Wilayah mana pun, pengecualian [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html), dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html) APIs akan membuang **Batas Sumber Daya Terlampaui**.

Anda dapat menggunakan halaman **Service Quotas** di AWS konsol untuk menyesuaikan batas saluran aktif Anda, atau Anda dapat menghubungi perwakilan [dukungan pelanggan](https://docs.aws.amazon.com/awssupport/latest/user/getting-started.html) Anda. Untuk informasi selengkapnya tentang batas rapat Amazon Chime SDK, lihat. [Kuota untuk Amazon Chime SDK](meetings-sdk.md#mtg-limits)


| Region | Batas pipa aktif default | 
| --- | --- | 
| us-east-1 | 100 | 
| us-west-2 | 10 | 
| ap-northeast-1 | 10 | 
| ap-northeast-2 | 10 | 
| ap-south-1 | 10 | 
| ap-southeast-1 | 10 | 
| ap-southeast-2 | 10 | 
| ca-central-1 | 10 | 
| eu-central-1 | 10 | 
| eu-west-2 | 10 | 

# Migrasi ke namespace saluran pipa media Amazon Chime SDK
<a name="migrate-pipelines"></a>

Anda menggunakan `ChimeSdkMediaPipelines` namespace untuk menangani titik akhir API pipeline media di AWS Wilayah mana pun yang tersedia. Gunakan namespace ini jika Anda baru mulai menggunakan Amazon Chime SDK. Untuk informasi lebih lanjut tentang Wilayah, lihat [Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md) di panduan ini.

Aplikasi yang ada yang menggunakan namespace [Amazon Chime](https://docs.aws.amazon.com/chime/latest/APIReference/API_Operations_Amazon_Chime.html) harus berencana untuk bermigrasi ke namespace khusus.

**Topics**
+ [Alasan untuk memigrasi saluran pipa Anda](#pipeline-migration-reasons)
+ [Sebelum Anda memigrasikan saluran pipa](#migration-prerequisites)

## Alasan untuk memigrasi saluran pipa Anda
<a name="pipeline-migration-reasons"></a>

Kami mendorong Anda untuk bermigrasi ke `ChimeSdkMediaPipelines` namespace karena alasan berikut:

**Pilihan Endpoint API**  
Namespace Amazon Chime SDK Media Capture adalah satu-satunya namespace API yang dapat menggunakan titik akhir API di Wilayah mana pun yang membuatnya tersedia. Untuk informasi lebih lanjut tentang Wilayah, lihat[Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md). Jika Anda ingin menggunakan titik akhir API selain`us-east-1`, Anda harus menggunakan `ChimeSdkMediaPipelines` namespace. Untuk informasi lebih lanjut tentang titik akhir saat ini, lihat [Pemetaan API](migrate-from-chm-namespace.md#name-end-map) di panduan ini.

**Saluran media yang diperbarui dan baru APIs**  
Kami hanya menambahkan atau memperbarui pipeline media APIs di `ChimeSdkMediaPipelines` namespace.

## Sebelum Anda memigrasikan saluran pipa
<a name="migration-prerequisites"></a>

Sebelum Anda bermigrasi, perhatikan perbedaan antara ruang nama. Tabel berikut mencantumkan dan menjelaskannya.


| Item | Ruang nama saluran pipa media | Namespace Chime | 
| --- | --- | --- | 
|  Nama namespace  |  ChimeSdkMediaPipelines  |  Lonceng  | 
|  Wilayah  |  Beberapa  |  us-east-1 saja  | 
|  Titik akhir  |  https://media-pipelines-chime. *wilayah .amazonaws.com*  |  https://service.chime.aws.amazon.com  | 
|  Pemimpin layanan  |  mediapipelines.chime.amazonaws.com  |  chime.amazonaws.com  | 
|  APIs  |  Hanya APIs untuk jaringan pipa media  |  APIs untuk jaringan pipa media dan bagian lain dari Amazon Chime  | 
|  Rapat  |  Saluran media di, `us-west-2``ap-southeast-1`, dan `eu-central-1` wilayah hanya berfungsi dengan rapat yang dibuat di namespace Amazon Chime SDK Meetings. Saluran media di `us-east-1` wilayah tersebut bekerja dengan rapat yang dibuat oleh titik akhir pertemuan apa pun di kedua namespace.  |  Saluran media berfungsi dengan rapat yang dibuat oleh titik akhir rapat apa pun di kedua namespace.  | 
| Pipa media aktif default | 100 di Wilayah us-east-1, dan 10 di Wilayah us-west-2, ap-southeast-1, dan eu-central-1.  | 100 di us-east-1 saja. | 
|  Peran terkait layanan  |  AWSServiceRoleForAmazonChimeSDKMediaPipelines  |     | 
|  Tanda  |  Tersedia  |  Tidak tersedia untuk saluran media APIs.  | 
| CloudTrail sumber acara | chime-sdk-media-pipelines.amazonaws.com | chime.amazonaws.com. | 
| Konektor langsung media | Tersedia |  Tidak tersedia untuk saluran media APIs.  | 
| Pengomposisian | Tersedia |  Tidak tersedia untuk saluran media APIs.  | 
| Rangkaian | Tersedia | Tidak tersedia. | 

Daftar berikut memberikan informasi lebih lanjut tentang perbedaan antara Chime dan ruang AWS ChimeSdkMediaPipelines nama.

**Nama namespace**  
Namespace Amazon Chime SDK menggunakan nama formal. `AWS.Chime` Namespace Amazon Chime SDK Media Pipelines menggunakan nama resmi. `AWS.ChimeSDKMediaPipelines` Format nama yang tepat bervariasi menurut platform.  
Misalnya, baris kode Node.js ini membahas `chime` namespace:  

```
const chimeMediaPipelines = AWS.Chime();
```
Untuk bermigrasi ke namespace Media Pipelines SDK, perbarui kode tersebut dengan namespace baru dan wilayah titik akhir.  

```
const chimeMediaPipelines = AWS.ChimeSDKMediaPipelines({ region: "eu-central-1" });
```

**Wilayah**  
Namespace Amazon Chime hanya menangani titik akhir API di wilayah US-EAST-1. Namespace Amazon Chime SDK Media Pipelines membahas titik akhir API pipeline media Amazon Chime SDK di Wilayah mana pun yang memilikinya. Untuk daftar Wilayah saluran media saat ini, lihat [Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md) di panduan ini.

**Titik akhir**  
Untuk memodifikasi pipeline pengambilan media, Anda harus menggunakan titik akhir yang sama dengan tempat Anda membuat pipeline. Misalnya, jika Anda membuat pipeline melalui titik akhir di eu-central-1, Anda harus menggunakan eu-central-1 untuk berinteraksi dengan pipeline tersebut. Untuk informasi lebih lanjut tentang titik akhir saat ini, lihat [Pemetaan API](migrate-from-chm-namespace.md#name-end-map) di panduan ini.

**Pemimpin layanan**  
Namespace [Amazon Chime SDK Media Pipelines](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) menggunakan prinsip layanan baru:. `mediapipelines.chime.amazonaws.com` Jika Anda memiliki bucket Amazon S3 atau kebijakan IAM lain yang memberikan akses ke layanan, Anda perlu memperbarui kebijakan tersebut untuk memberikan akses ke prinsipal layanan baru.  
Misalnya, saat membuat pipeline media, Anda harus menambahkan izin kebijakan yang tercantum di kepala [Membuat bucket Amazon S3 untuk pipeline pengambilan media Amazon Chime SDK](create-s3-bucket.md) layanan baru. Untuk informasi selengkapnya tentang kebijakan, lihat [elemen kebijakan AWS JSON: Prinsip](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) dalam Panduan Pengguna IAM.

**APIs**  
Namespace Amazon Chime SDK Media Pipelines hanya berisi APIs yang membuat dan mengelola pipeline media. Namespace Amazon Chime mencakup APIs saluran media, rapat, dan bagian lain dari layanan Amazon Chime.

**Rapat**  
Saluran media di wilayah IAD bekerja dengan rapat yang dibuat oleh titik akhir rapat apa pun dengan namespace mana pun.

**Peran terkait layanan**  
Hanya untuk namespace Amazon Chime SDK Media Pipelines. Buat peran *AWSServiceRoleForAmazonChimeSDKMediaPipelines*.

**Tanda**  
[Namespace Amazon Chime SDK Media Pipelines mendukung tag](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html). Peran harus memiliki izin untuk memanggil `TagResource` operasi saat memanggil [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)atau [CreateMediaLiveConnectorPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html) APIs dengan satu atau beberapa tag.

# Memahami pembuatan pipa media Amazon Chime SDK
<a name="create-pipeline"></a>

Anda mengikuti proses multi-langkah untuk membuat pipeline media Amazon Chime SDK, dan Anda dapat membuat beberapa jenis pipeline. Daftar berikut menguraikan proses pembuatan dan memberikan tautan ke informasi lebih lanjut tentang membuat berbagai jenis jaringan pipa. 
+ Buat bucket Amazon S3. Anda harus membuat bucket di AWS Wilayah yang sama dengan rapat. Untuk informasi lebih lanjut, lihat[Membuat bucket Amazon S3 untuk pipeline pengambilan media Amazon Chime SDK](create-s3-bucket.md).
+ Buat peran terkait layanan bernama. `AWSServiceRoleForAmazonChimeSDKMediaPipelines` Hal ini memungkinkan jaringan media untuk mengakses rapat atas nama Anda. Untuk informasi lebih lanjut, lihat[Membuat peran terkait layanan untuk pipeline media Amazon Chime SDK](create-pipeline-role.md).
+ Buat peran IAM dengan izin yang cukup untuk berinteraksi dengan pipeline media [Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html). APIs Untuk membuat peran tersebut, sebaiknya tambahkan kebijakan terkelola [AmazonChimeSDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk) dari konsol IAM. Kebijakan berisi yang diperlukan APIs.

  Peran IAM Anda juga harus memiliki izin untuk memanggil Amazon [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html)S3 API di semua sumber daya. Contoh berikut menunjukkan kebijakan tipikal untuk melakukannya.

------
#### [ JSON ]

****  

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
          {
              "Action": "s3:GetBucketPolicy",
              "Effect": "Allow",
              "Resource": "*"
          }
      ]
  }
  ```

------

Setelah Anda memiliki item tersebut, lihat topik ini untuk informasi tentang membuat pipeline.
+ [Membuat pipeline pengambilan media untuk rapat Amazon Chime SDK](capture-pipe-config.md)
+ [Membuat pipeline penggabungan media untuk rapat Amazon Chime SDK](create-concat-pipe.md)
+ [Membuat pipeline konektor langsung media untuk rapat Amazon Chime SDK](connector-pipe-config.md)
+ [Membuat pipeline aliran media menggunakan Amazon Chime SDK](create-media-stream-pipeline.md)

# Membuat pipeline pengambilan media untuk rapat Amazon Chime SDK
<a name="capture-pipe-config"></a>

Saluran pengambilan media menangkap aliran berbagi audio, video, dan konten, ditambah acara rapat dan pesan data. Semua pipeline pengambilan media menyimpan datanya ke bucket [Amazon Simple Storage Service](https://aws.amazon.com/s3/) (S3) yang Anda buat. Anda dapat membuat satu pipeline pengambilan media per rapat Amazon Chime SDK.

Bagian berikut menjelaskan cara membuat pipeline pengambilan media. Ikuti mereka dalam urutan yang tercantum.

**Topics**
+ [Membuat bucket Amazon S3 untuk pipeline pengambilan media Amazon Chime SDK](create-s3-bucket.md)
+ [Mengaktifkan enkripsi sisi server untuk bucket Amazon S3 untuk saluran pengambilan media Amazon Chime SDK](sse-kms.md)
+ [Mengaktifkan enkripsi sisi server tingkat objek dengan kunci AWS KMS](using-kms-keys-for-encryption.md)
+ [Membuat pipeline pengambilan media Amazon Chime SDK](create-capture-pipe.md)
+ [Bekerja dengan artefak penangkapan media Amazon Chime SDK](artifacts.md)
+ [Mengonfigurasi folder audio untuk pipeline pengambilan media Amazon Chime SDK](configure-audio.md)
+ [Mengonfigurasi folder video untuk saluran pengambilan media Amazon Chime SDK](configure-video.md)
+ [Memahami pesan di folder saluran data untuk pipeline pengambilan media Amazon Chime SDK](data-channel.md)
+ [Memahami struktur folder bucket Amazon S3 untuk pipeline pengambilan media Amazon Chime SDK](capture-folder-structure.md)
+ [Memahami file acara rapat untuk pipeline pengambilan media Amazon Chime SDK](meeting-events.md)
+ [Memahami file transkripsi untuk saluran pengambilan media Amazon Chime SDK](transcription-messages.md)
+ [Menggabungkan aliran data untuk saluran pengambilan media Amazon Chime SDK](concatenate-streams.md)

# Membuat bucket Amazon S3 untuk pipeline pengambilan media Amazon Chime SDK
<a name="create-s3-bucket"></a>

Anda dapat menggunakan konsol Amazon S3 AWS SDKs, atau AWS CLI untuk membuat bucket Amazon S3. Untuk informasi selengkapnya, lihat [Membuat bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html), di Panduan Pengguna *Amazon Simple Storage Service (S3)*.

Bucket Amazon S3 untuk pipeline pengambilan media Anda harus memiliki AWS akun yang sama dengan rapat Amazon Chime SDK. [Selain itu, Anda harus memberikan `s3:PutObject` dan `s3:PutObjectAcl` izin kepada kepala layanan Amazon Chime SDK mediapipelines.chime.amazonaws.com.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) Anda dapat melakukannya dengan konsol Amazon S3 atau AWS Command Line Interface ()AWS CLI. Bucket Amazon S3 harus milik salah satu Wilayah media [Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html) SDK yang tersedia.

**catatan**  
Pastikan untuk menambahkan kebijakan ke pengguna IAM Anda untuk memberikan akses ke bucket Anda. Selain itu, jika Anda menggunakan Wilayah yang AWS menonaktifkan secara default, Anda harus memiliki bucket Amazon S3 di Wilayah tersebut.  
Secara default, AWS menonaktifkan Wilayah berikut, dan Anda tidak dapat menghosting sumber daya rapat di dalamnya hingga Anda mengaktifkannya:  
Africa (Cape Town)
Asia Pasifik (Hong Kong)
Asia Pasifik (Jakarta)
Europe (Milan)
Timur Tengah (Bahrain)
Jika Anda menggunakan salah satu Wilayah tersebut, ia harus memiliki bucket Amazon S3. Ini berlaku bahkan jika Anda menggunakan Amazon S3 APIs untuk berkomunikasi dengan Wilayah yang tidak diblokir secara default dan sudah memiliki bucket. Untuk informasi selengkapnya tentang mengaktifkan wilayah yang diblokir, lihat [Mengelola Wilayah AWS](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) di *Referensi Umum AWS*.

Setelah Anda membuat ember, rekam ARN-nya. Anda menggunakannya untuk membuat pipeline pengambilan media.

Contoh berikut menunjukkan kebijakan bucket Amazon S3.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Id": "AWSChimeMediaCaptureBucketPolicy",
    "Statement": [
        {
            "Sid": "AWSChimeMediaCaptureBucketPolicy",
            "Effect": "Allow",
            "Principal": {
                "Service": "mediapipelines.chime.amazonaws.com"
            },
            "Action": [ "s3:PutObject", "s3:PutObjectAcl" ],
            "Resource": "arn:aws:s3:::Bucket_Name/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                },
                "ArnLike": {
                "aws:SourceArn": "arn:aws:chime:*:123456789012:*"
                }
            }
        }
    ]
}
```

------

# Mengaktifkan enkripsi sisi server untuk bucket Amazon S3 untuk saluran pengambilan media Amazon Chime SDK
<a name="sse-kms"></a>

Untuk mengaktifkan enkripsi sisi server untuk bucket Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3), Anda dapat menggunakan jenis kunci enkripsi berikut:
+ Kunci terkelola Amazon S3
+ Kunci yang dikelola pelanggan di Layanan Manajemen AWS Kunci (KMS)
**catatan**  
Layanan Manajemen Kunci mendukung dua jenis kunci, kunci yang dikelola pelanggan dan kunci AWS terkelola. Rapat Amazon Chime SDK hanya mendukung kunci yang dikelola pelanggan. 

## Menggunakan kunci terkelola Amazon S3
<a name="s3-keys"></a>

Anda menggunakan konsol Amazon S3, CLI, atau REST API untuk mengaktifkan enkripsi sisi server untuk bucket Amazon S3. Dalam kedua kasus, pilih **Amazon S3 Key sebagai jenis kunci** enkripsi. Tidak diperlukan tindakan lebih lanjut. Saat Anda menggunakan bucket untuk pengambilan media, artefak akan diunggah dan dienkripsi di sisi server. Untuk informasi selengkapnya, lihat [Menentukan enkripsi Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-s3-encryption.html) di Panduan Pengguna *Amazon S3*. 

## Menggunakan kunci yang Anda miliki
<a name="customer-key"></a>

Untuk mengaktifkan enkripsi dengan kunci yang Anda kelola, Anda perlu mengaktifkan enkripsi sisi server bucket Amazon S3 dengan Kunci yang Dikelola Pelanggan, lalu menambahkan pernyataan ke kebijakan kunci yang memungkinkan Amazon Chime menggunakan kunci dan mengenkripsi artefak apa pun yang diunggah.

1. Buat Kunci yang Dikelola Pelanggan di KMS. *Untuk informasi tentang melakukannya, lihat [Menentukan enkripsi sisi server dengan AWS KMS (SSE-KMS) di Panduan Pengguna Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-kms-encryption.html).*

1. Tambahkan pernyataan ke kebijakan kunci yang memungkinkan `GenerateDataKey` tindakan menghasilkan kunci untuk digunakan oleh prinsipal layanan Amazon Chime SDK,. `mediapipelines.chime.amazonaws.com`

   Contoh ini menunjukkan pernyataan yang khas.

   ```
   ...
   {
       "Sid": "MediaPipelineSSEKMS",
       "Effect": "Allow",
       "Principal": {
           "Service": "mediapipelines.chime.amazonaws.com"
       },
       "Action": "kms:GenerateDataKey",
       "Resource": "*",
       "Condition": {
           "StringEquals": {
              "aws:SourceAccount": "Account_Id"
           },
           "ArnLike": {
               "aws:SourceArn": "arn:aws:chime:*:Account_Id:*"
           }
       }
   }
   ...
   ```

1. Jika Anda menggunakan pipeline penggabungan media, tambahkan pernyataan ke kebijakan kunci yang memungkinkan prinsipal layanan Amazon Chime SDK, `mediapipelines.chime.amazonaws.com` untuk menggunakan tindakan tersebut. `kms:Decrypt`

1. Konfigurasikan bucket Amazon S3 untuk mengaktifkan enkripsi sisi server dengan kunci.

# Mengaktifkan enkripsi sisi server tingkat objek dengan kunci AWS KMS
<a name="using-kms-keys-for-encryption"></a>

Media Capture Pipeline dan Media Concatenation Pipeline dapat menggunakan AWS Key Management Service (AWS KMS) kunci yang dikelola pelanggan untuk mengaktifkan enkripsi sisi server (SSE) untuk objek individual dalam bucket Amazon S3. Untuk mengonfigurasi ini, Anda harus menggunakan panggilan [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)API. Media Concatenation Pipeline akan menggunakan parameter enkripsi sisi server dari Media Capture Pipeline terkait.

Untuk mengaktifkan SSE untuk objek individual (SSE tingkat objek) menggunakan kunci terkelola AWS KMS pelanggan Anda, Anda harus menyediakan `SseAwsKeyManagementParams` struktur dan `SinkIamRoleArn` selama panggilan API: [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)

1. Gunakan `AwsKmsKeyId` parameter dalam `SseAwsKeyManagementParams` struktur untuk menentukan AWS KMS kunci. Anda dapat menentukan ID kunci menggunakan ID kunci, ARN, atau alias.

1. Gunakan `SinkIamRoleArn` parameter untuk menentukan peran IAM untuk mengakses AWS KMS kunci dan bucket Amazon S3 sink.

1. Secara opsional, Anda dapat menggunakan `AwsKmsEncryptionContext` parameter dalam `SseAwsKeyManagementParams` struktur untuk menentukan konteks enkripsi yang akan digunakan bersama dengan artefak AWS KMS kunci untuk meningkatkan keamanan.

**catatan**  
`SinkIamRoleArn`Parameter `AwsKmsKeyId` dan saling bergantung. Jika keduanya ada dan valid, Media Capture Pipeline akan mengambil peran dan menempatkan setiap artefak ke dalam bucket-sink Amazon S3 yang ditentukan dengan kunci yang ditentukan. AWS KMS Panggilan [CreateMediaConcatenationPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html)API tidak memiliki parameter baru tetapi akan menggunakan parameter yang disebutkan di atas jika ditentukan. Jika Anda berencana menggabungkan artefak, pastikan konfigurasi sumber daya Anda diatur seperti yang dijelaskan di [Konfigurasi](#using-kms-keys-for-encryption-config) bagian berikut, dan persisten dari waktu ke waktu.

## Konfigurasi
<a name="using-kms-keys-for-encryption-config"></a>

`SinkIamRoleArn`Harus memiliki izin dan akses yang sama dengan prinsipal untuk memasukkan artefak ke dalam bucket Amazon S3. Untuk informasi selengkapnya tentang izin default yang diharapkan di bucket Amazon S3, [lihat Membuat bucket Amazon S3 untuk Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/dg/create-s3-bucket.html) Media Capture Pipelines. Untuk mengaktifkan SSE untuk objek individual, bucket Amazon S3 Anda harus mengizinkan peran IAM yang ditentukan menggunakan `SinkIamRoleArn` untuk melakukan serangkaian tindakan yang sama yang Anda harapkan dari identitas IAM pemanggilan. Anda dapat mencapainya dengan menambahkan prinsipal berikut ke kebijakan izin bucket Amazon S3 Anda.

```
...
"Principal": {
    ...
    "AWS": "arn:aws:iam::<YOUR_ACCOUNT_ID>;:role/<SINK_IAM_ROLE_NAME>"
    ...
},
...
```

`AwsKmsKeyId`Harus menunjuk ke kunci yang memungkinkan `SinkIamRoleArn` untuk melakukan`GenerateDataKey`. Jika Media Concatenation Pipeline akan digunakan, AWS KMS kunci juga harus mengizinkan penggunaan tindakan. `Decrypt` Lihat contoh berikut ini.

**catatan**  
Sumber daya diatur untuk menggunakan wildcard`“*”`, yang dalam konteks kebijakan AWS KMS kunci ini menandakan “dirinya sendiri”.

```
{
    "Effect": "Allow",
    "Principal": {
        "AWS": "arn:aws:iam::<YOUR_ACCOUNT_ID>:role/<YOUR_CUSTOMER_ROLE_ID>"
    },
    "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
    ],
    "Resource": "*"
}
```

`SinkIamRoleArn`Peran tersebut harus memiliki hubungan kepercayaan yang memungkinkan layanan untuk mengasumsikan itu. Lihat contoh berikut ini.

```
{
    "Effect": "Allow",
    "Principal": {
        "Service": "mediapipelines.chime.amazonaws.com"
    },
    "Action": "sts:AssumeRole",
    "Condition": {
        "StringEquals": {
            "aws:SourceAccount": "<YOUR_ACCOUNT_ID>"
        },
        "ArnLike": {
            "aws:SourceArn": "arn:aws:chime:*:<YOUR_ACCOUNT_ID>:*"
        }
    }
}
```

`SinkIamRoleArn`Harus memiliki kebijakan izin minimum berikut untuk Media Capture Pipeline. Lihat contoh berikut ini.

```
{
    "Effect": "Allow",
    "Action": "kms:GenerateDataKey",
    "Resource": "arn:aws:kms:<KMS_KEY_REGION>:<KMS_KEY_ACCOUNT_ID>:key/<MS_KEY_ID>",
    "Condition": {
        "StringEquals": {
            "aws:SourceAccount": "<YOUR_ACCOUNT_ID>"
        },
        "ArnLike": {
            "aws:SourceArn": "arn:aws:chime:*:<YOUR_ACCOUNT_ID>:*"
        }
    }
},
{
    "Effect": "Allow",
    "Action": ["s3:PutObject", "s3:PutObjectAcl"],
    "Resource": "arn:aws:s3:::<YOUR_DEDICATED_KMS_BUCKET_ID>/*",
    "Condition": {
        "StringEquals": {
            "aws:SourceAccount": "<YOUR_ACCOUNT_ID>"
        },
        "ArnLike": {
            "aws:SourceArn": "arn:aws:chime:*:<YOUR_ACCOUNT_ID>:*"
        }
    }
}
```

Selain itu, penelepon harus diizinkan untuk lolos `SinkIamRoleArn` ke layanan. Dalam kasus ketika penelepon tidak memiliki izin seperti itu, itu harus ditambahkan secara eksplisit. Lihat contoh berikut ini.

```
{
    "Effect": "Allow",
    "Action": "iam:PassRole",
    "Resource": "<SINK_IAM_ROLE_ARN>",
    "Condition": {
        "ArnLike": {
            "iam:AssociatedResourceArn": "arn:aws:chime:*:<YOUR_ACCOUNT_ID>:media-pipeline/*"
        },
        "StringEquals": {
            "iam:PassedToService": "mediapipelines.chime.amazonaws.com"
        }
    }
}
```

## Implementasi penggabungan media
<a name="media-concatenation-implementatoin"></a>

Jika Anda berencana menggunakan Media Concatenation Pipeline setelah Pengambilan Media, lihat [Membangun pipeline penggabungan media Amazon Chime SDK](create-concat-pipe-steps.md) untuk memahami izin yang diperlukan. Agar pipeline berfungsi dengan AWS KMS kunci untuk SSE tingkat objek, `SinkIamRoleArn` izin (tindakan yang diizinkan) harus diperluas untuk kunci dan bucket AWS KMS Amazon S3. Lihat contoh berikut ini.

```
...
{
    ...
    {
        ...
        "Action": ["kms:GenerateDataKey","kms:Decrypt"]
        "Resource": "arn:aws:kms:<KMS_KEY_REGION>:<KMS_KEY_ACCOUNT_ID>:key/<KMS_KEY_ID>",
        ...
    }
    ...
    {
        "Action": [ "s3:PutObject", "s3:PutObjectAcl", "s3:GetObject", "s3:ListBucket"],
        "Resource": "arn:aws:s3:::<YOUR_DEDICATED_KMS_BUCKET_ID>/*",
    }
    ...
}
...
```

# Membuat pipeline pengambilan media Amazon Chime SDK
<a name="create-capture-pipe"></a>

Setelah membuat dan mengonfigurasi bucket atau bucket Amazon S3, Anda membuat pipeline pengambilan media.

**Untuk membuat pipeline pengambilan media**
+ Panggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)API.

  Gunakan bucket ARN sebagai parameter. `SinkArn`

Setelah berhasil, Amazon Chime SDK membuat peserta yang bergabung dan menangkap rapat.

Setelah membuat pipeline pengambilan media dan menyetel izinnya, Anda membuat pipeline penggabungan media untuk menggabungkan potongan media 5 detik menjadi satu file. Untuk informasi lebih lanjut, lihat[Membuat pipeline penggabungan media untuk rapat Amazon Chime SDK](create-concat-pipe.md), nanti di bagian ini.

# Bekerja dengan artefak penangkapan media Amazon Chime SDK
<a name="artifacts"></a>

Selama rapat Amazon Chime SDK, pipeline pengambilan media membuat jenis artefak berikut. 
+ Audio
+ Video
+ Pesan saluran data
+ Acara pertemuan
+ Pesan transkripsi

Pipeline membuat artefak dalam satu set folder di bucket Amazon S3 Anda, dan Anda dapat mengonfigurasi folder audio dan video untuk membatasi jenis artefak tertentu. Bagian berikut menjelaskan struktur folder, cara mengonfigurasi folder, cara mengatur izin untuk bucket Amazon S3 Anda, dan cara menggabungkan file artefak.

# Mengonfigurasi folder audio untuk pipeline pengambilan media Amazon Chime SDK
<a name="configure-audio"></a>

Folder audio berisi MP4 file 5 detik dari aliran audio campuran, yang berarti mereka berisi audio dari semua peserta, ditambah video speaker aktif. Folder berisi file untuk seluruh rapat. Seperti yang diinginkan, Anda dapat mengonfigurasi folder untuk hanya berisi artefak audio. Setiap nama file berisi *yyyy-mm-dd-hour- min-seconds-milleseconds* stempel waktu. Stempel waktu ada di UTC, dan ini menandai waktu mulai. Anda dapat mengonfigurasi folder agar hanya berisi artefak audio.

```
"ArtifactsConfiguration": { 
         "Audio": { 
            "MuxType": "AudioOnly"
         },
         "Content": {
            "State": "Disabled"
         },
         "Video": {
            "State": "Disabled"
         }
      }
```

# Mengonfigurasi folder video untuk saluran pengambilan media Amazon Chime SDK
<a name="configure-video"></a>

Folder video berisi MP4 file 5 detik yang berisi aliran video, ditambah aliran berbagi konten jika ditentukan dalam permintaan API. Setiap nama file berisi <attendeeID>stempel waktu < yyyy-mm-dd-hour - min-seconds-milleseconds >- dengan ID peserta. Potongan video berbagi konten ditambahkan sebagai < min-seconds-milleseconds -> yyyy-mm-dd-hour - <attendeeID>\$1content .mp4. Anda dapat mengonfigurasi folder agar hanya berisi artefak video.

```
"ArtifactsConfiguration": { 
         "Audio": { 
            "MuxType": "AudioOnly"
         },
         "Content": {
            "State": "Disabled"
         },
         "Video": {
            "MuxType": "VideoOnly"
            "State": "Enabled"
         }
      }
```

# Memahami pesan di folder saluran data untuk pipeline pengambilan media Amazon Chime SDK
<a name="data-channel"></a>

Folder data-channel berisi pesan data dalam format.txt, dan setiap pesan adalah objek JSON. Pesan terlihat dengan semua opsi konfigurasi. Nama file berisi *yyyy-mm-dd-hour- min-seconds-milleseconds* stempel waktu. Contoh ini menunjukkan bidang data dalam pesan.

```
{
    "Timestamp": "string", 
    "Topic": "string", 
    "Data": "string", 
    "SenderAttendeeId": "string"
}
```

# Memahami struktur folder bucket Amazon S3 untuk pipeline pengambilan media Amazon Chime SDK
<a name="capture-folder-structure"></a>

Bucket Amazon S3 untuk pipeline pengambilan media menggunakan struktur folder ini.

```
S3 bucket path/
  audio
  video  
  data-channel
  meeting-events
  transcription-messages
```

# Memahami file acara rapat untuk pipeline pengambilan media Amazon Chime SDK
<a name="meeting-events"></a>

Folder acara pertemuan berisi peristiwa pertemuan dalam format.txt, dan setiap acara adalah objek JSON. Pesan terlihat dengan semua opsi konfigurasi. Nama file berisi stempel waktu < yyyy-mm-dd-hour min-seconds-milleseconds ->. Contoh ini menunjukkan bidang dan data dalam file peristiwa yang khas.

```
{
    "Timestamp": "string",
    "EventType": "AttendeeJoined | AttendeeLeft | AttendeeVideoJoined | AttendeeVideoLeft | ActiveSpeaker | CaptureStarted | CaptureEnded  | AudioTrackMute | AudioTrackUnmute",
    "EventParameters": {
        # ...
    }
}
```

# Memahami file transkripsi untuk saluran pengambilan media Amazon Chime SDK
<a name="transcription-messages"></a>

Folder transkripsi-pesan berisi file transkripsi dalam format.txt. Namun, folder hanya menerima file saat Anda mengaktifkan transkripsi langsung. Untuk informasi lebih lanjut tentang mengaktifkan transkripsi langsung, lihat. [Menggunakan transkripsi langsung Amazon Chime SDK](meeting-transcription.md)

Folder mencakup semua pesan transkripsi sebagian dan lengkap, dan setiap pesan adalah objek JSON. Nama file berisi stempel waktu < yyyy-mm-dd-hour min-seconds-milleseconds ->. Anda dapat melihat contoh file transkripsi di[Memproses acara transkrip langsung Amazon Chime SDK yang diterima](delivery-examples.md).

# Menggabungkan aliran data untuk saluran pengambilan media Amazon Chime SDK
<a name="concatenate-streams"></a>

**catatan**  
Untuk mengotomatiskan proses penggabungan artefak penangkapan media, lihat dalam panduan ini. [Membuat pipeline penggabungan media untuk rapat Amazon Chime SDK](create-concat-pipe.md)

Contoh ini menggunakan ffmpeg untuk menggabungkan file video atau audio menjadi satu file mp4. Pertama, buat file filelist.txt yang berisi semua file input. Gunakan format ini: 

```
file 'input1.mp4'
file 'input2.mp4'
file 'input3.mp4'
```

Selanjutnya, gunakan perintah ini untuk menggabungkan file input:

```
ffmpeg -f concat -i filelist.txt -c copy output.mp4
```

Untuk informasi lebih lanjut tentang jaringan pipa penggabungan media, lihat di panduan ini. [Membuat pipeline penggabungan media untuk rapat Amazon Chime SDK](create-concat-pipe.md)

# Membuat pipeline penggabungan media untuk rapat Amazon Chime SDK
<a name="create-concat-pipe"></a>

Anda menggunakan jaringan pipa penggabungan media untuk menggabungkan artefak (file) yang dihasilkan oleh pipeline penangkapan media.

Saluran pengambilan media menangkap konten rapat dengan memotong aliran media dan menyimpan artefak tersebut di bucket Amazon S3 Anda. Pipa penangkapan media membuat jenis artefak berikut: 
+ Audio
+ Video
+ Berbagi konten
+ Pesan saluran data
+ Pesan transkripsi
+ Acara pertemuan
+ Video komposit, artinya berbagi konten dan beberapa aliran video ditampilkan dalam kisi sebagai ubin video.

Saluran penggabungan media memungkinkan Anda menggabungkan setiap jenis artefak menjadi satu file, lalu menyimpan file yang lebih besar itu di bucket Amazon S3 Anda. Anda dapat membuat pipeline penggabungan media tanpa menunggu acara pengambilan media berakhir, tetapi pipeline penggabungan hanya mulai digabungkan saat pipeline pengambilan berhenti.

**catatan**  
Pipa penangkap media, jaringan pipa penggabungan media, dan bucket Amazon S3 harus berada di akun yang sama. AWS 

**Topics**
+ [Arsitektur pipa penggabungan Amazon Chime SDK](concat-architecture.md)
+ [Membangun pipeline penggabungan media Amazon Chime SDK](create-concat-pipe-steps.md)
+ [Memahami struktur folder bucket Amazon S3 untuk pipeline penggabungan Amazon Chime SDK](concat-folder-structure.md)

# Arsitektur pipa penggabungan Amazon Chime SDK
<a name="concat-architecture"></a>

Diagram berikut menunjukkan arsitektur pipa rangkaian media.

![\[Diagram yang menunjukkan arsitektur pipa rangkaian media.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/concatenation-pipe-architecture-2.png)


Dalam diagram, saat menerima [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)permintaan, bidang kontrol pipa media memulai pipa penangkapan media di bidang data pipa media. Pesawat data kemudian mendorong potongan yang ditangkap ke ember penangkapan setiap 5 detik. Saat menerima [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html)permintaan, bidang kontrol pipa media menunggu pipa pengambilan media yang ditentukan selesai, kemudian memulai pipa penggabungan media di bidang data pipa media. Bidang data kemudian membaca potongan yang ditangkap di ember dan mendorong artefak gabungan ke ember penggabungan.

# Membangun pipeline penggabungan media Amazon Chime SDK
<a name="create-concat-pipe-steps"></a>

Anda mengikuti proses multi-langkah untuk membuat pipeline penggabungan media Amazon Chime SDK. Langkah-langkah berikut menjelaskan prosesnya.

1. Buat bucket Amazon S3 untuk digunakan sebagai sink data pipeline pengambilan media, lalu konfigurasikan kebijakan bucket. Untuk informasi tentang mengaktifkan enkripsi sisi server untuk bucket Amazon S3, lihat [Mengaktifkan enkripsi sisi server untuk bucket Amazon S3 Amazon dalam panduan ini](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html). Jika Anda membuat bucket Amazon Amazon S3 untuk digunakan dengan pipeline pengambilan media, Anda harus menambahkan `s3:GetObject` dan `s3:ListBucket` tindakan ke kebijakan bucket tersebut. `s3:ListBucket`Tindakan ini membutuhkan izin pada ember. Tindakan lain memerlukan izin pada objek di ember. Anda harus menggunakan dua Amazon Resource Names (ARNs) yang berbeda untuk menentukan izin tingkat ember dan tingkat objek.

   Contoh berikut menunjukkan kebijakan bucket. Salin dan tempel contoh ini sesuai kebutuhan.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Id": "AWSChimeMediaCaptureBucketPolicy",
       "Statement": [
           {
               "Sid": "AWSChimeMediaCaptureBucketPolicy",
               "Effect": "Allow",
               "Principal": {
                   "Service": [
                       "mediapipelines.chime.amazonaws.com"
                   ]
               },
               "Action": [
                   "s3:PutObject",
                   "s3:PutObjectAcl",
                   "s3:GetObject",
                   "s3:ListBucket"
               ],
               "Resource": [
                   "arn:aws:s3:::[Bucket-Name]/*",
                   "arn:aws:s3:::[Bucket-Name]"
               ],
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "123456789012"
                   },
                   "ArnLike": {
                   "aws:SourceArn": "arn:aws:chime:*:123456789012:*"
                   }
               }
           }
       ]
   }
   ```

------

1.  Buat bucket Amazon S3 Amazon untuk digunakan sebagai sink data pipeline rangkaian media, lalu konfigurasikan kebijakan bucket. Untuk informasi tentang mengaktifkan enkripsi sisi server untuk bucket Amazon S3, lihat [Mengaktifkan enkripsi sisi server untuk bucket Amazon S3 Amazon dalam panduan ini](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html). 

   Contoh berikut menunjukkan kebijakan.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Id": "AWSChimeMediaConcatenationBucketPolicy",
       "Statement": [
           {
               "Sid": " AWSChimeMediaConcatenationBucketPolicy ",
               "Effect": "Allow",
               "Principal": {
                   "Service": [
                       "mediapipelines.chime.amazonaws.com"
                   ]
               },
               "Action": [
                   "s3:PutObject",
                   "s3:PutObjectAcl",
                   "s3:GetObject",
                   "s3:ListBucket"
               ],
               "Resource": [
                   "arn:aws:s3:::[Bucket-Name]/*",
                   "arn:aws:s3:::[Bucket-Name]"
               ],
               "Condition": {
                   "StringEquals": {
                   "aws:SourceAccount": "123456789012"
                   },
                   "ArnLike": {
                   "aws:SourceArn": "arn:aws:chime:*:123456789012:*"
                   }
               }
           }
       ]
   }
   ```

------
**catatan**  
Anda dapat menggunakan satu bucket Amazon S3 untuk pengambilan media dan jaringan pipa penggabungan media. Namun, jika melakukannya, Anda harus menambahkan `s3:ListBucket` izin `s3:GetObject` dan ke kebijakan bucket penggabungan media yang ditampilkan pada langkah 2. Jika Anda tidak ingin kebijakan bucket penggabungan memiliki izin tersebut, buat bucket terpisah untuk setiap pipeline. 

1. Gunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)API untuk membuat pipeline pengambilan media. Sebagai bagian dari itu, dapatkan ARN pipa. Untuk informasi tentang mendapatkan ARN, lihat. [Memahami pembuatan pipa media Amazon Chime SDK](create-pipeline.md) Anda menggunakan ARN di langkah berikutnya.

1. Gunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html)API untuk membuat pipeline penggabungan.

   Contoh berikut menunjukkan badan permintaan. *Path*Bidang ini opsional, dan default ke ID pipeline penggabungan.
**catatan**  
Anda harus menggunakan yang `MediaPipelineArn` dibuat dalam 30 hari terakhir.

   ```
   {
       "Sources": [
           {
               "Type": "MediaCapturePipeline",
               "MediaCapturePipelineSourceConfiguration": {
                   "MediaPipelineArn": "Media_Pipeline_Arn",  //must be <30 days old
                   "ChimeSdkMeetingConfiguration": {
                       "ArtifactsConfiguration": {
                           "Audio": {
                               "State": "Enabled"
                           },
                           "Video": {
                               "State": "Enabled | Disabled"
                           },
                           "Content": {
                               "State": "Enabled | Disabled"
                           },
                           "DataChannel": {
                               "State": "Enabled | Disabled"
                           },
                           "TranscriptionMessages": {
                               "State": "Enabled | Disabled"
                           },
                           "MeetingEvents": {
                               "State": "Enabled | Disabled"
                           },
                           "CompositedVideo": {
                               "State": "Enabled | Disabled"
                           }
                       }
                   }
               }
           }
       ],
       "Sinks": [
           {
               "Type": "S3Bucket",
               "S3BucketSinkConfiguration": {
                   "Destination": "arn:aws:s3:::[Bucket_Name]/[Path]"
               }
           }
       ]
   }
   ```

   Penggabungan dimulai setiap kali pipa penangkapan berhenti. Pipa penggabungan berhenti setelah menyelesaikan penggabungan.

# Memahami struktur folder bucket Amazon S3 untuk pipeline penggabungan Amazon Chime SDK
<a name="concat-folder-structure"></a>

Bucket Amazon S3 untuk jaringan pipa penggabungan media menggunakan struktur folder ini:

```
S3 bucket path/
  audio
  video
  composited-video
  data-channel
  meeting-events
  transcription-messages
```

**catatan**  
Jika Anda menentukan awalan saat membuat pipeline media, jalur ke folder menjadi *nama bucket*/*awalan*. Tanpa awalan, path menjadi *nama bucket*/*media pipeline ID*. Anda menentukan awalan di `Destination` bidang `S3BucketSinkConfiguration` objek. Nama file gabungan terdiri dari ID pipa media .mp4 untuk file *media dan ID pipa* media .txt untuk file *teks*.

# Membuat pipeline konektor langsung media untuk rapat Amazon Chime SDK
<a name="connector-pipe-config"></a>

Bagian berikut mencantumkan dan menjelaskan pengaturan Real-Time Messaging Protocol (RTMP), audio, dan video untuk saluran konektor media live.

**Pengaturan RTMP**  
Pipa konektor langsung media mendukung RTMP melalui koneksi TLS/SSL . URL sink terdiri dari URL aliran dan kunci aliran. Berikut URLs format ini:

`rtmp(s)://stream-server/stream-key`

Contoh berikut menunjukkan cara terhubung ke platform streaming umum.
+ **Layanan Video Interaktif Amazon (IVS)** - rtmps: //a1b2c3d4e5f6.global-contribute.live-video.net:443/app/ *IVS-stream-key*
+ **YouTube**— rtmps: //a.youtube.com/live2/ *stream-key*
+ **Kedutan - rtmps: //live.twitch.tv/app/** *primary-stream-key*

**penting**  
RTMPS menggunakan enkripsi untuk membantu memastikan bahwa aliran tidak dicegat oleh entitas yang tidak sah. Sebagai praktik terbaik, gunakan RTMPS saat Anda membutuhkan keamanan data tambahan.

**Pengaturan audio**  
Pipa konektor langsung media mendukung pengaturan audio berikut:
+ **Codec — AAC**
+ **Tingkat sampel** - 44100 Hz atau 48000 Hz. Defaultnya adalah 44100Hz.
+ **Saluran** — Mono atau stereo. Defaultnya adalah mono.

**Pengaturan video**  
Pipa konektor langsung media menggunakan encoder H264. Anda dapat menggunakan HD pada 1280x720 atau FHD pada 1920x1080. Kedua resolusi menggunakan 30 frame per detik, dengan keyframe setiap dua detik.

**Menghentikan jaringan pipa konektor langsung media**  
Sebagai praktik terbaik untuk menghentikan saluran pipa konektor langsung media, hubungi [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html)API. Mengakhiri streaming pada platform streaming seperti IVS tidak menghentikan saluran konektor langsung media.

# Membuat pipeline aliran media menggunakan Amazon Chime SDK
<a name="create-media-stream-pipeline"></a>

Pipa aliran media menangkap audio individual untuk semua peserta dalam rapat, ditambah audio campuran yang dihasilkan oleh pipa rangkaian media. Semua saluran aliran media menyimpan datanya ke [Amazon Kinesis Video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/what-is-kinesis-video.html) Streams (KVS).

Anda membuat aliran video dengan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html)API. Anda dapat membuat satu saluran aliran media per rapat Amazon Chime SDK.

**catatan**  
Jika rapat menggunakan Region keikutsertaan sebagai Region [MediaRegion](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html#chimesdk-meeting-chime_CreateMeeting-request-MediaRegion), aliran KVS harus berada di Region yang sama. Misalnya, jika rapat menggunakan `af-south-1` Wilayah, aliran KVS juga harus masuk`af-south-1`. Namun, jika rapat menggunakan Wilayah yang diaktifkan AWS secara default, aliran KVS dapat berada di Wilayah mana pun yang tersedia, termasuk Wilayah keikutsertaan. Misalnya, jika rapat digunakan`ca-central-1`, aliran KVS dapat berada di`eu-west-2`, `us-east-1``af-south-1`, atau Wilayah lain yang didukung Amazon Chime SDK.  
Untuk mempelajari AWS Wilayah mana yang digunakan rapat, panggil [GetMeeting](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_GetMeeting.html)API dan gunakan [MediaRegion](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html#chimesdk-meeting-chime_CreateMeeting-request-MediaRegion)parameter dari respons.  
Untuk informasi selengkapnya tentang keikutsertaan Wilayah, lihat [Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md) di panduan ini, dan [Tentukan AWS Wilayah mana yang dapat digunakan akun Anda](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#rande-manage-enable.html), di *Panduan Referensi Manajemen AWS Akun*.

Bagian berikut menjelaskan cara membuat pipeline aliran media. Ikuti mereka dalam urutan yang tercantum.

**Topics**
+ [Membuat kumpulan Kinesis Video Streams untuk saluran aliran media Amazon Chime SDK](create-kvs-pool.md)
+ [Contoh kode untuk kumpulan Kinesis Video Streams untuk saluran aliran media Amazon Chime SDK](pool-creation-code.md)
+ [Membuat saluran pipa aliran media Amazon Chime SDK](create-stream-pipeline.md)
+ [Contoh kode untuk saluran pipa aliran media Amazon Chime SDK](pipeline-creation-code.md)
+ [Menggunakan notifikasi Event Bridge untuk pipeline aliran media Amazon Chime SDK](media-stream-event-bridge.md)
+ [Menggunakan data jalur pipa aliran media Amazon Chime SDK](media-stream-tips-tricks.md)

# Membuat kumpulan Kinesis Video Streams untuk saluran aliran media Amazon Chime SDK
<a name="create-kvs-pool"></a>

Kumpulan Kinesis Video Streams (KVS) untuk pipeline aliran media Anda harus memiliki akun yang sama dengan rapat Amazon Chime SDK. AWS Anda membuat kumpulan Kinesis Video Streams dengan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html)memanggil API.

Diagram berikut menunjukkan arsitektur saluran media Kinesis Video Streams pool. Angka dalam gambar sesuai dengan teks bernomor di bawah ini:

![\[Diagram yang menampilkan panggilan API yang membuat kumpulan Kinesis Video Streams.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/media-stream-pool-architecture.png)


Dalam diagram:

1. Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html)API.

1. Bidang kontrol pipa media membuat dan mengelola Kinesis Video Streams (KVS) dan kumpulan atas nama Anda di akun Anda.

Operasi kolam KVS, proses pembuatan, pembaruan, dan penghapusan aliran di kolam, tidak sinkron. Akibatnya, notifikasi Event Bridge menggunakan tipe `Chime Media Pipeline Kinesis Video Pool State Change` detail untuk mengkomunikasikan status aliran di kolam.

Anda dapat membuat kumpulan sekali dan menggunakannya kembali di berbagai rapat. Anda juga dapat membuat pool yang berbeda sesuai kebutuhan, dan menghapus pool saat Anda tidak membutuhkannya.

Pools ditingkatkan secara otomatis, berdasarkan burst panggilan bersamaan Anda. Anda dapat menghapus kolam yang tidak dibutuhkan.

**catatan**  
Saat Anda menghapus kolam, Anda harus menunggu pool dihapus sepenuhnya sebelum menghapus aliran KVS di kolam. Pemberitahuan Event Bridge akan menunjukkan kapan pool telah dihapus sepenuhnya. Itu terjadi setelah semua pertemuan yang menggunakan kolam renang telah berakhir. Anda juga dapat memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipelineKinesisVideoStreamPool.html)API untuk melihat kumpulan KVS tertentu. `PoolId`  
Saat Anda menjalankan API Kinesis Video [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html)Streams, Anda dapat menggunakan string penamaan tersebut untuk mencari dan menghapus aliran dalam kumpulan. Anda juga dapat memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipelineKinesisVideoStreamPool.html)API untuk melihat kumpulan KVS tertentu. `PoolId` Contoh di bagian selanjutnya menjelaskan caranya.

# Contoh kode untuk kumpulan Kinesis Video Streams untuk saluran aliran media Amazon Chime SDK
<a name="pool-creation-code"></a>

Contoh berikut menunjukkan cara membuat, memperbarui, mendapatkan, membuat daftar, dan menghapus kumpulan Kinesis Video Streams (KVS). Perluas setiap bagian untuk mempelajari lebih lanjut.

## Impor dan variabel umum
<a name="imports-variables"></a>

```
'''
Define imports and common variables
'''

import boto3
from uuid import uuid4
import json

client = boto3.client("chime-sdk-media-pipelines", region_name='us-east-1')
pool_name = 'MyDemoKvsPool'

def pretty_print_json(obj):
    print(json.dumps(obj, default=str, indent=4))
```

## CreateMediaPipelineKinesisVideoStreamPool
<a name="create-stream-sample"></a>

```
response = client.create_media_pipeline_kinesis_video_stream_pool(
        StreamConfiguration={
            'Region': 'us-east-1',
            'DataRetentionInHours': 24
        },
        PoolName=pool_name,
        ClientRequestToken=str(uuid4()),
        Tags=[
            {
                'Key': 'MyTagForAccessControl',
                'Value': 'SomeTagValue'
            },
        ]
)

pretty_print_json(response['KinesisVideoStreamPoolConfiguration'])
```

**Output:**

```
{
    "PoolArn": "arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/MyDemoKvsPool",
    "PoolName": "MyDemoKvsPool",
    "PoolId": "ChimeMediaPipelines-MyDemoKvsPool-1f4e1a69-e718-4884-bf92-8a393ac0405b",
    "PoolStatus": "CREATING",
    "StreamConfiguration": {
        "Region": "us-east-1",
        "DataRetentionInHours": 24
    },
    "CreatedTimestamp": "2023-10-13 01:26:09.979000+00:00",
    "UpdatedTimestamp": "2023-10-13 01:26:09.979000+00:00"
}
```

## GetMediaPipelineKinesisVideoStream
<a name="get-stream-sample"></a>

```
response = client.get_media_pipeline_kinesis_video_stream_pool(
        Identifier=pool_name
)

pretty_print_json(response['KinesisVideoStreamPoolConfiguration'])
```

**Output:**

```
{
    "PoolArn": "arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/MyDemoKvsPool",
    "PoolName": "MyDemoKvsPool",
    "PoolId": "ChimeMediaPipelines-MyDemoKvsPool-1f4e1a69-e718-4884-bf92-8a393ac0405b",
    "PoolStatus": "ACTIVE",
    "StreamConfiguration": {
        "Region": "us-east-1",
        "DataRetentionInHours": 24
    },
    "CreatedTimestamp": "2023-10-13 01:26:09.979000+00:00",
    "UpdatedTimestamp": "2023-10-13 01:26:09.979000+00:00"
}
```

## UpdateMediaPipelineKinesisVideoStream
<a name="update-stream-sample"></a>

```
response = client.update_media_pipeline_kinesis_video_stream_pool(
    Identifier=pool_name,
    StreamConfiguration={
        'DataRetentionInHours': 48
    }
)
pretty_print_json(response['KinesisVideoStreamPoolConfiguration'])
```

**Output:**

```
{
    "PoolArn": "arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/MyDemoKvsPool",
    "PoolName": "MyDemoKvsPool",
    "PoolId": "ChimeMediaPipelines-MyDemoKvsPool-d08c26ae-0336-4e2e-acdf-805a7d71b891",
    "PoolStatus": "UPDATING",
    "PoolSize": 40,
    "StreamConfiguration": {
        "Region": "us-east-1",
        "DataRetentionInHours": 48
    },
    "CreatedTimestamp": "2023-10-13 01:44:23.010000+00:00",
    "UpdatedTimestamp": "2023-10-13 01:44:28.486000+00:00"
}
```

## ListMediaPipelineKinesisVideoStream
<a name="list-stream-sample"></a>

```
list_of_pools = []
max_results = 100
next_token = None
while(True):
    if next_token:
        response = client.list_media_pipeline_kinesis_video_stream_pools(
            NextToken=next_token,
            MaxResults=max_results
        )
    else:
        response = client.list_media_pipeline_kinesis_video_stream_pools(
            MaxResults=max_results
        )

    list_of_pools.extend(response['KinesisVideoStreamPools'])
    next_token = response.get('NextToken')
    if not next_token:
        break
pretty_print_json(list_of_pools)
```

**Output:**

```
[
    {
        "PoolName": "MyDemoKvsPool",
        "PoolId": "ChimeMediaPipelines-MyDemoKvsPool-6588e703-f046-4288-ba7f-0c03de76a6bb",
        "PoolArn": "arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/MyDemoKvsPool"
    }
]
```

## DeleteMediaPipelineKinesisVideoStream
<a name="delete-stream-sample"></a>

```
client.delete_media_pipeline_kinesis_video_stream_pool(
    Identifier=pool_name
)
```

**Keluaran**: `delete_media_pipeline_kinesis_video_stream_pool` Permintaan yang berhasil tidak memiliki badan.

# Membuat saluran pipa aliran media Amazon Chime SDK
<a name="create-stream-pipeline"></a>

Pipeline aliran media chime harus memiliki AWS akun yang sama dengan rapat Amazon Chime SDK. Anda membuat pipeline aliran media Amazon Chime SDK dengan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API dan menentukan sumber dan sink.

Diagram berikut menunjukkan arsitektur saluran aliran media Amazon Chime SDK. Angka dalam diagram sesuai dengan teks bernomor di bawah ini.

![\[Diagram yang menampilkan panggilan API yang membuat kumpulan aliran media.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/media-stream-pipe-architecture.png)


Dalam diagram:

1. Anda memanggil `CreateMediaStreamPipeline` API. Dalam permintaan, tentukan sumber dan sink untuk stream. apakah Anda ingin menangkap audio individual, audio campuran, atau keduanya. Sertakan ARN kolam KVS Anda dalam permintaan.
   + Array sumber terdiri dari `SourceType` dan`SourceArn`. Anda harus menggunakan`ChimeSdkMeeting SourceType`. `SourceArn`Itu adalah ARN dari. `ChimeSdkMeeting`
   + Array sink terdiri dari`SinkType`,, `SinkArn``ReservedStreamCapacity`, dan`MediaStreamType`. Kami hanya mendukung`KinesisVideoStreamPoolSinkType`. `SinkArn`Itu adalah ARN dari. `KinesisVideoStreamPool` `MediaStreamType`Kontrol jenis media yang dialirkan ke wastafel, baik `MixedAudio` atau`IndividualAudio`. `ReservedStreamCapacity`menetapkan jumlah aliran yang dialokasikan untuk `MediaStreamType` dari. `KinesisVideoStreamPool`
     + Jika Anda ingin melakukan streaming keduanya `IndividualAudio` dan`MixedAudio`, buat dua objek sink dalam `Sinks` array, satu untuk`IndividualAudio`, yang lain untuk`MixedAudio`. `SinkArn`(ARN dari`KinesisVideoStreamPool`) dapat bervariasi untuk setiap wastafel.
     + Untuk melakukan streaming hanya audio individual atau audio campuran, buat satu objek wastafel dengan yang diinginkan`MediaStreamType`.
   + Perhatikan hal-hal berikut:
     + Saat menjalankan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API dengan `KinesisVideoStreamPool` as the`SinkType`, `SinkARN` harus milik wilayah bidang kontrol tempat `CreateMediaStreamPipeline` dipanggil.

       Misalnya, jika Anda membuat pipeline aliran media di`us-east-1`, Anda harus menggunakan `KinesisVideoStreamPool` in`us-east-1`.
     + `ReservedStreamCapacity`harus **1** ketika Anda menentukan `MixedAudio``MediaStreamType`, dan antara **1-10** saat Anda menentukan `IndividualAudio``MediaStreamType`.

1. Bidang data pipeline media memanggil KVS [ PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)API untuk menyimpan audio individual dalam aliran KVS yang termasuk dalam kumpulan KVS yang Anda tentukan.

1. Bidang data pipeline media memanggil KVS `PutMedia` API untuk menyimpan audio campuran dalam aliran milik kumpulan KVS yang Anda tentukan.

**catatan**  
Setelah memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API, builder dapat menggunakan [peristiwa pipeline media](media-pipe-events.md) atau memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html)API untuk menentukan apakah status pipeline tersebut`InProgress`.  
Setelah status pipa mencapai`InProgress`, media—kombinasi apa pun dari `IndividualAudio` `MixedAudio` dan—mengalir ke KVS.   
Untuk jenis `IndividualAudio` aliran, pemetaan 1:1 ada antara peserta IDs dan aliran KVS yang dialokasikan dari. `KinesisVideoStreamPool` Pemetaan berlaku untuk masa pakai pipa media.  
Untuk mengetahui aliran KVS mana yang memetakan ke ID peserta, atau ditetapkan MixedAudio, gunakan salah satu teknik berikut:  
Gunakan [Pemberitahuan Jembatan Acara](media-stream-event-bridge.md). Setiap pemberitahuan memberikan informasi seperti peserta IDs dan ARN KVS yang mengalirkan audio peserta. Saat sesi `MixedAudio` streaming `IndividualAudio` atau streaming dimulai, kami mengirim `chime:MediaPipelineKinesisVideoStreamStart` acara. Sesi streaming berakhir saat peserta meninggalkan panggilan (untuk`IndividualAudio`), atau saat rapat berakhir.
Gunakan metadata persisten yang dikirim oleh Kinesis Video Streams dengan setiap fragmen. Metadata berisi informasi yang mirip dengan apa yang dikirim Event Bridge. Builder perlu mengurai semua aliran `KinesisVideoStreamPool` dengan menentukan nama pool sebagai awalan di Kinesis Video [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html)Streams API menggunakan solusi ini.
Pengakhiran pipeline Media Stream terjadi saat rapat dihapus, atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html)API dipanggil untuk pipeline aliran media tersebut. [Pemberitahuan Event Bridge](media-pipe-events.md) juga dikirim untuk menunjukkan penghentian pipa media.

# Contoh kode untuk saluran pipa aliran media Amazon Chime SDK
<a name="pipeline-creation-code"></a>

Contoh berikut menunjukkan cara membuat pipeline aliran media untuk audio campuran, audio individual, dan keduanya. Perluas setiap bagian untuk mempelajari lebih lanjut.

## CreateMediaStreamPipelineuntuk audio campuran
<a name="create-mixed-sample"></a>

```
response = client.create_media_stream_pipeline(
    Sources=[
        {
            'SourceType': 'ChimeSdkMeeting',
            'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
        },
    ],
    Sinks=[
        {
            'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
            'SinkType': 'KinesisVideoStreamPool',
            'ReservedStreamCapacity': 1,
            'MediaStreamType': 'MixedAudio'
        },
    ],
    ClientRequestToken='sample token',
    Tags=[
        {
            'Key': 'sample key',
            'Value': 'sample value'
        },
    ]
)
```

**Tanggapan**:

```
{
    'MediaStreamPipeline': {
        'MediaPipelineId': '45bc79a0-4591-4ebe-a642-d42c4e279f2d',
        'MediaPipelineArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline/45bc79a0-4591-4ebe-a642-d42c4e279f2d',
        'CreatedTimestamp': '2023-07-25T21:48:48.265Z',
        'UpdatedTimestamp': '2023-07-25T21:48:48.376Z',
        'Status': 'Initializing',
        'Sources': [
            {
                'SourceType': 'ChimeSdkMeeting',
                'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
            },
        ],
        'Sinks': [
            {
                'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
                'SinkType': 'KinesisVideoStreamPool',
                'ReservedStreamCapacity': 1,
                'MediaStreamType': 'MixedAudio'
            },
        ]
    }
}
```

## CreateMediaStreamPipelineuntuk audio individu
<a name="create-individual-sample"></a>

```
response = client.create_media_stream_pipeline(
    Sources=[
        {
            'SourceType': 'ChimeSdkMeeting',
            'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
        },
    ],
    Sinks=[
        {
            'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
            'SinkType': 'KinesisVideoStreamPool',
            'ReservedStreamCapacity': 5,
            'MediaStreamType': 'IndividualAudio'
        },
    ],
    ClientRequestToken='sample token',
    Tags=[
        {
            'Key': 'sample key',
            'Value': 'sample value'
        },
    ]
)
```

**Tanggapan**:

```
{
    'MediaStreamPipeline': {
        'MediaPipelineId': '45bc79a0-4591-4ebe-a642-d42c4e279f2d',
        'MediaPipelineArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline/45bc79a0-4591-4ebe-a642-d42c4e279f2d',
        'CreatedTimestamp': '2023-07-25T21:48:48.265Z',
        'UpdatedTimestamp': '2023-07-25T21:48:48.376Z',
        'Status': 'Initializing',
        'Sources': [
            {
                'SourceType': 'ChimeSdkMeeting',
                'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
            },
        ],
        'Sinks': [
            {
                'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
                'SinkType': 'KinesisVideoStreamPool',
                'ReservedStreamCapacity': 5,
                'MediaStreamType': 'IndividualAudio'
            },
        ]
    }
}
```

## CreateMediaStreamPipelineuntuk audio campuran dan individual
<a name="create-both-sample"></a>

```
response = client.create_media_stream_pipeline(
    Sources=[
        {
            'SourceType': 'ChimeSdkMeeting',
            'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
        },
    ],
    Sinks=[
        {
            'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
            'SinkType': 'KinesisVideoStreamPool',
            'ReservedStreamCapacity': 1,
            'MediaStreamType': 'MixedAudio'
        },
        {
            'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
            'SinkType': 'KinesisVideoStreamPool',
            'ReservedStreamCapacity': 5,
            'MediaStreamType': 'IndividualAudio'
        },
    ],
    ClientRequestToken='sample token',
    Tags=[
        {
            'Key': 'sample key',
            'Value': 'sample value'
        },
    ]
)
```

**Tanggapan**:

```
{
    'MediaStreamPipeline': {
        'MediaPipelineId': '45bc79a0-4591-4ebe-a642-d42c4e279f2d',
        'MediaPipelineArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline/45bc79a0-4591-4ebe-a642-d42c4e279f2d',
        'CreatedTimestamp': '2023-07-25T21:48:48.265Z',
        'UpdatedTimestamp': '2023-07-25T21:48:48.376Z',
        'Status': 'Initializing',
        'Sources': [
            {
                'SourceType': 'ChimeSdkMeeting',
                'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
            },
        ],
        'Sinks': [
            {
                'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
                'SinkType': 'KinesisVideoStreamPool',
                'ReservedStreamCapacity': 1,
                'MediaStreamType': 'MixedAudio'
            },
            {
                'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
                'SinkType': 'KinesisVideoStreamPool',
                'ReservedStreamCapacity': 5,
                'MediaStreamType': 'IndividualAudio'
            },
        ]
    }
}
```

# Menggunakan notifikasi Event Bridge untuk pipeline aliran media Amazon Chime SDK
<a name="media-stream-event-bridge"></a>

Selain itu[Menggunakan acara pipeline media Amazon Chime SDK](media-pipe-events.md), saluran aliran media mengirim pemberitahuan Event Bridge ketika mereka memulai dan menghentikan streaming ke KVS, dan ketika status kumpulan video berubah.

**Topics**
+ [Memahami peristiwa saluran aliran media Amazon Chime SDK](stream-pipe-events.md)
+ [Memahami acara kumpulan Kinesis Video Streams untuk saluran aliran media Amazon Chime SDK](media-stream-pool-events.md)

# Memahami peristiwa saluran aliran media Amazon Chime SDK
<a name="stream-pipe-events"></a>

Saluran pipa aliran media mengirim peristiwa berikut. Perluas setiap bagian untuk mempelajari lebih lanjut.

## Aliran Video Kinesis Saluran Pipa Amazon Chime Media Stream Mulai
<a name="stream-pipe-kvs-start"></a>

Pipeline media Amazon Chime SDK mengirimkan peristiwa ini saat pipeline aliran media mulai menerima audio dari rapat dan mengalirkan audio tersebut ke KVS. Kosong `AttendeeId` dan `ExternalUserId` bidang menunjukkan bahwa pipa media mengirim audio campuran ke aliran KVS.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "eventType": "chime:MediaPipelineKinesisVideoStreamStart", 
        "timestamp": 1627503649251, 
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706", 
        "externalMeetingId": "Meeting_Id", 
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491", 
        "mediaRegion": "ap-southeast-1",
        
        "attendeeId": "Attendee_Id", 
        "externalUserId": "External_User_Id",
                
        "kinesisVideoStreamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/Chime*",
        "startFragmentNumber": "1234567899444",
        "startTime": "yyyy-mm-ddThh:mm:ssZ"
                
    }
}
```

## Akhir Aliran Video Kinesis Pipa Aliran Media Amazon Chime
<a name="stream-pipe-kvs-stop"></a>

Pipeline media mengirimkan acara ini ke Event Bridge saat streaming ke KVS berakhir.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "eventType": "chime:MediaPipelineKinesisVideoStreamEnd", 
        "timestamp": 1627503649251, 
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706", 
        "externalMeetingId": "Meeting_Id", 
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491", 
        "mediaRegion": "ap-southeast-1",
        
        "attendeeId": "Attendee_Id", 
        "externalUserId": "External_User_Id",
                
        "kinesisVideoStreamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/Chime*",
        "startFragmentNumber": "1234567899444",
        "startTime": "yyyy-mm-ddThh:mm:ssZ",
        "endTime": "yyyy-mm-ddThh:mm:ssZ",
        "endFragmentNumber": "1234567899555"
    }
}
```

# Memahami acara kumpulan Kinesis Video Streams untuk saluran aliran media Amazon Chime SDK
<a name="media-stream-pool-events"></a>

Pipa media mengirim peristiwa berikut ke Event Bridge ketika status kolam berubah. Perluas setiap bagian untuk mempelajari lebih lanjut.

## Kolam Video Kinesis Pipa Media Amazon Chime Aktif
<a name="kvs-pool-active"></a>

Pipeline media mengirimkan acara ini dikirim setelah [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html)API membuat pool.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline Kinesis Video Pool State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "eventType": "chime:MediaPipelineKinesisVideoStreamPoolActive", 
        "timestamp": 1627503649251,
        "mediaRegion": "ap-southeast-1",
        "poolArn" : "ARN of the KVS Pool"
    }
}
```

## Kolam Video Kinesis Pipa Media Lonceng Amazon Diperbarui
<a name="kvs-pool-updated"></a>

Pipeline media mengirimkan acara ini setelah [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaPipelineKinesisVideoStreamPool.html)API memperbarui kumpulan.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline Kinesis Video Pool State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "eventType": "chime:MediaPipelineKinesisVideoStreamPoolUpdated", 
        "timestamp": 1627503649251,
        "mediaRegion": "ap-southeast-1",
        "poolArn" : "ARN of the KVS Pool"
    }
}
```

## Kolam Video Kinesis Pipa Media Amazon Chime Dihapus
<a name="kvs-pool-deleted"></a>

Pipeline media mengirimkan acara ini ke Event Bridge saat [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipelineKinesisVideoStreamPool.html)menghapus pool.

Untuk informasi selengkapnya tentang menghapus pool, lihat[Membuat kumpulan Kinesis Video Streams untuk saluran aliran media Amazon Chime SDK](create-kvs-pool.md), di bagian ini.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline Kinesis Video Pool State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "eventType": "chime:MediaPipelineKinesisVideoStreamPoolDeleted", 
        "timestamp": 1627503649251,
        "mediaRegion": "ap-southeast-1",
        "poolArn" : "ARN of the KVS Pool"
    }
 }
```

## Kegagalan Sementara Kolam Video Kinesis Pipa Media Amazon Chime
<a name="kvs-pool-temp-failure"></a>

Pipeline media mengirimkan peristiwa berikut ke Event Bridge ketika kumpulan video gagal sementara.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline Kinesis Video Pool State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "eventType": "chime:MediaPipelineKinesisVideoStreamPoolTemporaryFailure", 
        "timestamp": 1627503649251,
        "mediaRegion": "ap-southeast-1",
        "poolArn" : "ARN of the KVS Pool"
    }
 }
```

## Kegagalan Permanen Kumpulan Video Kinesis Pipa Media Amazon Chime
<a name="kvs-pool-perm-failure"></a>

Pipeline media mengirimkan peristiwa berikut ke Event Bridge ketika kumpulan video gagal secara permanen.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline Kinesis Video Pool State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "eventType": "chime:MediaPipelineKinesisVideoStreamPoolPermanentFailure", 
        "timestamp": 1627503649251,
        "mediaRegion": "ap-southeast-1",
        "poolArn" : "ARN of the KVS Pool"
    }
}
```

Anda akan menerima peristiwa pipeline media tambahan berikut jika akun AWS Anda telah melampaui batas aliran video Amazon Kinesis.

```
{
    "version": "0",
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
    "detail-type": "Chime Media Pipeline Kinesis Video Pool State Change",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "2021-07-28T20:20:49Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "eventType": "chime:MediaPipelineKinesisVideoStreamPoolStreamLimitExceeded",
        "timestamp": 1627503649251,
        "mediaRegion": "ap-southeast-1",
        "poolArn" : "ARN of the KVS Pool"
    }
}
```

# Menggunakan data jalur pipa aliran media Amazon Chime SDK
<a name="media-stream-tips-tricks"></a>

Anda dapat menggunakan metadata dalam notifikasi untuk mendapatkan KVS ARNs, nomor fragmen, dan stempel waktu fragmen. Informasi itu dapat membantu Anda memproses data audio dalam aliran KVS.

Selain itu, Anda dapat menggunakan KVS ARNs dengan KVS APIs untuk membaca data dari aliran. Tergantung pada kasus penggunaan, Anda memanggil [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html)dan [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_GetMediaForFragmentList.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_GetMediaForFragmentList.html) APIs. Biasanya, `GetMediaForFragmentList` panggilan didahului oleh panggilan ke API. [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_ListFragments.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_ListFragments.html) Untuk informasi selengkapnya, lihat [Membaca data dari aliran](https://aws.amazon.com/kinesis/video-streams/faqs/), di *Amazon Kinesis Video* Streams. FAQs

Bergantung pada kasus penggunaan, builder dapat menggunakan pustaka parser Kinesis Video Streams, yang pada gilirannya menggunakan API KVS. [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html)

Pipeline aliran media menambahkan metadata pertemuan dan peserta berikut ke setiap fragmen.

```
"meetingId"
"externalMeetingId"
"attendeeId"
"externalUserId"
"sampleRate"
"channels"
```

Data media disimpan dalam format MKV. Semua data audio MKV dikodekan AAC. Untuk informasi selengkapnya, lihat model data [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-data.html), *di Panduan Pengembang Kinesis Video Streams*.

# Mengomposisikan audio dan video ke dalam satu tampilan dalam rapat Amazon Chime SDK
<a name="pipeline-compositing"></a>

Pipeline media Amazon Chime SDK mendukung pengomposisian audio, video webcam, dan streaming video berbagi konten ke dalam satu tampilan. Anda kemudian dapat menggunakan konektor langsung untuk mengirim tampilan tunggal itu ke layanan streaming seperti Amazon Interactive Video Service, Twitch, atau YouTube Live. Video komposit juga dapat direkam ke Amazon Simple Storage Service untuk penyimpanan atau konsumsi lebih lanjut.

Pengomposisian menggunakan tata letak layar default yang disebut`GridView`, yang memiliki perilaku berikut. 
+ Jika hanya video webcam yang aktif, `GridView` atur aliran dalam pola kisi berikut:  
![\[Kisi empat kolom, empat baris yang menunjukkan garis besar orang.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/grid-no-content-share.png)

  Grid menampilkan maksimum 25 aliran webcam, dan memesan ubin saat pengguna menyalakan kamera mereka.
+ `GridView`menyediakan dua orientasi kanvas, `Landscape` dan`Portrait`. Landscape, orientasi default, mendukung resolusi video 1280x720 dan 1920x1080 untuk FHD. Potret mendukung resolusi 720x1280 dan 1080x1920 untuk FHD.
+ Anda dapat mengonfigurasi urutan, posisi, jumlah total, rasio aspek ubin, radius sudut, warna batas, ketebalan batas, dan warna sorotan ubin video.
+ Selama rapat, ketika seseorang membagikan layarnya, ubin video webcam bertransisi secara dinamis untuk memberi ruang bagi pembagian konten. Anda mengontrol transisi tersebut, dan lokasi ubin video, dengan menggunakan salah satu konfigurasi tata letak yang dijelaskan di bagian berikutnya.

**Tentang konfigurasi tata letak**  
Ketika seseorang memulai berbagi konten, Anda dapat memilih cara menggabungkan pembagian konten dan aliran video webcam dengan menggunakan salah satu konfigurasi tata letak berikut.
+ `ActiveSpeakerOnlyConfiguration`komposit video konten layar penuh, dengan video webcam speaker aktif yang dilapis di sudut. Anda dapat menentukan sudut.
+ `PresenterOnlyConfiguration`komposit video konten layar penuh, dengan video webcam presenter dilapis di sudut. Anda dapat menentukan sudut.
+ `VerticalLayoutConfiguration`komposit video konten dengan video webcam di kolom vertikal yang berdekatan. Anda dapat menampilkan kolom di sebelah kanan atau kiri berbagi konten.
+ `HorizontalLayoutConfiguration`komposit video konten dengan video webcam dalam baris horizontal yang berdekatan. Anda dapat menampilkan baris di atas atau di bawah pembagian konten.

Tata letak yang dikomposisikan secara otomatis bertransisi antara `GridView` dan tata letak yang Anda pilih, berdasarkan apakah pembagian konten aktif atau tidak.

Topik berikut menjelaskan cara menggunakan `GridView` pengaturan global dan setiap tata letak konfigurasi.

**Topics**
+ [Menyetel orientasi kanvas untuk pengomposisian dalam rapat Amazon Chime SDK](canvas-orientation.md)
+ [Menyetel atribut batas dan sudut untuk pengomposisian dalam rapat Amazon Chime SDK](video-attribute.md)
+ [Menggunakan konfigurasi tata letak untuk pengomposisian dalam rapat Amazon Chime SDK](compositing-layouts.md)

# Menyetel orientasi kanvas untuk pengomposisian dalam rapat Amazon Chime SDK
<a name="canvas-orientation"></a>

Dalam pengomposisian, *kanvas* berisi semua aliran video Anda. Anda dapat menentukan `Landscape` atau `Portrait` orientasi untuk kanvas. Lanskap memberikan rasio aspek 16:9. Potret memberikan rasio aspek 9:16.

Gambar berikut menunjukkan orientasi potret.

![\[Gambar yang menunjukkan dua ubin video di jendela potret (vertikal).\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/compositing-portrait-with-tile.png)


Contoh berikut menunjukkan bagaimana menerapkan kanvas potret dengan ubin video di sudut kanan atas. Dalam contoh ini, speaker aktif muncul di ubin. Untuk informasi selengkapnya, lihat [ActiveSpeakerOnlyConfiguration](compositing-layouts.md#active-speaker-only)

```
{
   "CompositedVideo":{
      "Layout":"GridView",
      "Resolution":"FHD",
      "GridViewConfiguration":{
         "ContentShareLayout":"ActiveSpeakerOnly",
         "ActiveSpeakerOnlyConfiguration":{
            "ActiveSpeakerPosition":"TopRight"
         }
      },
      "CanvasOrientation": "Portrait"       
   }
}
```

Gambar berikut menunjukkan orientasi lanskap.

![\[Gambar yang menunjukkan dua ubin video di jendela lanskap (horizontal).\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/compositing-landscape-with-tile.png)


**CanvasOrientation**  
*Deskripsi* — Pengaturan orientasi, Lanskap atau Potret.  
*Nilai yang diizinkan* - `Landscape` \$1 `Portrait`  
*Diperlukan* - Tidak  
*Default* — Lanskap

# Menyetel atribut batas dan sudut untuk pengomposisian dalam rapat Amazon Chime SDK
<a name="video-attribute"></a>

Seperti yang diinginkan, Anda dapat menggunakan `VideoAttribute` parameter untuk menentukan pengaturan perbatasan dan sudut untuk ubin video Anda. Anda dapat menentukan warna, lebar, dan sudut membulat. Anda juga dapat menentukan warna sorotan, dan batas berubah menjadi warna itu ketika seseorang berbicara. 

Pengaturan atribut Anda berlaku untuk semua tata letak, terlepas dari berbagi konten.

Gambar berikut menunjukkan ubin video dengan warna perbatasan dan radius sudut diterapkan.

![\[Gambar berbagi layar dan ubin video dengan batas merah dan sudut membulat.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/compositing-speaker-border.png)


Contoh berikut menunjukkan bagaimana menggunakan setiap atribut. Dalam hal ini, ubin video memiliki sudut membulat dengan radius lima piksel. Ubin memiliki batas hijau, juga lebar lima piksel. Saat pembicara berbicara, `HighlightColor` atribut mengubah warna batas menjadi merah.

```
{
   "CompositedVideo":{
      "Layout":"GridView",
      "Resolution":"FHD",
      "GridViewConfiguration":{
         "ContentShareLayout":"ActiveSpeakerOnly",
         "ActiveSpeakerOnlyConfiguration":{
            "ActiveSpeakerPosition":"TopRight"
         }
         "VideoAttribute": {
            "CornerRadius"   : 10,                               
            "BorderColor"    : "Green", 
            "HighlightColor" : "Red",  
            "BorderThickness": 5 
          },      
       }
   }
}
```

**VideoAttribute**  
*Deskripsi* - Menentukan pengaturan untuk perbatasan ubin video dan sudut membulat  
*Nilai yang diizinkan* - `BorderColor` \$1 `BorderThickness` \$1 `CornerRadius` \$1 `HighlightColor`  
*Diperlukan* - Tidak

**VideoAttribute.BorderColor**  
*Deskripsi* - Mendefinisikan warna perbatasan untuk semua ubin video  
*Nilai yang diizinkan* - Nama warna, seperti Merah, Hijau, atau Biru  
*Diperlukan* - Tidak

**VideoAttribute.BorderThickness**  
*Deskripsi* - Mendefinisikan ketebalan batas dalam piksel untuk semua ubin video  
*Jenis* - Integer  
*Nilai yang diizinkan* - 1—20  
*Diperlukan* - Tidak

**VideoAttribute.CornerRadius**  
*Deskripsi* - Mendefinisikan radius sudut dalam piksel untuk semua ubin video.   
*Jenis* - Integer  
*Nilai yang diizinkan* - 1—20  
*Diperlukan* - Tidak

**VideoAttribute.HighlightColor**  
*Deskripsi* - Mendefinisikan warna batas yang muncul saat presenter atau pembicara berbicara  
*Nilai yang diizinkan* - Nama warna, seperti Merah, Hijau, atau Biru  
*Diperlukan* - Tidak

# Menggunakan konfigurasi tata letak untuk pengomposisian dalam rapat Amazon Chime SDK
<a name="compositing-layouts"></a>

Topik berikut menjelaskan cara menggunakan tata letak konfigurasi yang berbeda. Tata letak hanya berlaku ketika seseorang memulai berbagi konten. Perluas setiap bagian untuk mempelajari lebih lanjut.

## ActiveSpeakerOnlyConfiguration
<a name="active-speaker-only"></a>

`ActiveSpeakerOnlyConfiguration`menampilkan pembagian konten dan video pembicara aktif, artinya orang yang berbicara muncul di ubin video kecil yang melapisi aliran berbagi konten.

Gambar berikut menunjukkan konfigurasi dan lokasi yang tersedia untuk ubin speaker.

![\[Gambar menunjukkan ubin video besar di tengah jendela dan ubin kecil di kiri atas.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/compositing-active-speaker-4x.png)


Contoh berikut menunjukkan bagaimana menerapkan `ActiveSpeakerOnly` tata letak secara terprogram. Dalam hal ini, ubin presenter muncul di sudut kiri atas.

```
{
   "CompositedVideo":{
      "Layout":"GridView",
      "Resolution":"FHD",
      "GridViewConfiguration":{
         "ContentShareLayout":"ActiveSpeakerOnly",
         "ActiveSpeakerOnlyConfiguration":{
            "ActiveSpeakerPosition":"TopLeft"
         }
      }
   }
}
```

**ActiveSpeakerOnlyConfiguration**  
*Deskripsi* - Pengaturan konfigurasi untuk ubin `ActiveSpeakerOnly` video  
*Jenis* - ActiveSpeakerOnlyConfiguration objek  
*Diperlukan* - Tidak

**ActiveSpeakerOnlyConfiguration.ActiveSpeakerPosition**  
*Deskripsi* — Posisi ubin video speaker aktif  
*Jenis* - String  
*Nilai yang valid* - `TopLeft` \$1 `TopRight` \$1 `BottomLeft` \$1 `BottomRight`  
*Diperlukan* - Tidak  
*Default* - `TopRight`

## PresenterOnlyConfiguration
<a name="presenter-only"></a>

`PresenterOnlyConfiguration`menampilkan berbagi konten dan hanya video presenter terlepas dari siapa yang berbicara. Gambar berikut menunjukkan konfigurasi.

![\[Gambar empat layar. Setiap layar memiliki jendela berbagi di tengah dan ubin video di setiap sudut.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/compositing-presenter-only-4x.png)


Contoh berikut menunjukkan bagaimana menerapkan tata letak terprogram dengan presenter di kanan atas.

```
{
    "CompositedVideo": {
    "Layout": "GridView",
    "Resolution": "FHD",
     "GridViewConfiguration": {
         "ContentShareLayout": "PresenterOnly",
         "PresenterOnlyConfiguration": { 
             "PresenterPosition": "TopRight"
             }
         }           
     }
}
```

**PresenterOnlyConfiguration**  
*Deskripsi* - Pengaturan konfigurasi untuk tata `PresenterOnly` letak  
*Jenis* - `PresenterOnlyConfiguration` objek  
*Diperlukan* - Tidak

**PresenterOnlyConfiguration.PresenterPosition**  
*Deskripsi* — Posisi ubin video presenter  
*Jenis* - String  
*Nilai yang valid* - `TopLeft` \$1 `TopRight` \$1 `BottomLeft` \$1 `BottomRight`  
*Diperlukan* - Tidak  
*Default* - `TopRight`

## HorizontalLayoutConfiguration
<a name="horizontal-layout"></a>

`HorizontalLayoutConfiguration`menampilkan berbagi konten dan aliran video secara horizontal. Anda dapat menggunakan `TilePosition` pengaturan untuk menampilkan ubin di atas atau di bawah aliran berbagi konten. Presenter selalu muncul di sebelah kiri. Ubin tambahan muncul dalam urutan yang ditentukan oleh`JoinSequence`. 

Gambar berikut menunjukkan ubin di bawah aliran berbagi konten.

![\[Gambar menunjukkan ubin tengah besar dan 4 ubin kecil dalam garis di bawah.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/compositing-horizontal-bottom.png)


Contoh berikut menunjukkan bagaimana menerapkan tata letak horizontal secara terprogram. Dalam hal ini, tata letak memesan ubin `SpeakerSequence` dan menempatkannya di bawah pangsa layar. Tata letak memungkinkan maksimal empat ubin dan menerapkan rasio aspek 16/9.

```
{
   "CompositedVideo":{
      "Layout":"GridView",
      "Resolution":"FHD",
      "GridViewConfiguration":{
         "ContentShareLayout":"Horizontal",
         "HorizontalLayoutConfiguration":{
            "TileOrder":"SpeakerSequence",
            "TilePosition":"Bottom",
            "TileCount":4,
            "TileAspectRatio":"16/9"
         }
      }
   }
}
```

**HorizontalLayoutConfiguration**  
*Deskripsi* - Pengaturan konfigurasi untuk tata letak horizontal  
*Jenis* - HorizontalLayoutConfiguration objek  
*Diperlukan* - Tidak

**HorizontalLayoutConfiguration.TilePosition**  
*Deskripsi* — Menempatkan ubin di atas atau di bawah pembagian konten.  
*Jenis* - String  
*Nilai yang valid* - `Bottom` \$1 `Top`  
*Diperlukan* - Tidak  
*Default* - Bawah

**HorizontalLayoutConfiguration.TileOrder**  
*Deskripsi* — Memesan ubin berdasarkan saat pengguna bergabung atau saat mereka berbicara  
*Jenis* - String  
*Nilai yang valid* - `JoinSequence` \$1 `SpeakerSequence`  
*Diperlukan* - Tidak  
*Default* - JoinSequence

**HorizontalLayoutConfiguration.TileCount**  
*Deskripsi* - Menentukan jumlah ubin yang tetap terlihat selama berbagi layar  
*Jenis* - Integer  
*Nilai yang valid* - 1—10  
*Diperlukan* - Tidak  
*Default* - 4

**HorizontalLayoutConfiguration.TileAspectRatio**  
*Deskripsi* - Menentukan rasio aspek ubin  
*Jenis* - Integer  
*Nilai yang valid* - *n***/***n*  
*Diperlukan* - Tidak  
*Default* - 16/9, nilai berlaku untuk semua ubin

## VerticalLayoutConfiguration
<a name="vertical-layout"></a>

`VerticalLayoutConfiguration`menampilkan berbagi konten dan empat video terbaru yang ditumpuk di sebelah kanan. Presenter selalu muncul di atas. Peserta lain muncul dalam urutan yang ditentukan oleh. `TileOrder`

![\[Gambar menunjukkan ubin video besar di tengah jendela dan 4 ubin kecil ditumpuk di sebelah kanan.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/grid-vertical.png)


Contoh berikut menunjukkan bagaimana menerapkan tata letak vertikal secara terprogram. Dalam hal ini, tata letak memesan ubin JoinSequence dan menempatkannya di sebelah kanan berbagi layar. Tata letak memungkinkan maksimal empat ubin dan menerapkan rasio aspek 16/9.

```
{
   "CompositedVideo":{
      "Layout": "GridView",
      "Resolution": "FHD",
      "GridViewConfiguration":{
         "ContentShareLayout": "Vertical",
         "VerticalLayoutConfiguration":{
            "TileOrder": "JoinSequence",
            "TilePosition": "Right",
            "TileCount": 4,
            "TileAspectRatio": "16/9"
         }
      }
   }
}
```

**VerticalLayoutConfiguration**  
*Deskripsi* - Pengaturan konfigurasi untuk tata letak vertikal  
*Jenis* - VerticalLayoutConfiguration objek  
*Diperlukan* - Tidak

**VerticalLayoutConfiguration.TilePosition**  
*Deskripsi* — Menempatkan ubin di sebelah kanan atau kiri berbagi konten.  
*Jenis* - String  
*Nilai yang valid* - `Bottom` \$1 `Top`  
*Diperlukan* - Tidak  
*Default* - Bawah

**VerticalLayoutConfiguration.TileOrder**  
*Deskripsi* — Memesan ubin berdasarkan saat pengguna bergabung atau saat mereka berbicara  
*Jenis* - String  
*Nilai yang valid* - `JoinSequence` \$1 `SpeakerSequence`  
*Diperlukan* - Tidak  
*Default* - JoinSequence

**VerticalLayoutConfiguration.TileCount**  
*Deskripsi* - Menentukan jumlah ubin  
*Jenis* - Integer  
*Nilai yang valid* - 1—10  
*Diperlukan* - Tidak  
*Default* - 4

**VerticalLayoutConfiguration.TileAspectRatio**  
*Deskripsi* - Menentukan rasio aspek ubin  
*Jenis* - Integer  
*Nilai yang valid* - *n***/***n*  
*Diperlukan* - Tidak  
*Default* - 9/16, nilai berlaku untuk semua ubin

# Membuat peran terkait layanan untuk pipeline media Amazon Chime SDK
<a name="create-pipeline-role"></a>

Informasi di bagian berikut menjelaskan cara membuat peran terkait layanan yang memberikan akses saluran media ke rapat Amazon Chime SDK Anda.

**Topics**
+ [Mengatur izin peran](#pipeline-role-permissions)
+ [Membuat peran terkait layanan](#create-sl-role)
+ [Mengedit peran terkait layanan](#edit-pipeline-role)
+ [Menghapus peran tertaut layanan](#delete-pipeline-role)
+ [Wilayah yang mendukung peran terkait layanan](#role-supported-regions)

## Mengatur izin peran
<a name="pipeline-role-permissions"></a>

*jaringan pipa media menggunakan peran terkait layanan bernama Pipelines. AWSService RoleForAmazonChime SDKMedia* Peran ini memungkinkan pipeline capture untuk mengakses rapat Amazon Chime SDK dan mempublikasikan metrik ke Amazon CloudWatch atas nama Anda. Peran mempercayai `mediapipelines.chime.amazonaws.com` layanan.

Kebijakan izin peran memungkinkan Amazon Chime SDK menyelesaikan tindakan berikut di semua sumber daya: AWS 
+ Tindakan: `cloudwatch:PutMetricData` pada `all AWS resources`
+ Tindakan: `chime:CreateAttendee` pada `all AWS resources`
+ Tindakan: `chime:DeleteAttendee` pada `all AWS resources`
+ Tindakan: `chime:GetMeeting` pada `all AWS resources`
+ Tindakan: `kinesisvideo:CreateStream` pada `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Tindakan: `kinesisvideo:PutMedia` pada `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Tindakan: `kinesisvideo:UpdateDataRetention` pada `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Tindakan: `kinesisvideo:DescribeStream` pada `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Tindakan: `kinesisvideo:GetDataEndpoint` pada `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Tindakan: `kinesisvideo:ListStreams` pada `arn:aws:kinesisvideo:*:111122223333:stream/*`

Anda harus mengonfigurasi izin untuk mengizinkan entitas IAM, seperti pengguna, grup, atau peran, untuk membuat, mengedit, atau menghapus peran terkait layanan. Untuk informasi selengkapnya tentang izin, lihat [Izin peran terkait layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) di Panduan Pengguna *IAM*. 

## Membuat peran terkait layanan
<a name="create-sl-role"></a>

Anda menggunakan konsol IAM untuk membuat peran terkait layanan untuk digunakan dengan pipeline media Amazon Chime SDK. Anda harus memiliki izin administratif IAM untuk menyelesaikan langkah-langkah ini. Jika tidak, hubungi administrator sistem.

**Untuk membuat peran**

1. Masuk ke AWS Management Console, lalu buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam).

1. Di panel navigasi konsol IAM, pilih **Peran**, dan lalu pilih **Buat peran**.

1. Pilih jenis peran **AWS Service**, lalu pilih **Chime SDK Media** Pipelines.

   Kebijakan IAM muncul.

1. Pilih kotak centang di samping kebijakan, lalu pilih **Berikutnya: Tag**.

1. Pilih **Berikutnya: Tinjauan**.

1. Edit deskripsi sesuai kebutuhan, lalu pilih **Buat peran**.

*Anda juga dapat menggunakan AWS CLI atau AWS API untuk membuat peran terkait layanan bernama mediapipelines.chime.amazonaws.com.* Di AWS CLI, jalankan perintah ini:

```
aws iam create-service-linked-role --aws-service-name mediapipelines.chime.amazonaws.com
```

Untuk informasi selengkapnya tentang membuat peran, lihat [Membuat Peran Tertaut Layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) di Panduan Pengguna *IAM*. Jika Anda menghapus peran ini, Anda dapat menggunakan proses yang sama ini untuk membuatnya lagi.

## Mengedit peran terkait layanan
<a name="edit-pipeline-role"></a>

Anda tidak dapat mengedit peran terkait layanan *AWSServiceRoleForAmazonChimeSDKMediaPipelines*. Setelah membuat peran, Anda tidak dapat mengubah namanya karena entitas lain dapat mereferensikan peran tersebut. Namun, Anda dapat menggunakan IAM untuk mengedit deskripsi peran. Untuk informasi selengkapnya, lihat [Mengedit Peran Tertaut Layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) dalam *Panduan Pengguna IAM*.

## Menghapus peran tertaut layanan
<a name="delete-pipeline-role"></a>

Jika tidak memerlukan peran terkait layanan, sebaiknya Anda menghapusnya. Untuk melakukan itu, pertama-tama Anda menghapus pipeline media yang menggunakan peran tersebut. Anda dapat menggunakan AWS CLI atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html)API untuk menghapus pipeline. 

**Menggunakan CLI untuk menghapus pipeline**  
Gunakan perintah ini di AWS CLI untuk menghapus pipeline media di akun Anda.

```
aws chime-sdk-media-pipelines delete-media-capture-pipeline --media-pipeline-id Pipeline_Id
```

**Menggunakan API untuk menghapus pipeline**  
Gunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html)API untuk menghapus pipeline media di akun Anda.

**Menghapus peran**  
Setelah menghapus pipeline, Anda dapat menggunakan konsol IAM, AWS CLI, atau AWS API untuk menghapus peran. *Untuk informasi selengkapnya tentang menghapus peran, lihat [Menghapus Peran Tertaut Layanan di Panduan Pengguna](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) IAM.*

## Wilayah yang mendukung peran terkait layanan
<a name="role-supported-regions"></a>

Amazon Chime SDK mendukung penggunaan peran terkait layanan di semua AWS Wilayah tempat layanan tersedia. Untuk informasi selengkapnya, lihat [titik akhir Amazon Chime SDK dan](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) kuota di. *Referensi Umum Amazon Web Services*

# Menggunakan acara pipeline media Amazon Chime SDK
<a name="media-pipe-events"></a>

Setiap jenis saluran media mengirimkan peristiwa siklus hidup, yang dapat Anda gunakan untuk memicu notifikasi dan memulai alur kerja hilir. Beberapa contoh penggunaan acara pipa media meliputi:
+ Memproses media yang ditangkap setelah pipa media selesai.
+ Memberi tahu peserta rapat jika saluran media mengalami kegagalan sementara.
+ Menghentikan rapat jika saluran media gagal secara permanen.

Anda dapat mengirim acara ke Amazon EventBridge, Amazon Simple Notification Service (SNS), dan Amazon Simple Queue Service (SQS). Untuk informasi selengkapnya, lihat [Acara dari AWS layanan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) di *Panduan EventBridge Pengguna Amazon*.

## Pipa media Amazon Chime SDK dibuat
<a name="media-pipeline-create"></a>

Amazon Chime SDK mengirimkan peristiwa ini saat pipeline media dibuat.

**Contoh: Data acara**  
 Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline State Change", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "time": "2021-07-28T20:20:49Z", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "version": "0", 
        "eventType": "chime:MediaPipelineInProgress", 
        "timestamp": 1627503649251, 
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706", 
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491", 
        "mediaRegion": "ap-southeast-1"
    }
}
```

## Pipa media Amazon Chime SDK dihapus
<a name="media-pipeline-delete"></a>

Amazon Chime SDK mengirimkan acara ini setelah pipeline media berhenti dengan sukses. 

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0",
    "id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "365135496707",
    "time": "2021-07-28T20:21:50Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineDeleted",
        "timestamp": 1627503710485,
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
        "mediaRegion": "ap-southeast-1"
    }
}
```

## Pipa media Amazon Chime SDK mengalami kegagalan sementara
<a name="pipeline-temp-failure"></a>

Amazon Chime SDK mengirimkan acara ini ketika pipeline media mengalami kegagalan sementara.

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0",
    "id": "abc141e1-fc2e-65e8-5f18-ab5130f1035a",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "365135496707",
    "time": "2021-07-28T21:16:42Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineTemporaryFailure",
        "timestamp": 1627507002882,
        "meetingId": "7a5434e3-724a-4bbb-9eb6-2fb209dc0706",
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "ebd62f4e-04a9-426d-bcb0-974c0f266400",
        "mediaRegion": "eu-south-1"
    }
}
```

## Pipa media Amazon Chime SDK sedang berlangsung
<a name="pipeline-in-progress"></a>

Amazon Chime SDK mengirimkan peristiwa ini saat pipeline media mulai menangkap artefak.

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0",
    "id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "365135496707",
    "time": "2021-07-28T20:21:50Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineInProgress",
        "timestamp": 1627503710485?,
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
        "mediaRegion": "ap-southeast-1"
    }
}
```

## Kegagalan permanen saluran media Amazon Chime SDK
<a name="pipeline-perm-failure"></a>

Amazon Chime SDK mengirimkan peristiwa ini saat pipeline media gagal secara permanen.

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0",
    "id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "365135496707",
    "time": "2021-07-28T20:21:50Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelinePermanentFailure",
        "timestamp": 1627503710485,
        "meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
        "externalMeetingId": "Meeting_Id",
        "mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
        "mediaRegion": "ap-southeast-1"
    }
}
```

# Menyetel izin bucket Amazon S3 untuk saluran media Amazon Chime SDK
<a name="s3-permissions"></a>

Jika Anda belum membuat bucket Amazon S3, pastikan Anda membuatnya di akun dan Wilayah tempat Anda menyelenggarakan rapat. Juga, pastikan Anda memberikan izin yang memadai untuk layanan. Untuk informasi selengkapnya tentang membuat bucket Amazon S3, lihat. [Membuat bucket Amazon S3 untuk pipeline pengambilan media Amazon Chime SDK](create-s3-bucket.md)

# Mengirim acara pipeline media Amazon Chime SDK ke CloudTrail
<a name="pipeline-cloudtrail"></a>

AWS memungkinkan CloudTrail untuk Anda ketika Anda membuat AWS akun Anda. Saat pengguna memanggil API yang didukung di SDK pipeline media, CloudTrail mencatat aktivitas tersebut untuk API tersebut dalam **riwayat Acara**, bersama dengan AWS peristiwa lainnya. Anda dapat melihat, mencari, dan mengunduh peristiwa pipeline media di akun AWS Anda. Untuk informasi selengkapnya, lihat [Melihat CloudTrail Acara dengan Riwayat Acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) di *Panduan CloudTrail Pengguna*.

Untuk catatan acara saluran media yang sedang berlangsung, Anda dapat membuat *jejak*. Jejak memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3 Anda. Contoh berikut menunjukkan jejak pipa media. Data termasuk pengguna yang memanggil API, peran IAM yang digunakan untuk memanggil API, dan stempel waktu. Untuk informasi selengkapnya tentang penggunaan, CloudTrail lihat [Pencatatan dan pemantauan](https://docs.aws.amazon.com/chime-sdk/latest/ag/monitoring-overview.html) di Panduan *Administrator SDK Amazon Chime*.

```
{
   "Records": [    
   {
      "eventVersion": "1.08",
      "userIdentity": {
          "type": "AssumedRole",
          "principalId": "ABCDEFGHIJKLMNOPQRSTUV:user-name",
          "arn": "arn:aws:sts::123456789101:assumed-role/role-name/user-name",
          "accountId": "109876543210",
          "accessKeyId": "ABCDEFGHIJKLMNOPQRSTUV",
          "sessionContext": {
              "sessionIssuer": {
                  "type": "Role",
                  "principalId": "ABCDEFGHIJKLMNOPQRSTUV",
                  "arn": "arn:aws:iam::109876543210:role/role-name",
                  "accountId": "012345678910",
                  "userName": "user-name"
                  },
          "webIdFederationData": {},
          "attributes": {
              "mfaAuthenticated": "false",
              "creationDate": "2022-03-08T19:34:55Z"
              }
          }
      },
      "eventTime": "2022-03-08T20:28:41Z",
     "eventSource": "chime-sdk-media-pipelines.amazonaws.com",
     "eventName": "CreateMediaCapturePipeline",
     "awsRegion": "us-east-1",
     "sourceIPAddress": "127.0.0.1",
     "userAgent": "[]/[]",
     "requestParameters": {
         "sourceType": "ChimeSdkMeeting",
         "sourceArn": "Hidden_For_Security_Reasons",
         "sinkType": "S3Bucket",
         "sinkArn": "Hidden_For_Security_Reasons",
         "chimeSdkMeetingConfiguration": {
             "artifactsConfiguration": {
                 "audio": {
                    "muxType": "AudioOnly"
                 },
            "video": {
                "state": "Enabled",
                "muxType": "VideoOnly"
                },
            "content": {
                "state": "Enabled",
                "muxType": "ContentOnly"
                }
            }
        }
      },
     "responseElements": {
        "mediaCapturePipeline": {
        "mediaPipelineId": "pipeline-uuid",
        "sourceType": "ChimeSdkMeeting",
        "sourceArn": "Hidden_For_Security_Reasons",
        "status": "Initializing",
        "sinkType": "S3Bucket",
        "sinkArn": "Hidden_For_Security_Reasons",
        "createdTimestamp": "2022-03-08T20:28:41.336Z",
        "updatedTimestamp": "2022-03-08T20:28:41.463Z",
        "chimeSdkMeetingConfiguration": {
            "artifactsConfiguration": {
                "audio": {
                    "muxType": "AudioOnly"
                },
            "video": {
                "state": "Enabled",
                 "muxType": "VideoOnly"
                 },
             "content": {
                 "state": "Enabled",
                 "muxType": "ContentOnly"
                 }
              }
            }
          }
      },
      "requestID": "request-id",
      "eventID": "event-id",
     "readOnly": false,
      "eventType": "AwsApiCall",
      "managementEvent": true,
      "eventCategory": "Management",
      "recipientAccountId": "112233445566",
      "tlsDetails": {
          "tlsVersion": "TLSv1.2",
          "clientProvidedHostHeader": "example.com"
       }
    },  
  ]
}
```

# Praktik terbaik untuk menghentikan saluran media Amazon Chime SDK
<a name="stop-pipe-best-practices"></a>

Sebagai praktik terbaik untuk menghentikan saluran pipa media, hubungi [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html)API. API memungkinkan Anda untuk menghapus media capture dan media live connector pipelines. Anda juga dapat memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html)API untuk menghapus pipeline pengambilan media. Semua jaringan pipa media berhenti ketika pertemuan berakhir.

# Menggunakan transkripsi langsung Amazon Chime SDK
<a name="meeting-transcription"></a>

Anda menggunakan transkripsi langsung Amazon Chime SDK untuk menghasilkan transkrip langsung yang dikaitkan dengan pengguna dari rapat Anda. Transkripsi langsung Amazon Chime SDK terintegrasi dengan layanan Amazon Transcribe dan Amazon Transcribe Medical untuk menghasilkan transkrip rapat Amazon Chime SDK saat sedang berlangsung.

Transkripsi langsung Amazon Chime SDK memproses audio setiap pengguna secara terpisah untuk meningkatkan akurasi dalam skenario multi-speaker. Amazon Chime SDK menggunakan algoritme pembicara aktifnya untuk memilih dua pembicara aktif teratas, dan kemudian mengirimkan audio mereka ke Amazon Transcribe, di saluran terpisah, melalui satu aliran. Peserta rapat menerima transkripsi yang dikaitkan dengan pengguna melalui pesan data Amazon Chime SDK. Anda dapat menggunakan transkripsi dengan berbagai cara, seperti menampilkan subtitle, membuat transkrip rapat, atau menggunakan transkripsi untuk analisis konten.

Transkripsi langsung menggunakan satu aliran ke Amazon Transcribe selama transkripsi rapat. Biaya Standard Amazon Transcribe dan Amazon Transcribe Medical berlaku. Untuk informasi selengkapnya, lihat Harga [Amazon Transcribe](https://aws.amazon.com/transcribe/pricing/). Untuk pertanyaan tentang penggunaan atau penagihan, hubungi manajer AWS akun Anda.

**penting**  
[Secara default, Amazon Transcribe dapat menggunakan dan menyimpan konten audio yang diproses oleh layanan untuk mengembangkan dan meningkatkan layanan AWS AI/ML sebagaimana dijelaskan lebih lanjut dalam bagian 50 dari Ketentuan Layanan.AWS](https://aws.amazon.com/service-terms/) Menggunakan Amazon Transcribe dapat tunduk pada undang-undang atau peraturan federal dan negara bagian mengenai pencatatan atau intersepsi komunikasi elektronik. Merupakan tanggung jawab Anda dan pengguna akhir Anda untuk mematuhi semua hukum yang berlaku mengenai rekaman, termasuk memberi tahu semua peserta dengan benar dalam sesi rekaman atau komunikasi bahwa sesi atau komunikasi sedang direkam, dan mendapatkan semua persetujuan yang diperlukan. Anda dapat memilih untuk tidak AWS menggunakan konten audio untuk mengembangkan dan meningkatkan layanan AWS AI/ML dengan mengonfigurasi kebijakan memilih keluar layanan AI menggunakan Organizations. AWS 

**Topics**
+ [Arsitektur sistem](#sys-architecture)
+ [Penagihan dan penggunaan](#billing-and-usage)
+ [Mengonfigurasi akun Anda untuk transkripsi langsung Amazon Chime SDK](configure-transcribe.md)
+ [Memilih opsi transkripsi langsung Amazon Chime SDK](transcription-options.md)
+ [Memulai dan menghentikan transkripsi langsung Amazon Chime SDK](initiate-transcription.md)
+ [Parameter transkripsi langsung Amazon Chime SDK](#transcription-parameters)
+ [Memahami peristiwa transkripsi langsung Amazon Chime SDK](transcription-events.md)
+ [Memahami pesan transkripsi langsung Amazon Chime SDK](process-msgs.md)
+ [Memproses acara transkrip langsung Amazon Chime SDK yang diterima](delivery-examples.md)
+ [Mengurai transkrip Amazon Chime SDK](parse-transcripts.md)

## Arsitektur sistem
<a name="sys-architecture"></a>

Amazon Chime SDK membuat transkripsi rapat real-time, tanpa audio keluar dari AWS jaringan, melalui integrasi sisi layanan dengan akun Amazon Transcribe atau Amazon Transcribe Medical Anda. Untuk meningkatkan akurasi, audio pengguna diproses secara terpisah, kemudian dicampur ke dalam rapat. Amazon Chime SDK menggunakan algoritme pembicara aktifnya untuk memilih dua pembicara aktif teratas, dan kemudian mengirimkan audio mereka ke Amazon Transcribe atau Amazon Transcribe Medical di saluran terpisah melalui satu aliran. Untuk mengurangi latensi, transkripsi yang dikaitkan dengan pengguna dikirim langsung ke setiap peserta rapat melalui pesan data. Saat menggunakan saluran media untuk menangkap audio rapat, informasi transkripsi rapat juga ditangkap.

![\[Diagram yang menunjukkan aliran data transkripsi rapat.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/transcription-architecture.png)


## Penagihan dan penggunaan
<a name="billing-and-usage"></a>

Transkripsi langsung menggunakan satu aliran ke Amazon Transcribe atau Amazon Transcribe Medical selama transkripsi rapat. Biaya Standard Amazon Transcribe dan Amazon Transcribe Medical berlaku. Untuk informasi lebih lanjut, lihat Harga [Amazon Transcribe..](https://aws.amazon.com/transcribe/pricing/) Untuk pertanyaan tentang penggunaan atau penagihan, hubungi manajer AWS akun Anda.

# Mengonfigurasi akun Anda untuk transkripsi langsung Amazon Chime SDK
<a name="configure-transcribe"></a>

Sebelum dapat menggunakan transkripsi langsung Amazon Chime SDK, Anda harus memberikan izin Amazon Chime SDK untuk memanggil Amazon Transcribe dan Amazon Transcribe Medical di akun Anda. AWS Anda melakukannya dengan menambahkan peran terkait layanan Transkripsi Chime ke akun Anda. *Untuk informasi tentang membuat peran terkait layanan untuk transkripsi langsung, lihat [Menggunakan peran dengan transkripsi langsung di Panduan Administrasi SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-transcription.html) Amazon Chime.* Untuk informasi selengkapnya tentang peran terkait layanan IAM, lihat Peran [Tertaut Layanan di Panduan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) Pengguna *IAM*.

# Memilih opsi transkripsi langsung Amazon Chime SDK
<a name="transcription-options"></a>

Saat Anda menggunakan transkripsi langsung Amazon Chime SDK, Anda menggunakan Amazon Transcribe [atau Amazon Transcribe Medical](https://aws.amazon.com/transcribe/) di [akun Anda](https://aws.amazon.com/transcribe/medical/). AWS [Anda memiliki akses ke semua [bahasa streaming yang didukung oleh Amazon Transcribe](https://docs.aws.amazon.com/transcribe/latest/dg/what-is-transcribe.html), ditambah fitur seperti kosakata [khusus dan filter kosakata](https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary.html).](https://docs.aws.amazon.com/transcribe/latest/dg/filter-unwanted-words.html) Saat menggunakan Amazon Transcribe Medical, Anda dapat memilih spesialisasi medis, jenis percakapan, dan secara opsional memberikan kosakata khusus apa pun. Biaya Standard Amazon Transcribe dan Amazon Transcribe Medical berlaku.

Proses memilih opsi transkripsi mengikuti langkah-langkah ini. 

## Langkah 1: Memilih layanan transkripsi
<a name="choose-service"></a>

Anda perlu memutuskan layanan transkripsi mana yang akan digunakan, [Amazon Transcribe atau Amazon](https://aws.amazon.com/transcribe/) [Transcribe Medical](https://aws.amazon.com/transcribe/medical/). 

Jika kasus penggunaan Anda memerlukan kemampuan pidato ke teks medis, Anda mungkin ingin menggunakan Amazon Transcribe Medical. Untuk semua kasus penggunaan lainnya, Anda mungkin ingin menggunakan Amazon Transcribe.

Anda menentukan layanan transkripsi mana yang akan digunakan saat memanggil `StartMeetingTranscription` API:
+ Untuk menggunakan Amazon Transcribe, tentukan dengan`TranscriptionConfiguration`. `EngineTranscribeSettings` 
+ Untuk menggunakan Amazon Transcribe Medical, tentukan dengan`TranscriptionConfiguration`. `EngineTranscribeMedicalSettings`

## Langkah 2: Memilih Wilayah transkripsi
<a name="choose-region"></a>

Anda harus memilih AWS Wilayah untuk layanan transkripsi. [Untuk informasi tentang AWS Wilayah yang tersedia untuk Amazon Transcribe dan Amazon Transcribe Medical, lihat tabel Layanan Regional AWS .](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)

 Secara umum, latensi terendah antara Wilayah media rapat dan Wilayah transkripsi memberikan pengalaman pengguna terbaik. Untuk latensi terendah, gunakan Wilayah yang sama untuk media dan transkripsi bila memungkinkan. Namun, Anda mungkin memiliki faktor lain yang perlu dipertimbangkan dalam memilih Wilayah, seperti persyaratan peraturan atau Wilayah tempat Anda mengonfigurasi Amazon Transcribe atau Amazon Transcribe Medical.

Fitur Amazon Transcribe dan Amazon Transcribe Medical, seperti kosakata khusus atau filter kosakata, adalah spesifik Wilayah. Jika Anda mengonfigurasi salah satu fitur tersebut, Anda harus melakukannya secara identik di semua AWS Wilayah tempat Anda ingin menggunakan transkripsi langsung. Sebagai alternatif, Anda dapat menggunakan Wilayah Amazon Transcribe yang sama untuk semua rapat.

Anda dapat menentukan Wilayah yang digunakan layanan transkripsi. Anda melakukannya dengan menambahkan nama wilayah ke `Region` bidang pengaturan mesin transkripsi saat Anda memanggil `StartMeetingTranscription` API. Jika Anda tidak menentukan Wilayah, Amazon Chime SDK mencoba menggunakan layanan transkripsi di wilayah media rapat. Agar Amazon Chime SDK memilih Wilayah untuk layanan transkripsi untuk Anda, tentukan `auto` di bidang. `Region` Saat Anda melakukannya, Amazon Chime memilih wilayah layanan transkripsi berdasarkan Wilayah media rapat seperti yang dijelaskan dalam tabel di bawah ini. Untuk informasi selengkapnya tentang `StartMeetingTranscription` API, lihat [Memulai dan menghentikan transkripsi langsung Amazon Chime SDK](initiate-transcription.md) di panduan ini.

**catatan**  
Wilayah transkripsi yang dipilih oleh Amazon Chime SDK dapat berubah karena, Amazon Chime SDK, AWS Amazon Transcribe, dan Amazon Transcribe Medical menyediakan lebih banyak wilayah.

**Pemilihan wilayah otomatis untuk Amazon Transcribe**  



|  Wilayah Media Amazon Chime SDK  |  Kode Wilayah  |  Wilayah Transkripsi  | 
| --- | --- | --- | 
|  AS Timur (Ohio)  |  us-east-2  | us-east-2  | 
|  US East (N. Virginia)  |  us-east-1  | us-east-1  | 
|  US West (N. California)  |  us-west-1  | us-west-2 | 
|  AS Barat (Oregon)  |  us-west-2  | us-west-2  | 
|  Afrika (Cape Town) **\$1**  |  af-south-1  | eu-west-2  | 
|  Asia Pasifik (Mumbai)  |  ap-south-1  | eu-west-2 | 
|  Asia Pasifik (Seoul)  |  ap-northeast-2  | ap-northeast-2 | 
|  Asia Pacific (Singapore)  |  ap-southeast-1  | ap-northeast-1 | 
|  Asia Pasifik (Sydney)  |  ap-southeast-2  | ap-southeast-2 | 
|  Asia Pacific (Tokyo)  |  ap-northeast-1  | ap-northeast-1 | 
|  Canada (Central)  |  ca-central-1  | ca-central-1 | 
|  Europe (Frankfurt)   |  eu-central-1  | eu-central-1  | 
|  Europe (Ireland)  |  eu-west-1  | eu-west-1 | 
|  Europe (London)  |  eu-west-2  | eu-west-2  | 
|  Eropa (Milan) **\$1**  |  eu-south-1  | eu-central-1  | 
|  Eropa (Paris)  |  eu-west-3  | eu-central-1  | 
|  Eropa (Stockholm)  |  eu-north-1  | eu-central-1 | 
|  Amerika Selatan (Sao Paulo)  |  sa-east-1  | sa-east-1 | 
|  GovCloud (AS-Timur)  |  us-gov-east-1  |  us-gov-west-1  | 
|  GovCloud (AS-Barat)  |  us-gov-west-1  |  us-gov-west-1  | 

**Pemilihan wilayah otomatis untuk Amazon Transcribe Medical**  



|  Wilayah Media Amazon Chime SDK  |  Kode Wilayah  |  Wilayah Transkripsi  | 
| --- | --- | --- | 
|  AS Timur (Ohio)  |  us-east-2  | us-east-2 | 
|  US East (N. Virginia)  |  us-east-1  | us-east-1 | 
|  US West (N. California)  |  us-west-1  | us-west-2 | 
|  AS Barat (Oregon)  |  us-west-2  | us-west-2 | 
|  Afrika (Cape Town) **\$1**  |  af-south-1  |  eu-west-1  | 
|  Asia Pasifik (Mumbai)  |  ap-south-1  | eu-west-1  | 
|  Asia Pasifik (Seoul)  |  ap-northeast-2  | us-west-2 | 
|  Asia Pasifik (Singapura)  |  ap-southeast-1  | ap-southeast-2 | 
|  Asia Pasifik (Sydney)  |  ap-southeast-2  | ap-southeast-2 | 
|  Asia Pacific (Tokyo)  |  ap-northeast-1  | us-west-2 | 
|  Kanada (Pusat)  |  ca-central-1  | ca-central-1 | 
|  Europe (Frankfurt)   |  eu-central-1  | eu-west-1 | 
|  Eropa (Irlandia)  |  eu-west-1  | eu-west-1 | 
|  Europe (London)  |  eu-west-2  | us-east-1 | 
|  Eropa (Milan) **\$1**  |  eu-south-1  | eu-west-1 | 
|  Eropa (Paris)  |  eu-west-3  | eu-west-1 | 
|  Europe (Stockholm)  |  eu-north-1  | eu-west-1 | 
|  Amerika Selatan (Sao Paulo)  |  sa-east-1  | us-east-1 | 

**catatan**  
Untuk menggunakan transkripsi langsung di Wilayah yang ditandai dengan tanda bintang (**\$1**), Anda harus terlebih dahulu mengaktifkan Wilayah di akun Anda AWS . Untuk informasi selengkapnya, lihat [Mengaktifkan Wilayah](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) di. Referensi Umum AWS

Untuk informasi lebih lanjut tentang wilayah dan titik akhir untuk setiap layanan, lihat:
+ [Wilayah media Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html)
+ [Titik akhir dan kuota Amazon Transcribe](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region)
+ [Titik akhir dan kuota Amazon Transcribe Medical](https://docs.aws.amazon.com/general/latest/gr/transcribe-medical.html)

## Langkah 3: Tinjau kuota layanan
<a name="transcribe-quotas"></a>

Setiap pertemuan Amazon Chime SDK dengan transkripsi langsung memerlukan tepat satu aliran HTTP/2 ke Amazon Transcribe atau Amazon Transcribe Medical. Kedua layanan memiliki kuota layanan regional untuk jumlah aliran HTTP/2 bersamaan, dan untuk transaksi start-stream per detik. Untuk informasi selengkapnya tentang kuota, lihat [Pedoman dan kuota di Panduan Pengembang](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html) *Amazon Transcribe*. Untuk informasi tentang peningkatan kuota, lihat Service Quotas di AWS konsol.

# Memulai dan menghentikan transkripsi langsung Amazon Chime SDK
<a name="initiate-transcription"></a>

Anda menggunakan Amazon Chime SDK [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html)API untuk memulai transkripsi rapat dengan menerapkan a ke rapat. `TranscriptionConfiguration` Pengontrol Amazon Chime SDK meneruskan konfigurasi ke rapat secara asinkron. Keberhasilan atau kegagalan memulai transkripsi rapat ditandai melalui pesan melalui Amazon Simple Notification Service (Amazon SNS) dan Amazon. EventBridge

**Memulai transkripsi**  
Contoh ini menunjukkan cara memulai transkripsi langsung dengan Amazon Transcribe.

```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{
    "TranscriptionConfiguration": {
        "EngineTranscribeSettings": {
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "en-US",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "tag",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "profanity",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "lingo",
            "Region": "us-east-1"
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": true,  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "high",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "ALL",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "language-model"
        }
    }
}
```

Contoh ini menunjukkan cara memulai transkripsi langsung dengan Amazon Transcribe Medical.

```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{  
    "TranscriptionConfiguration": {
        "EngineTranscribeMedicalSettings": {
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "en-US",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PRIMARYCARE",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "CONVERSATION",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "lingo",
            "Region": "us-east-1",
           "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PHI", 
        }
   }
}
```

`StartMeetingTranscription`— Memulai transkripsi untuk rapat.  
`meetingId`— ID rapat, dikembalikan oleh [CreateMeetingAPI](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax).  
`TranscriptionConfiguration`— Merangkum parameter untuk transkripsi langsung. Anda harus menentukan dengan tepat satu konfigurasi, `EngineTranscribeSettings` atau`EngineTranscribeMedicalSettings`.

`EngineTranscribeSettings`— Menentukan penggunaan Amazon Transcribe dan meneruskan pengaturannya ke. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters)  
`LanguageCode` – Wajib.  
`VocabularyFilterMethod` – Opsional.  
`VocabularyFilterName` – Opsional.  
`VocabularyName` – Opsional.  
`Region` – Opsional.  
`EnablePartialResultsStabilization` – Opsional.  
`PartialResultsStability` – Opsional.  
` ContentIdentificationType` – Opsional.  
`ContentRedactionType` – Opsional.  
`PiiEntityTypes ` – Opsional.  
`LanguageModelName` – Opsional.

`EngineTranscribeMedicalSettings`— Menentukan penggunaan Amazon Transcribe Medical dan meneruskan pengaturannya ke. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters)   
`LanguageCode` – Wajib.  
`Speciality` – Wajib.  
`Type` – Wajib.  
`VocabularyName` – Opsional.  
`Region` – Opsional.  
` ContentIdentificationType` – Opsional.

**Respons**  
Amazon Transcribe dan Amazon Transcribe Medical mengambil tanggapan berikut:
+ `OK`(200) dengan tubuh kosong, jika Anda berhasil mendaftar `TranscriptionConfiguration` ke rapat.

**Pesan kesalahan**  
Amazon Transcribe dan Amazon Transcribe Medical menampilkan pesan galat berikut:
+ **BadRequestException (400):** Parameter input tidak sesuai dengan batasan layanan.
+ **ForbiddenException (403):** Klien secara permanen dilarang membuat permintaan.
+ **NotFoundException (404):** `meetingId` Tidak ada.
+ **ResourceLimitExceededException (400):** Permintaan melebihi batas sumber daya. Misalnya, terlalu banyak rapat mengaktifkan transkripsi langsung.
+ **ServiceFailureException (500):** Layanan mengalami kesalahan yang tidak terduga.
+ **ServiceUnavailableException (503):** Layanan saat ini tidak tersedia.
+ **ThrottledClientException (429):** Klien melebihi batas tingkat permintaannya.
+ **UnauthorizedClientException (401):** Klien saat ini tidak berwenang untuk membuat permintaan.

`StartMeetingTranscription`Memanggil untuk kedua kalinya memperbarui yang `TranscriptionConfiguration` diterapkan pada rapat.

**Menghentikan transkripsi**  
Anda menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html)API untuk menghapus transkripsi rapat tertentu `meetingID` dan akhir. `TranscriptionConfiguration` Mengakhiri rapat menghentikan transkripsi secara otomatis.

Contoh ini menunjukkan sintaks permintaan yang memanggil`StopMeetingTranscription`.

```
POST/meetings/meetingId/transcription?operation=stop HTTP/1.1
```

**Respons**  
Amazon Transcribe dan Amazon Transcribe Medical mengambil tanggapan berikut:
+ `OK`(200) dengan tubuh kosong, jika Anda berhasil menghapus `TranscriptionConfiguration` dari rapat.

**Pesan kesalahan**  
Amazon Transcribe dan Amazon Transcribe Medical menampilkan pesan galat berikut:
+ **BadRequestException (400):** Parameter input tidak sesuai dengan batasan layanan.
+ **ForbiddenException (403):** Klien secara permanen dilarang membuat permintaan.
+ **NotFoundException (404):** `meetingId` Tidak ada.
+ **ServiceFailureException (500):** Layanan mengalami kesalahan yang tidak terduga.
+ **ServiceUnavailableException (503):** Layanan saat ini tidak tersedia.
+ **ThrottledClientException (429):** Klien melebihi batas tingkat permintaannya.
+ **UnauthorizedClientException (401):** Klien saat ini tidak berwenang untuk membuat permintaan.

## Parameter transkripsi langsung Amazon Chime SDK
<a name="transcription-parameters"></a>

Amazon Transcribe dan Amazon Transcribe APIs Medical menawarkan sejumlah parameter saat memulai transkripsi streaming, seperti dan. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html) Anda dapat menggunakan parameter selang t di `StartMeetingTranscription` API kecuali Amazon Chime SDK menentukan nilai parameter sebelumnya. Misalnya, `MediaSampleRateHertz` parameter `MediaEncoding` dan tidak tersedia karena Amazon Chime SDK menyetelnya secara otomatis.

Amazon Transcribe dan Amazon Transcribe Medical memvalidasi parameter, dan itu memungkinkan Anda menggunakan nilai parameter baru segera setelah tersedia. Misalnya, jika Amazon Transcribe Medical meluncurkan dukungan untuk bahasa baru, Anda hanya perlu menentukan nilai bahasa baru dalam parameter. `LanguageCode` 

# Memahami peristiwa transkripsi langsung Amazon Chime SDK
<a name="transcription-events"></a>

Amazon Chime SDK mengirimkan peristiwa siklus hidup transkripsi, yang dapat Anda gunakan untuk memicu notifikasi dan memulai alur kerja hilir. Beberapa contoh penggunaan peristiwa transkripsi meliputi:
+ Mengukur adopsi transkripsi langsung dalam rapat Amazon Chime SDK
+ Melacak preferensi bahasa

Anda dapat mengirim acara ke Amazon EventBridge, Amazon Simple Notification Service, dan Amazon Simple Queue Service. Untuk informasi selengkapnya, lihat [Acara dari AWS layanan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) di *Panduan EventBridge Pengguna Amazon*.

## Transkripsi rapat Amazon Chime SDK dimulai
<a name="transcript-start"></a>

Amazon Chime SDK mengirimkan peristiwa ini saat transkripsi rapat dimulai atau diperbarui. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html) 

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "id": "12345678-1234-1234-1234-111122223333", 
    "region": "us-east-1", 
    "detail-type": "Chime Meeting State Change", 
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": []
    "detail": {
        "version": "0", 
        "eventType": "chime:TranscriptionStarted",
        "timestamp": 12344566754,
        "meetingId": "87654321-4321-4321-1234-111122223333",
        "externalMeetingId": "mymeeting",
        "mediaRegion": "us-west-1",
        "transcriptionRegion": "us-west-2",
        "[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StartMeetingTranscription.html)": "{...}"
    }
}
```

## Transkripsi rapat Amazon Chime SDK dihentikan
<a name="transcript-stop"></a>

Amazon Chime SDK mengirimkan acara ini saat transkripsi rapat dihentikan.

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "id": "12345678-1234-1234-1234-111122223333", 
    "region": "us-east-1", 
    "detail-type": "Chime Meeting State Change", 
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": []
    "detail": {
        "version": "0", 
        "eventType": "chime:TranscriptionStopped",
        "timestamp": 12344566754,
        "meetingId": "87654321-4321-4321-1234-111122223333",
        "externalMeetingId": "mymeeting",
        "mediaRegion": "us-west-1",
        "transcriptionRegion": "us-west-2",
        "[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html)": "{...}"
    }
}
```

## Transkripsi rapat Amazon Chime SDK terputus
<a name="transcript-interrupted"></a>

Amazon Chime SDK mengirimkan acara ini jika transkripsi rapat terputus.

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "id": "12345678-1234-1234-1234-111122223333", 
    "region": "us-east-1", 
    "detail-type": "Chime Meeting State Change", 
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": []
    "detail": {
        "version": "0", 
        "eventType": "chime:TranscriptionInterrupted",
        "timestamp": 12344566754,
        "meetingId": "87654321-4321-4321-1234-111122223333",
        "externalMeetingId": "mymeeting",
        "message": "Internal server error",
        "mediaRegion": "us-west-1",
        "transcriptionRegion": "us-west-2",
        "[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)": "{...}"
    }
}
```

## Transkripsi rapat Amazon Chime SDK dilanjutkan
<a name="transcript-resumed"></a>

Amazon Chime SDK mengirimkan acara ini jika transkripsi rapat dilanjutkan setelah gangguan.

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "id": "12345678-1234-1234-1234-111122223333", 
    "region": "us-east-1", 
    "detail-type": "Chime Meeting State Change", 
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": []
    "detail": {
        "version": "0", 
        "eventType": "chime:TranscriptionResumed",
        "timestamp": 12344566754,
        "meetingId": "87654321-4321-4321-1234-111122223333",
        "externalMeetingId": "mymeeting",
        "mediaRegion": "us-west-1",
        "transcriptionRegion": "us-west-2",
        "[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)": "{...}"
    }
}
```

## Transkripsi rapat Amazon Chime SDK gagal
<a name="transcript-failed"></a>

Amazon Chime SDK mengirimkan peristiwa ini jika transkripsi rapat gagal dimulai, atau gagal dilanjutkan setelah gangguan.

**Contoh: Data acara**  
Berikut adalah data contoh untuk peristiwa ini.

```
{
    "version": "0", 
    "source": "aws.chime", 
    "account": "111122223333", 
    "id": "12345678-1234-1234-1234-111122223333", 
    "region": "us-east-1", 
    "detail-type": "Chime Meeting State Change", 
    "time": "yyyy-mm-ddThh:mm:ssZ", 
    "resources": []
    "detail": {
        "version": "0", 
        "eventType": "chime:TranscriptionFailed",
        "timestamp": 12344566754,
        "meetingId": "87654321-4321-4321-1234-111122223333",
        "externalMeetingId": "mymeeting",
        "message": "Internal server error",
        "mediaRegion": "us-west-1",
        "transcriptionRegion": "us-west-2",
        "[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)": "{...}"
    }
}
```

# Memahami pesan transkripsi langsung Amazon Chime SDK
<a name="process-msgs"></a>

Layanan Amazon Chime SDK membagikan informasi transkripsi dengan peserta dengan mengirimkan objek dalam pesan data. `TranscriptEvent` A `TranscriptEvent` memberikan a `Transcript` atau a. `TranscriptionStatus` 

A `Transcript` termasuk hasil dengan cap waktu, kata dan tanda baca yang dikaitkan dengan pengguna. Hasilnya mungkin “sebagian”, dalam hal ini sistem biasanya memperbaruinya selanjutnya`TranscriptEvent`. Ini memungkinkan Anda untuk melihat transkripsi dengan cepat dan menerapkan pembaruan sebaris nanti jika diperlukan.

A `TranscriptStatus` dapat mengirimkan salah satu `TranscriptionStatusType` acara, tercantum dalam contoh di bagian berikutnya.

Versi yang lebih baru dari Amazon SDKs Chime menyertakan tipe data tambahan dan fungsi pembantu untuk pemrosesan umum a. `TranscriptEvent`

## TranscriptEvent
<a name="transcript-event"></a>

Contoh ini menunjukkan peristiwa transkripsi yang khas.

```
type TranscriptEvent = Transcript | TranscriptionStatus;

export class TranscriptEventConverter {
  static from(dataMessage: DataMessage): TranscriptEvent[] {
    // convert DataMessage to TranscriptEvents
    return ...
  }
}

export default class TranscriptionStatus {
    type: TranscriptionStatusType;
    eventTimeMs:                   number;
    transcriptionRegion:           string;
    transcriptionConfiguration:    string;
    message?:                      string;
}

enum TranscriptionStatusType {
    STARTED        =    'started',
    INTERRUPTED    =    'interrupted',
    RESUMED        =    'resumed',
    STOPPED        =    'stopped',
    FAILED         =    'failed',
}

export default class Transcript {
    results: TranscriptResult[];    // at least one
}

export class TranscriptResult {
    resultId:        string;
    isPartial:       boolean;
    startTimeMs:     number;
    endTimeMs:       number;
    alternatives:    TranscriptAlternative[];    // most confident first
    }

export default class TranscriptAlternative {
    items: TranscriptItem[];    // in start time order
    transcript: string; //concatenated transcript items
    entities?: TranscriptEntity[];
}

export default class TranscriptItem {
    type:                      TranscriptItemType;
    startTimeMs:               number;
    endTimeMs:                 number;
    attendee:                  Attendee;
    content:                   string;
    vocabularyFilterMatch?:    boolean;
    confidence?:               number;  
    stable?:                   boolean;
}

enum TranscriptItemType {
    PRONUNCIATION    =    'pronunciation',// content is a word
    PUNCTUATION      =    'punctuation',// content is punctuation
}

export default class TranscriptEntity {  
    category:       string;  
    confidence:     number;  
    content:        string;  
    endTimeMs:      number;  
    startTimeMs:    number;  
    type?:          string;
}

// This is an existing SDK model
export default class Attendee {
    attendeeId:        string;
    externalUserId:    string;
}
```

## Pedoman data
<a name="data-guidelines"></a>

Ingatlah pedoman ini saat Anda pergi.

1. `transcription.results`mungkin memiliki lebih dari satu hasil.

1. Jika`transcription.results[i].isPartial = true`, maka mungkin ada pembaruan untuk seluruh hasil. Pembaruan mungkin, tetapi tidak dijamin. Pembaruan memiliki hal yang sama`transcript.result[i].resultId`. Jika Anda ingin menghindari transkripsi kepercayaan rendah, Anda dapat melewatkan sebagian hasil sepenuhnya. Jika Anda menginginkan hasil latensi rendah, Anda dapat menampilkan sebagian hasil, lalu menimpa sepenuhnya saat pembaruan tiba.

1. `transcription.results[i].alternatives`Selalu berisi setidaknya satu entri. Jika berisi lebih dari satu entri, entri yang paling percaya diri adalah yang pertama dalam daftar. Dalam kebanyakan kasus, Anda dapat mengambil entri pertama `transcription.results[i].alternatives` dan mengabaikan yang lain.

1. `transcription.results[i].alternatives[j].items`termasuk entri untuk setiap kata atau tanda baca.

1. `transcription.results[i].alternatives[j].items[k].`konten adalah apa yang diucapkan.

1. `transcription.results[i].alternatives[j].items[k].attendee`adalah atribusi pengguna (siapa) dari konten.

1. `transcription.results[i].alternatives[j].items[k].startTimeMs`adalah “kapan” konten. Ini memungkinkan word-by-word rendering transkripsi yang dikaitkan dengan pengguna di seluruh pengguna yang berbeda dalam urutan kata-kata diucapkan.

1. `transcription.results[i].alternatives[j].items[k].endTimeMs`Bidang umumnya dapat diabaikan, tetapi disediakan untuk kelengkapan siapa yang mengatakan kapan.

1. `transcription.results[i].alternatives[j].items[k].vocabularyFilterMatch`benar jika konten cocok dengan kata di filter, jika tidak maka salah.

1. `transcription.results[i].alternatives[j].items[k].confidence`adalah nilai antara 0 dan 1. Ini menunjukkan keyakinan mesin bahwa konten item dengan benar cocok dengan kata yang diucapkan, dengan 0 menjadi kepercayaan terendah dan 1 adalah kepercayaan tertinggi.

1. `transcription.results[i].alternatives[j].items[k].stable`menunjukkan apakah kata saat ini akan berubah dalam pembaruan hasil paral di masa mendatang. Nilai ini hanya bisa benar jika Anda mengaktifkan fitur stabilisasi hasil paral dengan menyetel `EnablePartialResultsStabilization` ke `true` dalam permintaan Anda.

1. `transcription.results[i].alternatives[j].entities`menyertakan entri untuk setiap entitas yang terdeteksi oleh fitur Identifikasi Konten atau Redaksi. Daftar ini hanya diisi jika Anda mengaktifkan Identifikasi Konten atau Redaksi. Entitas dapat berupa data seperti informasi yang dapat diidentifikasi secara pribadi atau informasi kesehatan pribadi. Anda dapat menggunakan entitas untuk menyorot, atau mengambil tindakan atas, kata-kata yang menarik selama transkripsi.

1. `transcription.results[i].alternatives[j].entities[k].category`adalah kategori entitas. Ini sama dengan jenis Identifikasi Konten atau Redaksi, seperti “PII” atau “PHI”, yang disediakan dalam permintaan.

1. `transcription.results[i].alternatives[j].entities[k].confidence`mengukur seberapa kuat mesin bahwa konten tertentu benar-benar suatu entitas. Perhatikan bahwa ini berbeda dari kepercayaan tingkat item, yang mengukur seberapa yakin mesin dalam kebenaran kata-kata itu sendiri.

1. `transcription.results[i].alternatives[j].entities[k].content`adalah teks aktual yang membentuk entitas. Ini bisa berupa beberapa item, seperti alamat.

1. `transcription.results[i].alternatives[j].entities[k].startTimeMs`menangkap waktu di mana entitas mulai berbicara.

1. `transcription.results[i].alternatives[j].entities[k].endTimeMs`menangkap waktu di mana entitas selesai diucapkan.

1. `transcription.results[i].alternatives[j].entities[k].type`hanya didukung untuk mesin Transcribe dan menyediakan sub-tipe entitas. Ini adalah nilai-nilai seperti `ADDRESS`, `CREDIT\$1DEBIT\$1NUMBER`, dan sebagainya.

## Mendaftarkan event handler untuk TranscriptEvents
<a name="register-handler"></a>

Contoh berikut menggunakan library klien Amazon Chime SDK untuk. JavaScript Namun, polanya konsisten di semua Amazon SDKs Chime.

`TranscriptionController`Dalam `RealtimeController` dan `RealtimeControllerFacade` termasuk fungsi khusus untuk menambahkan handler yang memproses`TranscriptionEvents`:

```
/** 
 * Returns the [[TranscriptionController]] for this real-time controller. 
 */
readonly transcriptionController?: TranscriptionController;
```

Ini `TranscriptionController` memiliki dua fungsi untuk mengelola berlangganan dan berhenti berlangganan callback: `TranscriptionEvent`

```
import TranscriptEvent from './TranscriptEvent';

export default interface TranscriptionController {
  /**
   * Subscribe a callback to handle received transcript event
   */
  subscribeToTranscriptEvent(callback: (transcriptEvent: TranscriptEvent) => void): void;

  /** 
   * Unsubscribe a callback from receiving transcript event 
   */
  unsubscribeFromTranscriptEvent(callback: (transcriptEvent: TranscriptEvent) => void): void;
}
```

**Menggunakan opsional `TranscriptionController`**  
Kami menyediakan implementasi default `TranscriptionController` antarmuka bernama`DefaultTranscriptionController`. Implementasi default dalam `DefaultRealtimeController` dan `DefaultAudioVideoFacade` mengembalikan `DefaultTranscriptionController` objek:

```
/** 
get transcriptionController(): TranscriptionController {
   return this.realtimeController.transcriptionController;
}
```

`DefaultRealtimeController`juga mengambil `TranscriptionController` objek opsional dalam konstruktornya. Itu memungkinkan Anda untuk mengesampingkan `DefaultTranscriptionController` perilaku. Aplikasi pengembang berlangganan dan berhenti berlangganan satu atau lebih panggilan balik melalui `TranscriptionController` objek objek: `AudioVideoFacade`

```
// Subscribe
this.audioVideo.transcriptionController?.subscribeToTranscriptEvent(this.transcriptEventHandler);

// Unsubscribe
this.audioVideo.transcriptionController?.unsubscribeFromTranscriptEvent(this.transcriptEventHandler););
```

# Memproses acara transkrip langsung Amazon Chime SDK yang diterima
<a name="delivery-examples"></a>

Contoh berikut menunjukkan cara memproses yang diterima`TranscriptEvent`.

**catatan**  
Output yang tepat tergantung pada beberapa faktor, termasuk seberapa cepat individu berbicara dan kapan mereka berhenti.

## Contoh 1: StartMeetingTranscription
<a name="example-1"></a>

Contoh ini menunjukkan `StartMeetingTranscription` operasi yang khas.

```
meeting.StartMeetingTranscription(
    { EngineTranscribeSettings: { Languagecode: ‘en-US’ } } );
```

Operasi menghasilkan a`TranscriptEvent`.

```
{   
    status: {        
        type: 'started',        
        eventTimeMs: 1620118800000,        
        transcriptionConfig: {                    
            LanguageCode: 'en-US'        
        }    
    }
}
```

## Contoh 2: Hasil transkrip sebagian
<a name="example-2"></a>

Dalam contoh ini, seorang peserta berkata, “Rubah coklat cepat melompati anjingnya yang malas.” Perhatikan bahwa dalam contoh ini, `isPartial` nilainya adalah`true`. Jika Anda melihat lebih dalam ke dalam pesan, Anda dapat melihat bahwa sistem memproses kata “rubah” sebagai “fakta.” Sistem menggunakan hal yang sama `resultId` untuk memperbarui transkrip. 

```
{
    transcript: {
        results: [{
            resultId:"1",                               isPartial: true,
            startTimeMs: 1620118800000,                 endTimeMs: 1620118801000,
            alternatives: [{
                items:[{
                    type:        'pronunciation',
                    startTimeMs: 1620118800000,         endTimeMs: 1620118800200,
                    attendee: { attendeeId: "1",        externalUserId: "A"},
                    content: "the",                     vocabularyFilterMatch: false
                },
                {
                    type:        'pronunciation',
                    startTimeMs: 1620118800200,          endTimeMs: 1620118800400,
                    attendee: { attendeeId: "1",         externalUserId: "A" },
                    content:"quick",                     vocabularyFilterMatch: false
                },
                {
                    type:'pronunciation',
                    startTimeMs: 1620118800400,          endTimeMs: 1620118800750,
                    attendee: { attendeeId: "1",         externalUserId: "A" },
                    content:"brown",                     vocabularyFilterMatch: false
                },
                {
                    type:'pronunciation',
                    startTimeMs: 1620118800750,          endTimeMs: 1620118801000,
                    attendee:{ attendeeId: "1",          externalUserId: "A" },
                    content:"facts",                     vocabularyFilterMatch: false
                },
                {
                    type:'punctuation',
                    startTimeMs: 1620118801000,          endTimeMs: 1620118801500,
                    attendee:{ attendeeId: "1",          externalUserId: "A" },
                    content:    ",",                     vocabularyFilterMatch: false
                }]
            }]
        }]
    }
}
```

## Contoh 3: Hasil transkrip akhir
<a name="example-3"></a>

Dalam hal transkrip sebagian, sistem memproses frasa lagi. Contoh ini memiliki `isPartial` nilai`false`, dan pesan berisi “rubah” bukan “fakta.” Sistem menerbitkan ulang pesan menggunakan ID yang sama.

```
{
    transcript: {
        results: [{
            resultId:"1",                                isPartial: false,
            startTimeMs: 1620118800000,                  endTimeMs: 1620118801000,
            alternatives: [{
                items:[{
                    type:        'pronunciation',
                    startTimeMs: 1620118800000,          endTimeMs: 1620118800200,
                    attendee: { attendeeId: "1",         externalUserId: "A"},
                    content: "the",                      vocabularyFilterMatch: false
                },
                {
                    type:        'pronunciation',
                    startTimeMs: 1620118800200,          endTimeMs: 1620118800400,
                    attendee: { attendeeId: "1",         externalUserId: "A" },
                    content:"quick",                     vocabularyFilterMatch: false
                },
                {
                    type:'pronunciation',
                    startTimeMs: 1620118800400,          endTimeMs: 1620118800750,
                    attendee: { attendeeId: "1",         externalUserId: "A" },
                    content:"brown",                     vocabularyFilterMatch: false
                },
                {
                    type:'pronunciation',
                    startTimeMs: 1620118800750,          endTimeMs: 1620118801000,
                    attendee: { attendeeId: "1",          externalUserId: "A" },
                    content:"fox",                       vocabularyFilterMatch: false
                },
                {
                    type:'punctuation',
                    startTimeMs: 1620118801000,          endTimeMs: 1620118801500,
                    attendee: { attendeeId: "1",          externalUserId: "A" },
                    content:    ",",                     vocabularyFilterMatch: false
                }]
            }]
        }]
    }
}
```

# Mengurai transkrip Amazon Chime SDK
<a name="parse-transcripts"></a>

Gunakan perintah berikut untuk mengurai konten transkripsi dari pesan transkripsi. Perintah mem-parsing kalimat lengkap dari file transcript-message.txt.

```
with open('transcript-message.txt') as f:
        for line in f:
            result_json = json.loads(line)["transcript"]["results"][0]
            if result_json['isPartial'] == False:
                print(result_json["alternatives"][0]["transcript"])
```

# Menggunakan replikasi media untuk rapat Amazon Chime SDK
<a name="media-replication"></a>

Anda dapat menggunakan replikasi media untuk menautkan sesi WebRTC utama dengan beberapa sesi replika untuk menjangkau audiens yang lebih besar. Setiap sesi media WebRTC mendukung 250 koneksi, dan Anda dapat mereplikasi sesi utama ke beberapa sesi replika. Peserta yang terhubung ke sesi replika hanya menerima audio dan video dari presenter yang terhubung ke sesi utama. Mereka tidak memiliki pengetahuan tentang peserta yang terhubung ke sesi yang direplikasi, yang membuat replikasi media ideal untuk webinar dan kasus penggunaan lainnya di mana privasi diinginkan.

Gambar berikut menunjukkan replikasi media antara sesi utama dengan presenter berbagi audio dan video, dan sesi replika dengan peserta yang mengkonsumsi media.

![\[Presenter berbagi dalam sesi utama.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/replication-1.png)


**catatan**  
Kuota layanan *Chime SDK Meetings - rapat replika per rapat utama* memiliki nilai default 4, dan Anda dapat meningkatkan batas tersebut berdasarkan permintaan. Untuk informasi lebih lanjut tentang kuota, lihat [kuota AWS layanan](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) di Referensi *AWS Umum*.

**Topics**
+ [Peserta interaktif](#interactive-participants)
+ [Peserta global](#global-participants)
+ [Siklus hidup sesi](#session-lifecycle)

## Peserta interaktif
<a name="interactive-participants"></a>

Peserta yang terhubung ke sesi replika dapat diberikan akses untuk bergabung dengan sesi utama. Karena semua orang menggunakan koneksi WebRTC, presenter dan peserta tidak mengalami penundaan transcoding. Ketika peserta beralih antara sesi primer dan yang direplikasi, mereka menggunakan kembali koneksi WebRTC mereka, jadi perpindahan sangat cepat. Itu memungkinkan peserta untuk berkontribusi pada percakapan langsung tanpa melewatkan konten apa pun.

Gambar berikut menunjukkan peserta dalam sesi replika menggunakan koneksi WebRTC mereka untuk beralih ke sesi utama.

![\[Diagram yang menunjukkan dua peserta beralih dari pertemuan replika ke pertemuan utama.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/replication-2.png)


## Peserta global
<a name="global-participants"></a>

Anda dapat memilih AWS Wilayah untuk setiap sesi media WebRTC. Itu memungkinkan Anda membuat sesi replika di Wilayah yang lebih dekat dengan peserta Anda daripada Wilayah sesi utama. Saat Anda melakukan ini, media mengalir dari sesi utama ke sesi replika di seluruh jaringan AWS, kemudian dari sesi replika ke peserta di Internet. Saat mempresentasikan kepada audiens global, mengadakan sesi replika di dekat peserta Anda dapat membantu memastikan bahwa media melakukan perjalanan ke seluruh dunia melalui jaringan AWS, bukan internet, untuk pengalaman rapat yang lebih baik.

Gambar berikut menunjukkan sesi utama dan sesi direplikasi di Wilayah yang berbeda.

![\[Diagram yang menunjukkan peserta di 3 Wilayah menonton presentasi.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/replication-3.png)


## Siklus hidup sesi
<a name="session-lifecycle"></a>

Membuat sesi  
Anda menggunakan [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_CreateMeeting.html) atau [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html) APIs untuk membuat sesi media WebRTC. Secara default, APIs membuat sesi utama kecuali Anda secara khusus membuat sesi replika.  
Anda membuat sesi replika dengan menentukan sesi `MeetingId` utama sebagai panggilan `PrimaryMeetingId` dalam `CreateMeeting` atau `CreateMeetingWithAttendees` API.  
Jika Anda menentukan `MeetingId` sesi replika sebagai`PrimaryMeetingId`, panggilan API akan gagal.

Membuat peserta  
 Untuk membuat kredensi peserta yang diperlukan untuk bergabung dengan sesi media WebRTC, Anda dapat menggunakan [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html), [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html), atau [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_CreateAttendee.html) APIs.   
Saat membuat sesi untuk sejumlah besar peserta, gunakan `CreateMeetingWithAttendees` atau `BatchCreateAttendee` untuk meminimalkan jumlah panggilan API yang diperlukan.

Menghapus peserta  
Anda menggunakan [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_DeleteAttendee.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_DeleteAttendee.html)API untuk mencabut kredensi peserta untuk sesi media WebRTC. Jika peserta terhubung ke sesi, mereka akan terputus dan tidak dapat bergabung kembali.  
Saat Anda menggunakan [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_DeleteMeeting.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_DeleteMeeting.html)API untuk menghapus sesi media WebRTC, API secara otomatis menghapus semua peserta dan Anda tidak perlu menelepon. `DeleteAttendee`

Beralih sesi  
Untuk memungkinkan peserta beralih dari sesi replika ke sesi utama, Anda harus membuat kredensialnya di rapat utama. Lihat *Membuat peserta* sebelumnya dalam daftar ini. Gunakan kredensional dengan `promoteToPrimaryMeeting` metode di library klien Amazon Chime SDK untuk beralih ke sesi utama.  
Untuk mengalihkan peserta kembali ke sesi replika, gunakan `demoteFromPrimaryMeeting` metode di library klien Amazon Chime SDK, atau gunakan [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_DeleteAttendee.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_DeleteAttendee.html)API untuk membatalkan kredensi sesi utama mereka.  
Presenter yang terhubung langsung ke sesi utama tidak dapat beralih ke sesi replika.
Untuk informasi selengkapnya tentang beralih antar sesi, lihat dokumentasi pustaka klien:  
+ [Amazon Chime SDK](https://github.com/aws/amazon-chime-sdk-android) untuk Android aktif. GitHub
+ [Amazon Chime SDK](https://github.com/aws/amazon-chime-sdk-ios) untuk iOS aktif. GitHub
+ [Pustaka klien Amazon Chime SDK](https://github.com/aws/amazon-chime-sdk-js) untuk aktif. JavaScript GitHub

Menghapus sesi  
Anda menggunakan [https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_DeleteMeeting.html](https://docs.aws.amazon.com/chime/latest/APIReference/API_meeting-chime_DeleteMeeting.html)API untuk menghapus sesi media WebRTC.  
Jika Anda menghapus sesi utama, `DeleteMeeting` API secara otomatis menghapus semua sesi replika terlampir. Jadi untuk menghapus semua sesi, hapus saja yang utama.  
Layanan secara otomatis menghapus sesi utama jika tidak ada peserta yang terhubung selama 5 menit yang berdekatan. Layanan hanya menghapus sesi replika secara otomatis ketika menghapus sesi utama. Itu berarti Anda dapat membuat sesi replika saat Anda membuat sesi utama, dan replika akan tersedia selama sesi utama.

# Memecahkan masalah dan men-debug rapat Amazon Chime SDK
<a name="troubleshoot-sdk-meetings"></a>

Gunakan topik berikut untuk membantu mendiagnosis dan memecahkan masalah yang Anda temui saat bekerja dengan Amazon Chime SDK. 

**Topics**
+ [Memahami persyaratan sistem untuk rapat Amazon Chime SDK](ts-supported-browsers.md)
+ [Menyiapkan pencatatan dan pemantauan untuk rapat Amazon Chime SDK](ts-log-monitor.md)
+ [Memecahkan masalah rapat Amazon Chime SDK](self-troubleshooting.md)
+ [Memahami masalah umum dengan rapat Amazon Chime SDK](common-issues.md)

# Memahami persyaratan sistem untuk rapat Amazon Chime SDK
<a name="ts-supported-browsers"></a>

Sebagai bagian dari pemecahan masalah, pastikan Anda membuat kode untuk browser yang didukung. Untuk daftar browser, versi, dan sistem operasi yang didukung saat ini, lihat[Persyaratan sistem Amazon Chime SDK](meetings-sdk.md#mtg-browsers). [Panduan pengembang dan FAQs di browser alamat Github](https://github.com/aws/amazon-chime-sdk-js/issues/1059) dan masalah kompatibilitas lainnya. Juga, biasakan diri Anda dengan [masalah browser yang diketahui](https://aws.github.io/amazon-chime-sdk-js/modules/faqs.html#known-browser-issues) GitHub dan solusi apa pun.

Jika Anda baru saja memulai dengan Amazon Chime SDK Meetings, [Builder Journey Amazon Chime SDK menyediakan step-by-step panduan untuk](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/20_Builders_Journey.md) membangun dengan Amazon Chime SDK, ditambah alat yang diperlukan untuk pemecahan masalah.

# Menyiapkan pencatatan dan pemantauan untuk rapat Amazon Chime SDK
<a name="ts-log-monitor"></a>

Logging membantu Anda mengumpulkan informasi seperti acara pertemuan sisi server dan log konsol browser sisi klien.

Amazon Chime SDK menyediakan acara pertemuan sisi server yang dapat Anda kirim ke log Amazon dan Amazon Events. EventBridge CloudWatch Anda dapat membuat CloudWatch metrik dan wawasan, dan menggunakannya di dasbor Anda untuk pemantauan. Posting blog [Logging dan Monitoring sisi Server Amazon Chime SDK menjelaskan cara mengaktifkan Metrik](https://aws.amazon.com/blogs/business-productivity/server-side-logging-and-monitoring-of-amazon-chime-sdk-events/), Wawasan, dan Dasbor. CloudWatch 

Amazon Chime SDK menyediakan peristiwa sisi klien untuk kualitas audio dan video, bandwidth jaringan, dan masalah konektivitas. Posting blog [Monitoring dan pemecahan masalah dengan Amazon Chime SDK Meeting](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/) event menjelaskan cara CloudWatch mengaktifkan Metrik, Wawasan, dan Dasbor untuk kegagalan gabungan, masalah kualitas audio, dan kegagalan penyiapan mikrofon dan kamera. Untuk informasi tambahan tentang acara rapat, lihat [Acara Rapat](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/06_Meeting_Events.md) di Github. 



## Opsi untuk metrik pemecahan masalah
<a name="ts-cloudwatch-options"></a>

Anda memiliki opsi berikut untuk mengumpulkan acara pemecahan masalah.
+ Kirim metrik di setiap acara 
+ Peristiwa Batch setiap N detik 
+ Kirim metrik di akhir rapat 
+ Tingkat logging untuk log konsol browser

## Metrik-metrik yang direkomendasikan
<a name="ts-cloudwatch-metrics"></a>

Minimal, Anda harus mengumpulkan dan mencatat metrik berikut.
+ Platform dan versi SDK
+ Browser dan versi
+ Sistem operasi
+ Inti logis
+ Pertemuan dimulai
+ Pertemuan berakhir
+ Attendee bergabung
+ Peserta pergi
+ Peserta dijatuhkan

Selain itu, tergantung pada masalah yang Anda hadapi, metrik berikut dapat memberikan informasi tentang konektivitas, bandwidth, dan masalah kualitas. Anda dapat mencatat setiap kemunculan metrik ini, atau hanya menghitungnya. Menghitung dapat memberikan pandangan yang diringkas tentang masalah mendasar:
+ connectionDidSuggestStopVideo
+ connectionDidBecomeBagus
+ connectionDidBecomeMiskin
+ Waktu bergabung peserta > t detik
+ MeetingStartFailed
+ MeetingFailed

## Mengaktifkan pencatatan sisi klien
<a name="client-side-logging"></a>

Anda dapat mengaktifkan log browser `INFO` -level dengan meneruskan `LogLevel.INFO` ke `ConsoleLogger` objek.

```
const logger = new ConsoleLogger('MyLogger', LogLevel.INFO);const meetingSession = new DefaultMeetingSession(configuration,logger,deviceController); 
```

Anda juga dapat menggunakan `POSTLogger` komponen di Amazon Chime SDK JavaScript untuk menangkap log browser di bagian belakang Anda, seperti Amazon Logs. CloudWatch `POSTLogger`membuat `HTTP POST` permintaan untuk mengunggah log browser ke URL yang diberikan di [POSTLoggerkonstruktor](https://aws.github.io/amazon-chime-sdk-js/classes/postlogger.html). Misalnya, [demo tanpa server Amazon Chime SDK GitHub menggunakan file untuk mengirim log browser `POSTLogger` ke Amazon Logs untuk penyelidikan di](https://github.com/aws/amazon-chime-sdk-js/blob/main/demos/browser/app/meetingV2/meetingV2.ts#L1773) masa mendatang. CloudWatch 

## Mengaktifkan pencatatan sisi server
<a name="server-side-logging"></a>

Amazon Chime SDK untuk JavaScript juga memanggil metode `eventDidReceive` pengamat dengan peristiwa rapat utama, seperti dan. `MeetingStartFailed` `MeetingFailed` Acara rapat sering kali mencakup alasan spesifik untuk kegagalan. Misalnya, katakan bahwa sekelompok besar pelanggan mengalami kegagalan. Aplikasi web Anda dapat mengumpulkan acara rapat tersebut, dan kemudian membagikannya kepada kami untuk memecahkan masalah akar masalahnya. Untuk informasi selengkapnya tentang acara rapat, lihat [panduan acara rapat GitHub](https://aws.github.io/amazon-chime-sdk-js/modules/meetingevents.html), serta [Pemantauan dan pemecahan masalah dengan postingan blog peristiwa rapat Amazon Chime SDK](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/).

# Memecahkan masalah rapat Amazon Chime SDK
<a name="self-troubleshooting"></a>

Bagian dalam topik ini menjelaskan beberapa cara untuk memecahkan masalah sendiri rapat Amazon Chime SDK.

**Topics**
+ [Memeriksa FAQs dan masalah yang diketahui](#check-faqs)
+ [Memverifikasi akses jaringan](#net-acess)

## Memeriksa FAQs dan masalah yang diketahui
<a name="check-faqs"></a>

Periksa ini FAQs dan daftar masalah yang diketahui GitHub untuk saran pemecahan masalah dan debugging.
+ [Amazon Chime SDK - - Rapat JavaScript ](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/07_FAQs.md#meetings)
+ [Amazon Chime SDK — - Media JavaScript ](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/07_FAQs.md#media)
+ [Amazon Chime SDK — - Jaringan JavaScript ](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/07_FAQs.md#networking)
+ [Amazon Chime SDK — - Audio dan Video](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/07_FAQs.md#audio-and-video)

## Memverifikasi akses jaringan
<a name="net-acess"></a>

Perusahaan sering memiliki firewall jaringan yang membatasi akses ke port tertentu, atau koneksi ke alamat IP berkisar dari jaringan mereka. Bagian berikut menjelaskan beberapa cara Anda dapat memverifikasi akses jaringan.

**Topics**
+ [Memvalidasi AWS subnet dan port SDK SDK dan Amazon Chime](#subnets-ports)
+ [Menggunakan aplikasi demo untuk mereproduksi masalah](#repro-on-demo-apps)
+ [Menggunakan Pemeriksa Kesiapan Rapat](#ready-checker)

### Memvalidasi AWS subnet dan port SDK SDK dan Amazon Chime
<a name="subnets-ports"></a>

Aplikasi yang menggunakan Amazon Chime SDK menggunakan dua tingkatan, server dan klien. Tingkat server menggunakan AWS SDK dan memiliki penangan rapat sisi server. Tingkat klien menggunakan klien SDKs.

 AWS SDK digunakan untuk memanggil server APIs seperti [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html). APIs Terhubung dengan titik akhir layanan AWS global di`us-east-1`,,`us-west-2`,`ap-southeast-1`, `eu-central-1``us-gov-east-1`, dan `us-gov-west-1` Wilayah. Halaman [rentang alamat AWS IP](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html) di *Referensi AWS Umum* mencantumkan rentang alamat IP untuk setiap Wilayah. Untuk informasi tentang titik akhir dan kuota layanan, lihat titik akhir dan kuota [Amazon Chime SDK](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html).

Klien SDKs, seperti Amazon Chime SDK for JavaScript, terhubung ke titik akhir layanan di domain. `*.chime.aws` 

Gunakan validasi berikut untuk memastikan bahwa Anda memiliki izin jaringan:
+ Jalankan [Pemeriksa Kesiapan Rapat Amazon Chime SDK](https://github.com/aws/amazon-chime-sdk-js#meeting-readiness-checker) GitHub untuk memverifikasi bahwa Anda dapat menjangkau jaringan dan port.
+ Verifikasi bahwa Anda dapat menyelesaikan domain\$1.chime.aws dari jaringan atau jaringan pengguna akhir Anda. 
+ Pastikan firewall Anda memungkinkan koneksi ke rentang AWS IP melalui TCP Port 443 untuk perintah kontrol dan UDP Port 3478 untuk media. 

### Menggunakan aplikasi demo untuk mereproduksi masalah
<a name="repro-on-demo-apps"></a>

Sebagai praktik terbaik, mulailah proses debugging dengan mencoba mereproduksi masalah Anda di salah satu aplikasi demo. Itu memungkinkan tim layanan untuk menemukan di mana masalahnya mungkin. Jika Anda tidak dapat mereproduksi masalah dengan aplikasi demo, Anda dapat meninjau kode aplikasi untuk melihat bagaimana hal itu menerapkan kasus penggunaan yang relevan.




| Amazon Chime SDK | Fitur | Sumber daya aplikasi demo | 
| --- | --- | --- | 
| JavaScript SDK | Rapat | [Instruksi demo](https://github.com/aws/amazon-chime-sdk-js/tree/main/demos/serverless), [kode sumber](https://github.com/aws/amazon-chime-sdk-js/tree/main/demos/browser) | 
| Bereaksi komponen | Rapat |   [Instruksi demo](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/meeting) [Kode sumber](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/meeting/src)   | 
| Obrolan pertemuan | Perpesanan |   [Posting blog](https://aws.amazon.com/blogs/business-productivity/build-meeting-features-into-your-amazon-chime-sdk-messaging-application/), [instruksi Demo](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/chat), [kode sumber](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/chat/src)   | 
| iOS/Android | Rapat |  (Posting blog) [Membangun Aplikasi Rapat di Android menggunakan Amazon Chime SDK](https://aws.amazon.com/blogs/business-productivity//building-a-meeting-application-on-android-using-the-amazon-chime-sdk/) (Posting blog) [Membangun Aplikasi Rapat di iOS menggunakan Amazon Chime SDK](https://aws.amazon.com/blogs/business-productivity/building-a-meeting-application-on-ios-using-the-amazon-chime-sdk/)   | 
| Audio PSTN | Panggilan masuk |   [Posting blog](https://github.com/aws-samples/amazon-chime-sma-update-call) [Kode sumber](https://github.com/aws-samples/amazon-chime-sma-update-call)   | 

### Menggunakan Pemeriksa Kesiapan Rapat
<a name="ready-checker"></a>

Gunakan Pemeriksa [Kesiapan Rapat Amazon Chime SDK aktif](https://github.com/aws/amazon-chime-sdk-js#meeting-readiness-checker). GitHub Pemeriksa membantu memverifikasi perangkat audio dan video, dan koneksi pengguna. Anda dapat menyajikan hasilnya kepada pengguna akhir Anda dengan menggunakan pass/fail patung yang mengekspos akar penyebab masalah apa pun.

# Memahami masalah umum dengan rapat Amazon Chime SDK
<a name="common-issues"></a>

Bagian berikut menyediakan metode pemecahan masalah untuk masalah rapat umum.

**Topics**
+ [Masalah konektivitas](#connectivity-issues)
+ [Masalah kualitas audio dan video](#a-v-quality)
+ [Memverifikasi kuota SDK dan pembatasan API untuk rapat Amazon Chime SDK](quotas-throttling.md)
+ [Membuka kasus dukungan untuk rapat Amazon Chime SDK](open-support-cases.md)

## Masalah konektivitas
<a name="connectivity-issues"></a>

Untuk masalah konektivitas, lihat[Memverifikasi akses jaringan](self-troubleshooting.md#net-acess).

## Masalah kualitas audio dan video
<a name="a-v-quality"></a>

Masalah kualitas audio dan video dapat memiliki beberapa penyebab. Dua alasan utama untuk audio/video kualitas sub optimal adalah bandwidth jaringan, dan kinerja perangkat. Untuk informasi terperinci tentang berbagai tantangan dan bagaimana hal ini memengaruhi audio/video kualitas, lihat [Kualitas, Bandwidth, dan Konektivitas](https://aws.github.io/amazon-chime-sdk-js/modules/qualitybandwidth_connectivity.html) di *GitHub*. Artikel ini menjelaskan berbagai peristiwa dan metrik yang dapat dipantau untuk mendeteksi masalah bandwidth dan potensi mitigasi.

Anda dapat memilih Wilayah Media yang lebih dekat dengan audiens sesi pertemuan target. Untuk memahami cara memilih wilayah media yang optimal, lihat Menggunakan Wilayah rapat (https://docs.aws.amazon.com/chime-sdk/latest/dg/chime- sdk-meetings-regions .html).

Bergantung pada bandwidth yang tersedia untuk peserta rapat, Amazon Chime SDK menyesuaikan kualitas video dari kebijakan video. received/uploaded. To understand how you can control the video quality for different video layouts, visit Managing Video Quality for different Video Layouts (https://aws.github.io/amazon-chime-sdk-js/modules/videolayout.html). This article describes video lifecycle management and uplink/downlink 

**Pertimbangan resolusi video**
+ Resolusi default untuk mengunggah video adalah 540p dan 15fps pada 1400 kbps. Tergantung pada bandwidth, Anda dapat mengurangi resolusi dan frame rate itu.
+ Berdasarkan bandwidth penerima yang tersedia, tentukan berapa banyak ubin video yang akan ditampilkan. Jangan melampaui 6Mbps untuk semua ubin video dan berbagi konten. Pengguna akhir melihat ubin video hitam ketika mereka tidak memiliki bandwidth yang cukup.

**Menggunakan kebijakan bandwidth uplink dan downlink video**  
Amazon Chime SDK menyediakan kebijakan bandwidth berikut.
+ NScaleVideoUplinkBandwidthPolicy — Menerapkan parameter capture dan encoding yang hampir sama dengan yang digunakan oleh desktop, web, dan klien seluler.
+ AllHighestVideoBandwidthPolicy — Selalu berlangganan streaming video berkualitas tinggi.
+ NoVideoDownlinkBandwidthPolicy — Menonaktifkan video saat bandwidth turun di bawah ambang batas yang diberikan.
+ VideoPriorityBasedPolicy — Memprioritaskan audio daripada video dalam kasus bandwidth rendah.
+ VideoAdaptiveProbePolicy

# Memverifikasi kuota SDK dan pembatasan API untuk rapat Amazon Chime SDK
<a name="quotas-throttling"></a>

Halaman [akhir dan kuota Amazon Chime SDK mencantumkan kuota](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) layanan, tarif API, dan apakah Anda dapat menyesuaikannya. Gunakan halaman [Kuota Layanan AWS Konsol](https://console.aws.amazon.com/servicequotas/home/services/chime/quotas) untuk meminta penyesuaian kuota.

**Menyetel tarif API Anda dengan baik**  
Aplikasi yang melebihi tarif API mereka menerima Kode Status HTTP 429 dan `ThrottledClientException` pesan. Anda dapat menyesuaikan tarif API Anda, tetapi sebelum melakukannya, periksa aplikasi Anda untuk bug yang dapat menghabiskan tarif tersebut. Misalnya, Anda dapat membuat rapat dalam satu lingkaran, atau membuat rapat dan tidak membersihkannya.

Bergantung pada cara Anda membuat rapat, Anda mungkin perlu memodifikasi kode Anda. Misalnya, Anda dapat mengganti `CreateMeeting` dan `CreateAttendee` dengan: 
+ [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeetingWithAttendees.html)— Menciptakan hingga 10 peserta per rapat.
+ [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_BatchCreateAttendee.html)— Menciptakan hingga 100 peserta per rapat.

Anda dapat menyimpan peserta yang dibuat dalam database, menarik informasi peserta saat undangan bergabung dengan rapat, dan kemudian mengaitkannya dengan peserta yang telah dibuat sebelumnya.

# Membuka kasus dukungan untuk rapat Amazon Chime SDK
<a name="open-support-cases"></a>

Jika Anda memiliki pertanyaan lebih lanjut, atau memerlukan dukungan untuk bisnis Anda, Anda dapat menghubungi [dukungan Pelanggan AWS](https://pages.awscloud.com/GLOBAL-aware-GC-Amazon-Chime-SDK-2020-reg.html). Untuk informasi selengkapnya tentang paket dukungan kami, lihat halaman [Bandingkan paket dukungan](https://aws.amazon.com/premiumsupport/plans/?nc=sn). Saat membuat kasus dukungan, selalu buka di bawah akun yang bermasalah. Sertakan log browser konsol, rapat dan peserta IDs, dan kasus atau GitHub masalah dukungan terkait.