Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwenden von Amazon Chime SDK-Besprechungen
<a name="mtgs-sdk-mtgs"></a>

In den Themen in diesem Abschnitt wird erklärt, wie Sie Amazon Chime SDK-Meetings verwenden, um benutzerdefinierte Meeting-Anwendungen zu erstellen. Wir empfehlen, diese Themen in der angegebenen Reihenfolge zu befolgen. 

**Topics**
+ [Migration zum Amazon Chime SDK-Namespace für Besprechungen](meeting-namespace-migration.md)
+ [Verwenden von Meeting-Regionen für Amazon Chime SDK-Besprechungen](chime-sdk-meetings-regions.md)
+ [Besprechungen mit dem Amazon Chime SDK erstellen](create-mtgs.md)
+ [Auswahl von Meeting-Funktionen mithilfe des Amazon Chime SDK](js-meeting-features.md)
+ [So nutzen Amazon Chime SDK-Meetings WebRTC-Medien](webrtc-media.md)
+ [Konfiguration von Videocodecs für Amazon Chime SDK-Besprechungen](js-meeting-manage-codecs.md)
+ [Konfiguration Ihres Netzwerks für Amazon Chime SDK-Meetings](network-config.md)
+ [Grundlegendes zu den Ereignissen im Lebenszyklus von Besprechungen im Amazon Chime SDK](using-events.md)
+ [Grundlegendes zu CloudWatch Amazon-Metriken für Amazon Chime SDK-Besprechungen](sdk-usage-metrics.md)
+ [Amazon Chime SDK-Medien-Pipelines erstellen](media-pipelines.md)
+ [Live-Transkription mit Amazon Chime SDK verwenden](meeting-transcription.md)
+ [Verwenden der Medienreplikation für Amazon Chime SDK-Besprechungen](media-replication.md)
+ [Problembehandlung und Debuggen von Amazon Chime SDK-Besprechungen](troubleshoot-sdk-meetings.md)

# Migration zum Amazon Chime SDK-Namespace für Besprechungen
<a name="meeting-namespace-migration"></a>

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) ist ein spezieller Ort für diejenigen APIs , die Amazon Chime SDK-Meeting-Ressourcen erstellen und verwalten. Sie verwenden den Namespace, um Amazon Chime SDK-Meeting-API-Endpunkte in jeder AWS Region anzusprechen, in der sie verfügbar sind. Verwenden Sie diesen Namespace, wenn Sie gerade erst anfangen, das Amazon Chime SDK zu verwenden. Weitere Informationen zu Regionen finden Sie [Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md) in diesem Handbuch.

Bestehende Anwendungen, die den [Amazon Chime Chime-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) verwenden, sollten eine Migration zum dedizierten Namespace planen, um die neuesten APIs Funktionen nutzen zu können.

**Topics**
+ [Gründe für eine Migration](#migration-reasons)
+ [Bevor Sie migrieren](#before-migrating)
+ [Unterschiede zwischen den Namespaces](#namespace-differences)

## Gründe für eine Migration
<a name="migration-reasons"></a>

Aus den folgenden Gründen empfehlen wir Ihnen, zum [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) zu migrieren:

**Wahl des API-Endpunkts**  
Der Amazon Chime SDK Meetings-Namespace ist der einzige API-Namespace, der API-Endpunkte in jeder [Region verwenden kann,](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html) in der sie verfügbar sind. Wenn Sie andere API-Endpunkte als verwenden möchten`us-east-1`, müssen Sie den Amazon Chime SDK Meetings-Namespace verwenden.  
Weitere Informationen darüber, wie Amazon Chime SDK-Meetings AWS Regionen verwenden, finden Sie unter [Meeting-Regionen](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html) in diesem Handbuch.

**Aktualisiertes und neues Meeting APIs**  
Wir fügen nur Besprechungen APIs im Amazon Chime SDK Meetings-Namespace hinzu oder aktualisieren sie.

## Bevor Sie migrieren
<a name="before-migrating"></a>

Beachten Sie vor der Migration die Unterschiede zwischen den Namespaces. In der folgenden Tabelle sind sie aufgeführt und beschrieben.


|  | Amazon Chime SDK-Namespace für Besprechungen | Amazon Chime Chime-Namespace | 
| --- | --- | --- | 
| AWS SDK-Namespace | Glockenspiel SDKMeetings | Glockenspiel | 
| Regionen | Mehrere | nur us-east-1 | 
| Endpunkte | https://meetings-chime. region .amazonaws.com | https://service.chime.aws.amazon.com | 
| Direktor des Dienstes | meetings.chime.amazonaws.com | chime.amazonaws.com | 
| APIs | Nur für Besprechungen APIs  | APIs für Besprechungen und andere Teile von 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) | ExternalMeetingIdund MediaRegion sind erforderlich. | ExternalMeetingId und MediaRegion sind optional. | 
| [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeetingWithAttendees.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeetingWithAttendees.html) | ExternalMeetingIdund MediaRegion sind erforderlich.  | ExternalMeetingId und MediaRegion sind optional. | 
| ListMeetings | Nicht verfügbar | Verfügbar | 
| ExternalMeetingId | Die Validierung beinhaltet den Musterabgleich | Verfügbar | 
| ExternalUserId | Die Validierung umfasst den Musterabgleich  | Verfügbar | 
| Stichwörter für Besprechungen APIs | TagResource, UntagResource, ListTagsForResource | TagMeeting, UntagMeeting, ListMeetingTags | 
| Stichwörter für Teilnehmer | Nicht verfügbar | Verfügbar | 
| Echoreduzierung | Verfügbar | Nicht verfügbar | 
| Identifizierung der Live-Transkriptionssprache | Verfügbar | Nicht verfügbar | 
| Funktionen der Teilnehmer | Verfügbar | Nicht verfügbar | 
| Medienreplikation | Verfügbar | Nicht verfügbar | 
| AppKeys und TenantIds | Verfügbar | Nicht verfügbar | 
| Medien-Pipelines | Medien-Pipelines unterstützen mehrere Regionen im Amazon Chime SDK Meetings-Namespace. Weitere Informationen finden Sie unter [Migration zum Amazon Chime SDK Media Pipelines Namespace](migrate-pipelines.md). | Verfügbar über den Endpunkt us-east-1 | 
| SIP-Medienanwendung | JoinChimeMeetingAktion erfordert MeetingId | JoinChimeMeetingAktion erfordert nicht MeetingId | 
|  **Direkte SIP-Integration**  | Nicht verfügbar | Verfügbar | 

## Unterschiede zwischen den Namespaces
<a name="namespace-differences"></a>

In den folgenden Abschnitten werden die Unterschiede zwischen den Namespaces und erklärt. `Amazon Chime` `Amazon Chime SDK Meetings`

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

Der Amazon Chime SDK-Namespace verwendet den `Chime` formalen Namen. Der Amazon Chime SDK Meetings-Namespace verwendet den `ChimeSDKMeetings` formalen Namen. Das genaue Format des Namens variiert je nach Plattform.

Wenn Sie beispielsweise das AWS SDK in Node.js verwenden, um Besprechungen zu erstellen, verwenden Sie eine Codezeile, um den Namespace zu adressieren.

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

Um zum Amazon Chime Meetings SDK zu migrieren, aktualisieren Sie diese Codezeile mit dem neuen Namespace und der Endpunktregion.

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

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

Der [Amazon Chime Chime-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) kann nur API-Endpunkte in der Region us-east-1 adressieren. Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) kann Amazon Chime SDK-Meeting-API-Endpunkte in jeder Region adressieren, in der sie verfügbar sind. Eine aktuelle Liste der Meeting-Regionen finden Sie in diesem Handbuch. [Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md)

### Endpunkte
<a name="endpoint-diffs"></a>

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) verwendet andere API-Endpunkte als der [Amazon](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) Chime Chime-Namespace.

Nur der Endpunkt, der zur Erstellung eines Meetings verwendet wurde, kann verwendet werden, um es zu ändern. Das bedeutet, dass ein Meeting, das über einen Endpunkt in EU-CENTRAL-1 erstellt wurde, nur über EU-CENTRAL-1 geändert werden kann. Das bedeutet auch, dass Sie ein Meeting, das über den Namespace erstellt wurde, nicht adressieren können, in dem sich der Namespace befindet`Chime`. `ChimeSDKMeetings` `US-EAST-1` Weitere Informationen zu den aktuellen Endpunkten finden Sie [API-Zuordnung](migrate-from-chm-namespace.md#name-end-map) in diesem Handbuch.

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

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) verwendet einen neuen Dienstprinzipal:. `meetings.chime.amazonaws.com` Wenn Sie SQS-, SNS- oder andere IAM-Zugriffsrichtlinien haben, die Zugriff auf den Service gewähren, müssen Sie diese Richtlinien aktualisieren, um Zugriff auf den neuen Service Principal zu gewähren.

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

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) enthält nur Informationen APIs zum Erstellen und Verwalten von Besprechungen. Der [Amazon Chime Chime-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) umfasst APIs für Besprechungen und andere Teile des Amazon Chime Chime-Dienstes.

### CreateMeeting erforderliche Felder
<a name="create-meeting-diffs"></a>

Im Amazon Chime SDK Meetings-Namespace ist der [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) und [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 erfordern die `ExternalMeetingId` Angabe der `MediaRegion` Felder und.

### Externe ID-Werte
<a name="external-id-diffs"></a>

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) erzwingt eine zusätzliche Validierung der Werte, die für und verwendet werden können. `ExternalMeetingId` `ExternalUserId`

### Reduzierung des Echos
<a name="echo-reduction-diffs"></a>

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) bietet eine auf maschinellem Lernen basierende Echoreduzierung, um zu verhindern, dass Geräusche und Geräusche aus dem lokalen Lautsprecher zurück in das Meeting zirkulieren. Weitere Informationen finden Sie in der Anleitung unter. GitHub 

### Fähigkeiten der Teilnehmer
<a name="capabilities-diffs"></a>

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) bietet eine detaillierte Kontrolle über die Funktionen eines Teilnehmers innerhalb eines Meetings zum Senden und Empfangen von Audio, Video und Inhalten.

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

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) bietet Medienreplikation, um ein primäres Meeting mit Replikat-Meetings zu verknüpfen, sodass bis zu 10.000 Personen zu einer Echtzeitsitzung zusammenkommen. Teilnehmer, die mit einer Replikatsitzung verbunden sind, erhalten die Medien der Moderatoren, die mit der primären Sitzung verbunden sind. Sie können jedoch zur primären Sitzung befördert werden. Weitere Informationen finden Sie [Verwenden der Medienreplikation für Amazon Chime SDK-Besprechungen](media-replication.md) in diesem Handbuch.

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

Der [Amazon Chime SDK Meetings-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) bietet eine Möglichkeit, den Zugriff von einem Netzwerk auf bestimmte Amazon Chime SDK-Meetings zu beschränken. Weitere Informationen finden Sie [Verwendung AppKeys und Mandant IDs für Amazon Chime SDK](app-keys-tenant-ids.md) in diesem Handbuch.

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

Amazon Chime SDK-Medien-Pipelines funktionieren mit Meetings, die von einem beliebigen Meeting-Endpunkt erstellt wurden, entweder mit dem [Amazon Chime SDK Meetings oder dem [Amazon](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) Chime Chime-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html). Die aktuelle Liste der [Medien-Pipeline-Regionen finden Sie unter Verfügbare Regionen](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html).

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

Amazon Chime SDK SIP-Medienanwendungen funktionieren mit Meetings, die von einem beliebigen Meeting-Endpunkt erstellt wurden, entweder mit dem [Amazon Chime SDK Meetings oder dem Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) [Chime-Namespace](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html). Wenn Sie SIP-Medienanwendungen mit einem Meeting verwenden, das über den Amazon Chime SDK Meetings-Namespace erstellt wurde, erfordert die [JoinChimeMeeting](join-chime-meeting.md) Aktion den `MeetingId` Parameter.

### Zusätzliche APIs
<a name="additional-api-diffs"></a>

Im Meetings-Namespace gibt es immer mehr APIs , was der Chime-Namespace nicht hat. Wenn Sie mit dem Amazon Chime SDK beginnen, verwenden Sie den Meetings-Namespace, um auf die neuesten Funktionen zuzugreifen. 

# Verwenden von Meeting-Regionen für Amazon Chime SDK-Besprechungen
<a name="chime-sdk-meetings-regions"></a>

Amazon Chime SDK-Meetings haben *Kontrollregionen* und *Medienregionen*. Kontrollregionen verfügen über einen API-Endpunkt, der zum Erstellen, Aktualisieren und Löschen von Besprechungen verwendet wird. In den Medienregionen finden die eigentlichen Treffen statt.

In der Regel verwendet Ihr Anwendungsdienst das [AWS SDK](https://aws.amazon.com/tools/), um die Kontrollregionen zu [signieren und aufzurufen](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) APIs . Ihr Anwendungsclient verwendet die Amazon Chime SDK-Clientbibliotheken für [JavaScript](js-sdk-intro.md)[iOS](sdk-for-ios.md) oder [Android](sdk-for-android.md), um eine Verbindung zum Meeting in Media Regions herzustellen.

Eine Kontrollregion kann ein Meeting in jeder Medienregion in derselben AWS Partition erstellen. Sie können ein Meeting jedoch nur in der Kontrollregion aktualisieren, in der es erstellt wurde. Um die Medienregion zu finden, die einem Kunden am nächsten ist, rufen Sie [https://nearest-media-region.l.chime.aws](https://nearest-media-region.l.chime.aws) an.

[Besprechungsereignisse](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#sdk-events) wie `AttendeeJoined` Anruf [EventBridge, Amazon Simple Queue Service (SQS) oder Amazon Simple Notification Service (SNS)](https://docs.aws.amazon.com/chime-sdk/latest/dg/mtgs-sdk-notifications.html) in der Meeting-Kontrollregion.

 Eine Liste der verfügbaren Amazon Chime SDK-Regionen zur Steuerung von Besprechungen und Medien finden Sie [Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md) in diesem Handbuch.

Dieses Diagramm zeigt den typischen Datenfluss durch die Kontroll- und Medienregionen.

![\[Diagramm, das den Datenfluss durch die Amazon Chime SDK-Steuerungs- und Medienregionen zeigt.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/control-media-regions.png)


## Auswahl einer Kontrollregion
<a name="choose-meeting-region"></a>

Beachten Sie bei der Auswahl einer Kontrollregion für ein Amazon Chime SDK-Meeting die folgenden Faktoren:
+ **Regulatorische Anforderungen.** Muss sich Ihre Anwendung innerhalb einer geopolitischen Grenze befinden oder muss sie einen Endpunkt mit FIPS 140-2-validierten kryptografischen Modulen verwenden?
+ **API-Latenz.** Die Verwendung der Kontrollregion, die der AWS Region Ihres Anwendungsdienstes am nächsten liegt, kann dazu beitragen, die APIs Netzwerklatenz zu reduzieren. Dies wiederum trägt dazu bei, den Zeitaufwand für die Erstellung von Besprechungen zu reduzieren und die Benutzer können schneller an Besprechungen teilnehmen.
+ **Hohe Verfügbarkeit**. Sie können mehrere Kontrollregionen verwenden, um Hochverfügbarkeitsarchitekturen zu implementieren. Jede Kontrollregion arbeitet jedoch unabhängig. Außerdem können Sie Besprechungen nur in der Kontrollregion aktualisieren, in der sie erstellt wurden. Außerdem müssen Sie dieselbe Region verwenden, um Besprechungsereignisse mit [ EventBridgeAmazon Simple Queue Service (SQS) oder Amazon Simple Notification Service (SNS](https://docs.aws.amazon.com/chime-sdk/latest/dg/mtgs-sdk-notifications.html)) zu nutzen.

## Wählen Sie eine Medienregion
<a name="choose-media-region"></a>

**Anmerkung**  
Wir empfehlen, dass Sie in der [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-Aktion immer einen Wert im `MediaRegion` Parameter angeben. Weitere Informationen zu den Regionen finden Sie unter[Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md).

Berücksichtigen Sie bei der Auswahl einer Medienregion, die Sie für Ihr Amazon Chime SDK-Meeting verwenden möchten, die folgenden gemeinsamen Faktoren:

**Regulatorische Anforderungen**  
Wenn Ihre Amazon Chime SDK-Meetings gesetzlichen Bestimmungen unterliegen, die vorschreiben, dass sie innerhalb einer geopolitischen Grenze abgehalten werden müssen, sollten Sie erwägen, die Meeting-Region auf der Grundlage einer festen Anwendungslogik fest zu codieren.  
Für eine Telemedizin-Anwendung könnte es beispielsweise erforderlich sein, dass alle Besprechungen im Zuständigkeitsbereich des Arztes abgehalten werden. Wenn die Anwendung Kliniken unterstützt, die sich sowohl in Europa als auch in den Vereinigte Staaten befinden, können Sie die Adresse jeder Klinik verwenden, um eine Region in ihrem Zuständigkeitsbereich auszuwählen. 

**Qualität des Treffens**  
Wenn ein Amazon Chime SDK-Meeting in einer Medienregion veranstaltet wird, werden die Audio- und Videodaten aller Teilnehmer aus dieser Region gesendet und empfangen. Mit zunehmender Entfernung zwischen dem Teilnehmer und der Region kann die Qualität des Meetings durch die Netzwerklatenz beeinträchtigt werden. Die Angabe einer Region für Ihr Amazon Chime SDK-Meeting kann dazu beitragen, die Meeting-Qualität für Ihre Teilnehmer zu verbessern, unabhängig davon, ob sie sich nahe beieinander befinden oder geografisch verteilt sind.

Sie können eine der folgenden Methoden verwenden, um eine Medienregion für Ihr Amazon Chime SDK-Meeting auszuwählen:

**Eine Medienregion fest codieren**  
Empfohlen, wenn Ihre Amazon Chime SDK-Meetings alle in einer bestimmten AWS Region gehostet werden.

**Wählen Sie die nächstgelegene Medienregion**  
Empfohlen, wenn sich Ihre Amazon Chime SDK-Meeting-Teilnehmer in derselben AWS Region befinden, Ihre Meetings jedoch in verschiedenen Regionen veranstaltet werden.

## Finden Sie die nächstgelegene Medienregion
<a name="choose-nearest-media-region"></a>

Rufen Sie [https://nearest-media-region.l.chime.aws](https://nearest-media-region.l.chime.aws) an, um die nächste Medienregion zu finden, in der ein Amazon Chime SDK-Meeting abgehalten werden kann. Dieser Endpunkt gibt eine einzelne Region zurück, z. B. `{"region": "us-west-2"}` Rufen Sie die URL von Ihrer Client-Anwendung aus auf, um die Region zu identifizieren, die dem Benutzer am nächsten ist, und verwenden Sie dann das Ergebnis im `MediaRegion` [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-Parameter, um das Meeting in dieser Region zu erstellen.

Normalerweise rufen Sie die URL auf, wenn die Client-Anwendung gestartet wird oder wenn sich ihre Netzwerkverbindung ändert. Indem Sie die nächstgelegene Region im Voraus festlegen, vermeiden Sie, dass die Latenz des Anrufs bei der Erstellung des Meetings erhöht wird.

## Finden Sie die nächstgelegene Medienregion AWS GovCloud (USA)
<a name="choose-gov-cloud-region"></a>

Rufen Sie [https://nearest-us-gov-media](https://nearest-us-gov-media-region.l.chime.aws)-region.l.chime.aws an, um die nächstgelegene Region AWS GovCloud (USA) zu finden, in der ein Amazon Chime SDK-Meeting stattfinden kann. Dieser Endpunkt gibt die nächstgelegene Region zurück, z. B. `{"region": "us-gov-west-1"}` Rufen Sie die URL in Ihrer Client-Anwendung auf, um die AWS GovCloud (USA), die dem Benutzer am nächsten ist, zu identifizieren, und verwenden Sie das Ergebnis im `MediaRegion` [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-Parameter, um das Meeting in dieser Region zu erstellen.

Normalerweise rufen Sie die URL auf, wenn die Client-Anwendung gestartet wird oder wenn sich ihre Netzwerkverbindung ändert. Indem Sie die nächstgelegene Region im Voraus festlegen, vermeiden Sie, dass die Latenz des Anrufs bei der Erstellung des Meetings erhöht wird.

## JavaScript Beispiel
<a name="region-javascript"></a>

Das folgende Beispiel verwendet HTML und JavaScript , um die nächstgelegene Medienregion und AWS GovCloud (US) Medienregion zurückzugeben.

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

## Überprüfen des Status der Region
<a name="region-status"></a>

Rufen Sie [https://region.status.chime.aws/](https://region.status.chime.aws/) auf, um den Status des Amazon Chime SDK-Service in jeder Region abzurufen. Das Ergebnis zeigt die empfohlenen Regionen. Wenn eine Medienregion einen anderen Status als **empfohlen** hat, gibt der nächstgelegene Endpunkt der Medienregion diese Region nicht zurück.

Das folgende Beispiel zeigt ein typisches Ergebnis.

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

# Besprechungen mit dem Amazon Chime SDK erstellen
<a name="create-mtgs"></a>

Das folgende Verfahren zeigt, wie Sie ein Meeting mit Audio und Video für Ihre Server- und Client-Anwendungen erstellen. Bevor Sie beginnen, müssen Sie Ihre Client-Anwendung in eine Amazon Chime SDK-Clientbibliothek integrieren. Weitere Informationen finden Sie unter [Erfahren Sie mehr über die Amazon Chime SDK-Clientbibliotheken](mtgs-sdk-client-lib.md).

**Um ein Meeting mit Audio und Video zu erstellen**

1. Führen Sie in Ihrer Serveranwendung die folgenden Schritte aus:

   1. Verwenden Sie die [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-Aktion in der *Amazon Chime SDK API-Referenz*, um ein Meeting zu erstellen. Geben Sie mithilfe des `MediaRegion` Parameters eine AWS Region an. Weitere Informationen zur Auswahl einer Meeting-Region finden Sie unter[Regionen treffen](sdk-available-regions.md#sdk-meeting-regions).

   1. Fügen Sie mithilfe der [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-Aktion oder der API-Aktion Teilnehmer zum [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)Meeting hinzu. Übertragen Sie das Meeting und den Teilnehmer sicher von Ihrer Serveranwendung auf den Client, der als der jeweilige Teilnehmer autorisiert ist. Weitere Informationen zu Besprechungen und Teilnehmern finden Sie unter [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)und [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)in der *Amazon Chime SDK API-Referenz.*

1. Führen Sie in Ihrer Client-Anwendung die folgenden Schritte aus:

   1. Verwenden Sie eine Amazon Chime SDK-Clientbibliothek, um ein `MeetingSessionConfiguration` Objekt zu erstellen. Verwenden Sie die Besprechungs- und Teilnehmerinformationen aus den vorherigen Schritten.

   1. Implementieren Sie die `AudioVideoObserver`-Schnittstelle.

   1. Erstellen Sie eine `MeetingSession` mit dem`MeetingSessionConfiguration`.

   1. Verwenden Sie das `AudioVideoFacade` von`MeetingSession`, um Medien in Echtzeit zu steuern.

      1. Registrieren Sie eine Instanz der `AudioVideoObserver` Schnittstelle. Auf diese Weise können Sie Ereignisse empfangen, wenn sich der Status der Besprechung ändert.

      1. Wählen Sie die ersten Geräte für den Audioeingang, den Audioausgang und den Videoeingang aus.

      1. Starten Sie die audiovisuelle Sitzung.

      1. Starten Sie die lokale Videoaufnahme, wenn der Benutzer ein Video teilen möchte.

      1. Um Videokacheln anzuzeigen, verwalten Sie Video-Kachel-Ereignisse und binden Sie die Kacheln in der Client-Anwendung an Videooberflächen.

      1. Verwalten Sie andere Benutzerinteraktionen wie das Stummschalten und Aufheben der Stummschaltung oder das Starten und Beenden der lokalen Videoaufnahme.

      1. Um das Meeting zu verlassen, beenden Sie die audiovisuelle Sitzung.

   1. (Optional) Verwenden Sie die Option `AudioVideoFacade` von, `MeetingSession` um Medieninhalte, wie z. B. Screenshots, mit anderen Kunden zu teilen.

      1. Starten Sie die Bildschirmfreigabesitzung. Der Inhalt nimmt als weiterer Teilnehmer an der Besprechung teil.

      1. Um die geteilten Inhalte anzusehen, verwalten Sie Video-Kachel-Ereignisse und binden Sie die Kacheln in der Client-Anwendung an Oberflächen.

      1. Verwalten Sie andere Interaktionen, z. B. das Anhalten, Neustarten oder Stoppen der Inhaltsfreigabe.

Besprechungen enden, wenn Sie die [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-Aktion ausführen. Außerdem enden Besprechungen automatisch, wenn:
+ Die Besprechungszeit beträgt mehr als 24 Stunden.
+ Die Besprechung ist eine [Replikatbesprechung](media-replication.md) und die Hauptbesprechung endet.
+ Bei einer Besprechung, bei der es sich nicht um eine Replikatbesprechung handelt, haben fünf Minuten lang keine Teilnehmer eine Verbindung hergestellt.

# Auswahl von Meeting-Funktionen mithilfe des Amazon Chime SDK
<a name="js-meeting-features"></a>

Wenn Sie die [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 aufrufen, können Sie Funktionen angeben, die den Clients zur Verfügung gestellt werden sollen, die an der Sitzung teilnehmen. Beachten Sie, dass für einige Funktionsoptionen zusätzliche Gebühren anfallen.

Die folgenden Funktionen sind für Sitzungen verfügbar:
+ `Audio.EchoReduction`— Echoreduzierung durch maschinelles Lernen.
+ `Video.MaxResolution`— Maximale Webcam-Videoauflösung.
+ `Content.MaxResolution`— Maximale Auflösung für die gemeinsame Nutzung von Inhalten..
+ `Attendees.MaxCount`— Maximale Anzahl von Teilnehmern.

**Topics**
+ [Audio verwenden. EchoReduction](#audio-echo-reduction)
+ [Video verwenden. MaxResolution](#video-max-resolution)
+ [Inhalte verwenden. MaxResolution](#js-content-resolution)
+ [Teilnehmer verwenden. MaxCount](#js-max-attendees)
+ [Verwenden von Meeting-Funktionen in einer Client-App](#meeting-features-client-app)

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

Wird verwendet`Audio.EchoReduction`, um zu verhindern, dass der Ton aus dem Lautsprecher eines Benutzers in das Meeting zurückfließt.

Die Echoreduzierung ist ideal für Situationen, in denen der Lautsprecher eines Benutzers das primäre Ausgabegerät für die Audiowiedergabe in Besprechungen sein wird. Dies ist beispielsweise der Fall, wenn mehrere Benutzer von demselben Gerät in einem Konferenzraum aus an einer Besprechung teilnehmen oder wenn ein einzelner entfernter Teilnehmer keine Kopfhörer trägt.

Die Echoreduzierung ist in den Client-Bibliotheken JavaScript und in den React-Clientbibliotheken verfügbar. Weitere Informationen finden Sie in der [Dokumentation zu GitHub](https://aws.github.io/amazon-chime-sdk-js/modules/amazonvoice_focus.html#what-is-echo-reduction). Es fallen zusätzliche Kosten an. Weitere Informationen finden Sie auf der [Seite mit den Amazon Chime SDK-Preisen](https://aws.amazon.com/chime/chime-sdk/pricing/).

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

Verwenden Sie diese `Video.MaxResolution` Option, um die maximale Webcam-Videoauflösung für das Meeting anzugeben. Die Funktion bietet die folgenden Optionen:
+ `None`: kein Kameravideo erlaubt
+ `HD`: hochauflösendes Kameravideo (1280x720p)
+ `FHD`: full-high-definition Kamera-Video (1920x1080)

Wenn FHD-Video (1080p) angefordert wird, wird eine hochauflösende WebRTC-Sitzung erstellt. Weitere Informationen finden Sie auf der [Seite mit den Amazon Chime SDK-Preisen](https://aws.amazon.com/chime/chime-sdk/pricing/).

Wenn ein Kunde versucht, ein Webcam-Video über einem bestimmten Höchstwert zu senden, lehnt der Service das Video ab und sendet den folgenden Fehler:

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

## Inhalte verwenden. MaxResolution
<a name="js-content-resolution"></a>

Verwenden Sie diese `Content.MaxResolution` Option, um die maximale Auflösung für die gemeinsame Nutzung von Inhalten für das Meeting festzulegen. Die Funktion bietet die folgenden Optionen: 
+ `None`: Das Teilen von Inhalten ist nicht erlaubt
+ `FHD`: full-high-definition Inhalte teilen (1920x1080)
+ `UHD`: ultra-high-definition Inhalte teilen (3840x2160)

Wenn UHD (4K) -Inhalte angefordert werden, wird eine hochauflösende WebRTC-Sitzung erstellt.

Wenn ein Client versucht, eine Inhaltsfreigabe zu senden, die die maximale Auflösung überschreitet, wird diese Auflösung auf das angegebene Maximum herunterskaliert. Sie skalieren, indem Sie `MediaTrackConstraints` es auf den Track „Content Share“ anwenden. Die folgenden Beispiele zeigen, wie Sie einen Share-Track skalieren können.

```
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})`
    );
  }
```

Die folgende Tabelle zeigt das erwartete Verhalten beim Teilen von Inhalten.


| Funktion „Inhalt“ | Inhalte teilen sich die native Auflösung | Skalierung | Auflösung der Inhaltscodierung | 
| --- | --- | --- | --- | 
|  FHD | 1 280 x 720  | Nein | 1 280 x 720 | 
| FHD | 1 920 x 1 080 | Nein | 1 920 x 1 080 | 
| FHD | 3840x2160 | Ja | 1 920 x 1 080 | 
| UHD | 1 920 x 1 080 | Nein | 1 920 x 1 080 | 
| UHD | 3840x2160 | Nein | 3840x2160 | 
| UHD | 4200x2400 | Ja | 3780 x 2160 | 

## Teilnehmer verwenden. MaxCount
<a name="js-max-attendees"></a>

Verwenden Sie diese `Attendee.MaxCount` Option, um die maximale Anzahl von Teilnehmern anzugeben, die an einer Besprechung teilnehmen dürfen. Die Obergrenze für Teilnehmer. MaxCount hängt vom Sitzungstyp ab. Für eine Standardsitzung können Sie maximal 250 Teilnehmer auswählen. Für eine Sitzung mit hoher Auflösung *müssen* Sie einen Wert von bis zu 25 Teilnehmern auswählen. 

Wenn Sie FHD-Video (1080p) oder UHD-Inhalte (4K) anfordern, handelt es sich bei Ihrer Sitzung um eine Sitzung mit hoher Auflösung.

Für Sitzungen mit hoher Auflösung fallen Kapazitätskosten für die Teilnehmer an. Weitere Informationen finden Sie auf der [Seite mit den Amazon Chime SDK-Preisen](https://aws.amazon.com/chime/chime-sdk/pricing/).

## Verwenden von Meeting-Funktionen in einer Client-App
<a name="meeting-features-client-app"></a>



### Ein Meeting mit bestimmten Funktionen erstellen
<a name="js-create-meetings-sdk-namespace"></a>

Um ein Meeting zu erstellen, rufen Sie die [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 auf und geben Sie die gewünschten Meeting-Funktionen an. Das folgende Beispiel zeigt, wie Sie alle Funktionen angeben.

```
// 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();
```

### Verwenden von Besprechungsfunktionen in einem Client
<a name="js-client-level"></a>

Nachdem Sie ein Meeting mit den gewünschten Funktionen erstellt haben, können Sie das `joinInfo` bei der Erstellung des `MeetingSessionConfiguration` Objekts übergeben. Die Meeting-Funktionen werden bei der `meetingSession` Erstellung verwendet, um die Auflösung und Bitrate des Webcam-Videos sowie die Auflösung und Bitrate für die gemeinsame Nutzung von Inhalten festzulegen.

```
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)
);
```

# So nutzen Amazon Chime SDK-Meetings WebRTC-Medien
<a name="webrtc-media"></a>

Das Amazon Chime SDK unterstützt zwei Arten von WebRTC-Sitzungen: Standard- und High-Definition-Sitzungen. In den folgenden Themen werden die Medien beschrieben, die in den einzelnen Sitzungstypen verfügbar sind, wenn Sie die Amazon Chime SDK-Clientbibliotheken für React JavaScript, iOS und Android verwenden.

**Topics**
+ [Audio](#webrtc-audio)
+ [Video](#video)
+ [Inhalte teilen](#content-share)
+ [Datennachrichten](#data-messages)

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

Jeder Amazon Chime Chime-Client sendet einen Audiostream an die Sitzungen und empfängt einen Audiostream von der Sitzung. In der Regel erzeugen Mikrofone auf lokalen Geräten das Audio. Das empfangene Audio ist eine Mischung aus dem Audio, das von den anderen Sitzungsclients gesendet wurde.

Beide Sitzungstypen unterstützen Abtastraten von bis zu 48 kHz und bis zu 2 Kanäle (Stereo), die mit Bitraten von bis zu 128 kbit/s unter Verwendung des Opus-Codec codiert sind. Die gesendeten und empfangenen Audiostreams variieren jedoch je nach Typ der Clientbibliothek:
+ Die Amazon Chime SDK-Clientbibliotheken für JavaScript und React unterstützen das Senden und Empfangen von mono- und Stereo-Audio mit der höchsten vom Gerät und Browser unterstützten Samplerate, bis zu einem Maximum von 48 kHz.
+ Die Amazon Chime SDK-Clientbibliotheken für iOS und Android unterstützen das Senden von Mono-Audio mit bis zu 48 kHz und das Empfangen von Stereo-Audio mit 48 kHz.

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

Jeder Amazon Chime Chime-Client kann einen Videostream an die Sitzung senden und bis zu 25 Videostreams von der Sitzung empfangen. Das gesendete Video stammt in der Regel von der Webcam des lokalen Geräts. Jeder Client kann bis zu 25 Videostreams für den Empfang auswählen und die Auswahl während der Sitzung jederzeit ändern. 

Standardsitzungen unterstützen Videoauflösungen von bis zu 1280 x 720 bei 30 Bildern pro Sekunde, codiert mit Bitraten von bis zu 1500 kbps unter Verwendung von H.264,, und. VP8 VP9 AV1

HD-Sitzungen unterstützen Videoauflösungen von bis zu 1920x1080 bei 30 Bildern pro Sekunde, codiert mit Bitraten von bis zu 2500 kbps unter Verwendung von H.264,, und. VP8 VP9 AV1

Die Amazon Chime SDK-Clientbibliotheken für JavaScript und React unterstützen das Senden von Videos im Simulcast mit 15 Bildern pro Sekunde oder mit skalierbarer Videokodierung (SVC). SVC kodiert einen einzelnen Videostream mit drei räumlichen Ebenen und drei zeitlichen Ebenen zu 100%, 50% und 25% Ihrer Zielwerte. Der Service wählt automatisch die Ebene aus, die an jeden Zuschauer gesendet werden soll, basierend auf der verfügbaren Bandbreite der Zuschauer.

Die Amazon Chime SDK-Clientbibliotheken für iOS und Android unterstützen das Senden von bis zu 15 Bildern pro Sekunde. Die tatsächliche Bildrate und Auflösung werden jedoch automatisch vom Amazon Chime SDK verwaltet.

Bei der Videokodierung und -dekodierung wird, soweit verfügbar, Hardwarebeschleunigung verwendet, um die Leistung zu verbessern.

 Wenn ein Client Video mit einer Bitrate sendet, die über der maximal zulässigen Bitrate liegt, beginnt die Sitzung zunächst mit dem Senden von Receiver-Nachrichten über die geschätzte maximale Bitrate des Clients über das Real-Time Control Protocol. Wenn der Client weiterhin Videos mit einer Bitrate sendet, die über der maximal zulässigen Bitrate liegt, verwirft die Sitzung die eingehenden Videostream-Pakete.

## Inhalte teilen
<a name="content-share"></a>

Bis zu zwei Kunden können Inhalte für die Sitzung gemeinsam nutzen. Eine gemeinsame Nutzung von Inhalten kann eine Videospur, eine Audiospur oder beides beinhalten. Ein gängiges Beispiel für eine gemeinsame Nutzung von Inhalten ist die Bildschirmübertragung, bei der Bildschirmaufnahmen als Quelle für den Inhalt verwendet werden. Ein anderes Beispiel ist das Teilen von aufgezeichneten Inhalten mit Video- und Audiotracks.

Die Audioinhalte werden in den von der Sitzung gesendeten Audiostream gemischt. Inhaltsaudio unterstützt Abtastraten von bis zu 48 kHz und bis zu 2 Kanäle (Stereo), die mit Bitraten von bis zu 128 Kbit/s unter Verwendung des Opus-Codec codiert sind.

Videoinhalte werden an die Sitzung gesendet und in einem separaten Videostream an die Clients weitergeleitet. Standardsitzungen unterstützen Inhaltsvideos mit einer Auflösung von bis zu 1920x1080 bei 30 Bildern pro Sekunde. HD-Sitzungen unterstützen Inhaltsvideos mit einer Auflösung von bis zu 3840 x 2160 bei 30 Bildern pro Sekunde.

Die Bildschirmaufnahme für die gemeinsame Nutzung von Inhalten verwendet die Auflösung des aufgenommenen Bildschirms oder Fensters bis zur maximalen Inhaltsauflösung für den Sitzungstyp und bis zu 30 Bilder pro Sekunde. Geräte- und Browserfunktionen können diese Werte jedoch einschränken.

Die Amazon Chime SDK-Clientbibliotheken für JavaScript und React unterstützen die gemeinsame Nutzung von Inhalten aus Bildschirmaufnahmen und anderen Quellen.

Die Amazon Chime SDK-Clientbibliotheken für iOS und Android unterstützen nur die gemeinsame Nutzung von Inhalten aus Bildschirmaufnahmen.

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

Datennachrichten bieten einem Client die Möglichkeit, Informationen an andere Clients in der Sitzung zu senden. Beispielsweise kann eine Anwendung Datennachrichten verwenden, um Emoji-Reaktionen während einer Sitzung auszutauschen.

Jede Datennachricht beinhaltet:
+ Ein Thema, eine Zeichenfolge mit bis zu 64 Zeichen.
+ Bis zu 2 KB an Daten, einschließlich des Themas.

Ein Client sendet eine Datennachricht an die Sitzung, und die Sitzung sendet die Datennachricht an alle verbundenen Clients.

In der Sitzung kann die Datennachricht optional für bis zu fünf Minuten zwischengespeichert werden. Wenn ein Client einer Sitzung beitritt oder erneut eine Verbindung herstellt, sendet die Sitzung dem Client automatisch alle zwischengespeicherten Datennachrichten, die zuvor nicht gesendet wurden. Der Sitzungscache speichert maximal 1024 Datennachrichten.

Eine Sitzung unterstützt bis zu 100 gesendete Datennachrichten pro Sekunde. Bei der [Live-Transkription](https://docs.aws.amazon.com/chime-sdk/latest/dg/meeting-transcription.html) empfängt jeder Client [Transkriptionsnachrichten](https://docs.aws.amazon.com/chime-sdk/latest/dg/process-msgs.html) über Datennachrichten, die auf die Gesamtzahl der gesendeten Nachrichten pro Sekunde angerechnet werden.

# Konfiguration von Videocodecs für Amazon Chime SDK-Besprechungen
<a name="js-meeting-manage-codecs"></a>

Ein Client-Gerät verwendet einen Videocodec, um Rohvideos zu komprimieren, bevor sie an den Service gesendet werden, und um empfangene Videos zu dekomprimieren, bevor sie gerendert werden.

Wenn Sie die Amazon Chime SDK-Clientbibliothek für verwenden JavaScript, können Sie Ihre Codec-Einstellungen für das Senden von Videos angeben. 

Die Amazon Chime SDK-Clientbibliotheken für iOS und Android wählen automatisch den Codec für Sie aus, basierend auf den Funktionen des Geräts.

## Einstellung der Videocodec-Einstellungen
<a name="codec-list"></a>

In der Amazon Chime SDK-Clientbibliothek für JavaScript können Sie unabhängige Videocodec-Einstellungen für Webcam- und Inhaltsvideos angeben. 

[Verwenden Sie die. AudioVideoControllerFacade setVideoCodecSendPreferences ](https://aws.github.io/amazon-chime-sdk-js/interfaces/audiovideocontrollerfacade.html#setvideocodecsendpreferences)Funktion, um Ihre Codec-Einstellungen für das Senden von Webcam-Videos festzulegen. Der Link führt Sie zu GitHub.

Ihre Einstellungen werden als geordnetes Array übergeben, wobei Ihr bevorzugter Codec an erster Stelle und Ihr am wenigsten bevorzugter Codec zuletzt steht. 

Wenn Sie mehrere Codec-Einstellungen angeben, wählt der Dienst automatisch den am meisten bevorzugten Codec aus, den alle Sitzungsteilnehmer dekodieren können.

Das folgende Beispiel zeigt, wie Sie eine Videocodec-Präferenz VP9 mit der folgenden Fallback-Option festlegen: VP8

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

Die folgenden Szenarien gelten für die Einstellungen:
+ **Optimal** — Der Client codiert das Video mit dem VP9 Codec.
+ **Lokaler Fallback** — Wenn der Client die Kodierung nicht unterstützt, wird auf die VP9 Kodierung zurückgegriffen. VP8 Wenn der Client die VP8 Kodierung nicht unterstützt, greift er auf einen beliebigen Codec zurück, der vom Browser und vom Dienst unterstützt wird.
+ **Remote-Fallback** — Wenn ein anderer Client in der Sitzung keinen VP9 Decoder hat, greift dieser Client auf die Kodierung zurück. VP8 
+ **Lokaler Fehler** — Wenn der Client keine VP8 Kodierung unterstützt VP9, sendet er kein Video.

Um Einstellungen für das Teilen von Inhalten festzulegen, verwenden Sie den [ ContentShareControllerFacade. setContentShareVideoCodecPreferences ](https://aws.github.io/amazon-chime-sdk-js/interfaces/contentsharecontrollerfacade.html#setcontentsharevideocodecpreferences)Funktion, um Ihre Codec-Einstellungen für das Senden von Inhaltsvideos festzulegen. Dieser Link führt Sie zu GitHub.

 Im folgenden Beispiel wird eine Video-Codec-Präferenz für Inhalte VP9 mit der Fallback-Option von festgelegt. VP8

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

# Konfiguration Ihres Netzwerks für Amazon Chime SDK-Meetings
<a name="network-config"></a>

Wenn Sie das Amazon Chime SDK in Ihre Client-Anwendung integrieren, stellt das SDK eine Verbindung zu seinem Back-End-Service her, um Audio-, Video-, Content Sharing- und Datennachrichten zu senden und zu empfangen. Wenn das Netzwerk Ihrer Benutzer den Datenverkehr zum Amazon Chime SDK-Service blockiert, wird ihre Fähigkeit, den Service zu nutzen, beeinträchtigt. Netzwerkadministratoren können diese Informationen verwenden, um ihr Netzwerk neu zu konfigurieren, um den Zugriff auf den Amazon Chime SDK-Service zu ermöglichen.

**Anmerkung**  
Wenn Sie Ihr Netzwerk konfigurieren, müssen Sie standardmäßig Extension Mechanisms for DNS (EDNS0) aktivieren. Dadurch kann Ihre Anwendung die Amazon Chime SDK-Dienste erreichen, indem sichergestellt wird, dass die Hostinformationen die richtige Größe für UDP-Pakete haben.

**Topics**
+ [Konfiguration für Medien und Signalisierung](#media-signaling)
+ [Konfiguration für Amazon Voice Focus](#voice-focus-config)
+ [Konfiguration für Echoreduzierung](#echo-reduction)
+ [Konfiguration für Hintergrundersetzung und Unschärfe](#config-blur)
+ [Konfiguration der Sicherheitsrichtlinien für Browserinhalte](#configure-browser-policy)
+ [Verwendung AppKeys und Mandant IDs für Amazon Chime SDK](app-keys-tenant-ids.md)

## Konfiguration für Medien und Signalisierung
<a name="media-signaling"></a>

Audio, Video und Inhalt des Amazon Chime SDK verwenden wann immer möglich den UDP-Transport (User Datagram Protocol). Wenn UDP blockiert ist, versucht das Amazon Chime SDK, eine Transport Layer Security (TLS) -Verbindung für den bidirektionalen Medientransport herzustellen. Signal- und Datennachrichten im Amazon Chime SDK verwenden Transmission Control Protocol (TCP) und WebSocket Verbindungen.

Das folgende Diagramm zeigt ein typisches Netzwerk mit einer Anwendung, die das Amazon Chime SDK ausführt. 

![\[Ein Netzwerk, das für die Ausführung einer Amazon Chime SDK-Anwendung konfiguriert ist, mit bidirektionaler Kommunikation zwischen dem SDK und einem Meeting.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/net-config-diagram.png)


Das Amazon Chime SDK verwendet die folgenden Ziele und Ports für Medien und Signalisierung.


| Bereich | IPv4 Subnetz | IPv6 Subnetz | Ports | 
| --- | --- | --- | --- | 
| \$1.chime.aws | 99.77.128.0/18 | 2600:f0f 0:4100: :/40 | TCP:443 UDP:3478 | 

[Dieses Subnetz ist der Dienst in den IP-Adressbereichen. `CHIME_MEETINGS`AWS](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html)

## Konfiguration für Amazon Voice Focus
<a name="voice-focus-config"></a>

Die Amazon Chime SDK-Clientbibliotheken für iOS und Android beinhalten das Amazon Voice Focus-Modul. Die Amazon Chime SDK-Clientbibliothek zum JavaScript Herunterladen des Amazon Voice Focus-Moduls von Amazon CloudFront. Die Amazon Chime SDK-Clientbibliothek für Windows unterstützt Voice Focus nicht.

Amazon Voice Focus verwendet die folgenden Ziele und Häfen.


| Bereich | Ports | 
| --- | --- | 
| \$1.sdkassets.chime.aws | TCP:443 | 

[Dieses Subnetz ist der Dienst in den IP-Adressbereichen. `CLOUDFRONT`AWS](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html)

## Konfiguration für Echoreduzierung
<a name="echo-reduction"></a>

Die Amazon Chime SDK-Clientbibliothek zum JavaScript Herunterladen des Echoreduzierungsmoduls von Amazon CloudFront.

Die Echoreduzierung verwendet die folgenden Ziele und Ports.


| Bereich | Ports | 
| --- | --- | 
| \$1.sdkassets.chime.aws | TCP:443 | 

[Dieses Subnetz ist der Dienst in den IP-Adressbereichen. `CLOUDFRONT`AWS](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html)

## Konfiguration für Hintergrundersetzung und Unschärfe
<a name="config-blur"></a>

Die Amazon Chime SDK-Clientbibliothek zum JavaScript Herunterladen des Moduls für Hintergrundersetzung und Unschärfe von Amazon. CloudFront

Background Replacement and Blur verwendet die folgenden Ziele und Ports.


| Bereich | Ports | 
| --- | --- | 
| \$1.sdkassets.chime.aws | TCP:443 | 

[Dieses Subnetz ist der Dienst in den IP-Adressbereichen. `CLOUDFRONT`AWS](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html)

## Konfiguration der Sicherheitsrichtlinien für Browserinhalte
<a name="configure-browser-policy"></a>

Wenn Sie eine Anwendung mit der Amazon Chime SDK-Clientbibliothek für erstellen JavaScript, müssen Sie die Sicherheitsrichtlinien für Browserinhalte in Ihrer Anwendung konfigurieren. Weitere Informationen finden Sie im [Leitfaden zur Inhaltssicherheitsrichtlinie](https://aws.github.io/amazon-chime-sdk-js/modules/contentsecurity_policy.html) unter GitHub. 

# Verwendung AppKeys und Mandant IDs für Amazon Chime SDK
<a name="app-keys-tenant-ids"></a>

Sie können AppKeys und Tenant verwendenIDs , um den Zugriff *von einem Netzwerk* auf die Amazon Chime SDK WebRTC-Mediensitzungen bestimmter Anwendungen zu beschränken.

Entwickler verwenden das Amazon Chime SDK, um Anwendungen zu erstellen, die Echtzeitvideos über UDP senden und empfangen. Anwendungsbenutzer benötigen UDP-Zugriff auf das [https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html)Subnetz. Organizations (Netzwerkbesitzer) können einen Mandanten verwenden AppKeys IDs , um den Zugriff von ihrem Netzwerk aus nur auf die WebRTC-Mediensitzungen einer bestimmten Anwendung zu beschränken.

**Beispiel 1: Verwenden AppKeys**  
Wenn App-A und App-B das Amazon Chime SDK verwenden, kann eine Organisation App-A erlauben, von ihrem Netzwerk aus auf die WebRTC-Mediensitzungen zuzugreifen, aber App-B und alle anderen Anwendungen blockieren, die das Amazon Chime SDK verwenden. Organizations können das mit App-As AppKey und einem HTTPS-Proxy tun. Weitere Informationen finden Sie weiter [Beschränken Sie den Zugriff auf eine bestimmte Anwendung](#limit-app-access) unten in diesem Thema.

**Beispiel 2: Verwendung von AppKeys und Mandant IDs**  
Wenn App-A öffentlich verfügbar ist und von vielen Kunden verwendet wird, möchte ein Unternehmen möglicherweise App-A den Zugriff auf WebRTC-Mediensitzungen von seinem Netzwerk aus nur dann gestatten, wenn ihre Benutzer an der Sitzung teilnehmen, und den Zugriff auf alle anderen App-A-Sitzungen blockieren. Organizations können dies tun, indem sie die Anwendung AppKey, die TenantID der Organisation und einen HTTPS-Proxy verwenden. Weitere Informationen finden Sie weiter unten [Beschränken Sie den Zugriff auf einen bestimmten Mandanten](#limit-tenant-access) in diesem Thema.

Um einen Mandanten verwenden AppKeys zu könnenIDs, benötigen Sie einen HTTPS-Proxyserver, der das Hinzufügen von HTTPS-Headern zu einer Anfrage ermöglicht. Das folgende Diagramm zeigt, wie AppKeys und Tenant IDs funktionieren.

![\[Diagramm, das zeigt, wie AppKeys und der Mandant den IDs Anwendungs- und Mandantenzugriff auf eine WebRTC-Sitzung steuert.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/app-key-diagram.png)


In der Abbildung hat App-A die Mandanten A-1 und A-2 und App-B die Mandanten B-1 und B-2. In diesem Fall kann App-A AppKey nur eine Verbindung zur WebRTC-Mediensitzung herstellen, und die Mandanten-ID lässt nur Tenant A-1 zur Sitzung zu.

**Topics**
+ [Beschränken Sie den Zugriff auf eine bestimmte Anwendung](#limit-app-access)
+ [Beschränken Sie den Zugriff auf einen bestimmten Mandanten](#limit-tenant-access)
+ [Beispiele für HTTPS-Header](#header-examples)

## Beschränken Sie den Zugriff auf eine bestimmte Anwendung
<a name="limit-app-access"></a>

An *AppKey*ist ein konsistenter, eindeutiger 256-Bit-Wert, den Amazon Chime für jedes Konto erstellt. AWS Wenn Sie keine haben AppKey, können Sie eine beim Amazon Support anfordern. Wenn Sie mehrere AWS Konten haben, können Sie ein gemeinsames Konto AppKey für alle Ihre Konten beantragen.

**Anmerkung**  
Sie können Ihre Daten sicher AppKeys öffentlich teilen und es anderen Organisationen ermöglichen, den Zugriff von ihren Netzwerken aus einzuschränken. 

Das Amazon Chime SDK ordnet jede WebRTC-Mediensitzung automatisch einer zu, die auf der AWS Konto-ID AppKey basiert, die zur Erstellung der Sitzung verwendet wurde. Gehen Sie wie folgt vor, um den Zugriff *von Ihrem Netzwerk* auf bestimmte Anwendungen zu beschränken:

1. Leiten Sie alle ausgehenden Anfragen über einen HTTPS-Proxyserver an das `CHIME_MEETINGS` Subnetz weiter. 

1. Konfigurieren Sie den Proxyserver so, dass er allen ausgehenden Anfragen an das Subnetz den folgenden Header hinzufügt: `CHIME_MEETINGS`

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

   `X-Amzn-Chime-App-Keys:AppKey-A,AppKey-B,AppKey-C`Ermöglicht beispielsweise den Apps, die diesen Apps zugeordnet sind, den Zugriff AppKeys auf das Subnetz.

Das Amazon Chime SDK überprüft eingehende WebRTC-Mediensitzungsverbindungen auf den `X-Amzn-Chime-App-Keys` Header und wendet die folgende Logik an:

1. Wenn der `X-Amzn-Chime-App-Keys` Header vorhanden ist und den Header der Sitzung enthält, akzeptieren Sie die Verbindung. AppKey

1. Wenn der `X-Amzn-Chime-App-Keys` Header vorhanden ist, aber den der Sitzung nicht enthält AppKey, lehnen Sie die Verbindung mit einem 403-Fehler ab.

1. Wenn der `X-Amzn-Chime-App-Keys` Header nicht vorhanden ist, akzeptieren Sie die Verbindung. Wenn Benutzer von außerhalb des Unternehmensnetzwerks auf die Anwendung zugreifen können, können sie auch auf die Sitzung zugreifen.

## Beschränken Sie den Zugriff auf einen bestimmten Mandanten
<a name="limit-tenant-access"></a>

Eine *TenantID* ist eine undurchsichtige Kennung, die von Entwicklern erstellt wurde. Denken Sie an Folgendes über Tenant: IDs
+ IDs Es kann nicht garantiert werden, dass Mandanten zwischen Anwendungen eindeutig sind. Sie müssen daher AppKey für jede TenantID-Liste eine Liste angeben. 
+ Mieter achten auf Groß- IDs und Kleinschreibung. Geben Sie sie genau so ein, wie es vom Entwickler vorgeschrieben wurde.
+ Eine Organisation kann den Zugriff auf mehrere Anwendungen einschränken, aber nur IDs für einige dieser Anwendungen Tenant angeben. Anwendungen ohne Tenant IDs können eine Verbindung zu allen WebRTC-Mediensitzungen herstellen. 

Um eine Mediensitzung mit Tenant zu verknüpfenIDs, muss ein Entwickler zuerst die `TenantIds` Eigenschaft und eine Liste von Tenant IDs zu einer [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) oder [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) request.

Zum Beispiel:

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

Gehen Sie wie folgt vor, um den Zugriff vom Netzwerk einer Organisation auf ihre WebRTC-Mediensitzung in bestimmten Anwendungen zu beschränken:

1. Führen Sie die Schritte unter [Beschränken Sie den Zugriff auf eine bestimmte Anwendung](#limit-app-access) aus.

1. Konfigurieren Sie den HTTPS-Proxyserver so, dass er bei ausgehenden Verbindungen einen `X-Amzn-Chime-Tenants` Header hinzufügt. Fügen Sie eine Liste von AppKeys und Mandant hinzuIDs, getrennt wie in diesem Beispiel gezeigt: `X-Amzn-Chime-Tenants: AppKey-A:tenantId-A-1,tenantId-A-2;AppKey-B:tenantId-B-1,tenantId-B-2`

Das Amazon Chime SDK überprüft eingehende WebRTC-Mediensitzungsverbindungen auf den `X-Amzn-Chime-Tenants` Header und wendet die folgende Logik an:
+ Wenn der Header die der Sitzung enthält, akzeptieren Sie die Verbindung`AppKey:tenantId`.
+ Wenn der Header die Daten der Sitzung enthält, `AppKey` aber keine passenden Informationen enthält`tenantId`, lehnen Sie die Verbindung mit einem 403-Fehler ab.
+ Wenn der Header *nicht* die Daten der Sitzung enthält`AppKey`, akzeptieren Sie die Verbindung.
+ Wenn der Header die Daten der Sitzung enthält`AppKey`, für die Sitzung jedoch nicht mindestens eine zulässig ist`tenantId`, lehnen Sie die Verbindung mit einem 403-Fehler ab. Dies kann ein Entwickler-Bug sein.
+ Wenn der Header nicht vorhanden ist, akzeptieren Sie die Verbindung. Wenn Benutzer von außerhalb des Unternehmensnetzwerks auf die Anwendung zugreifen können, können sie auch auf alle Sitzungen zugreifen.

## Beispiele für HTTPS-Header
<a name="header-examples"></a>

Die folgenden Beispiele zeigen einige Möglichkeiten, Tenant IDs in HTTPS-Headern zu verwenden AppKeys .

**Eine App mit einem Mandanten**  
`X-Amzn-Chime-App-Keys: AppKey`  
`X-Amzn-Chime-Tenants: AppKey:orgId`  
Benutzer können in der angegebenen App nur auf die WebRTC-Mediensitzungen der Organisation zugreifen. Alle anderen Apps sind blockiert.

**Eine App mit zwei Mandanten**  
`X-Amzn-Chime-App-Keys: AppKey`  
`X-Amzn-Chime-Tenants: AppKey:engineeringId,salesId`  
Benutzer können in der angegebenen App nur auf die Mediensitzungen für Technik und Vertrieb zugreifen. Alle anderen Apps sind blockiert.

**Zwei Apps, eine ist auf einen Mandanten beschränkt**  
`X-Amzn-Chime-App-Keys: AppKey1,AppKey2`  
`X-Amzn-Chime-Tenants: AppKey1:orgId`  
Benutzer können in App 1 nur auf die Mediensitzungen der Organisation und in App 2 auf jede Sitzung zugreifen. Alle anderen Apps sind blockiert.

# Grundlegendes zu den Ereignissen im Lebenszyklus von Besprechungen im Amazon Chime SDK
<a name="using-events"></a>

Das Amazon Chime SDK sendet Ereignisse im Meeting-Lebenszyklus, mit denen Sie Benachrichtigungen auslösen und nachgelagerte Workflows einleiten können. Einige Beispiele für die Verwendung von Besprechungsereignissen sind: 
+ Aktualisierung von Metadaten, wenn ein Teilnehmer einem Amazon Chime SDK-Meeting beitritt oder es verlässt.
+ Implementierung von Push-Benachrichtigungen oder Dienstplänen für ein Amazon Chime SDK-Meeting.
+ Messung der Nutzung von Video und Teilen von Inhalten in Amazon Chime SDK-Meetings.

Sie können Ereignisse an Amazon EventBridge, Amazon Simple Notification Service (SNS) und Amazon Simple Queue Service (SQS) senden. Weitere Informationen finden Sie unter [Events from AWS services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) im * EventBridge Amazon-Benutzerhandbuch*.

## Das Amazon Chime SDK-Meeting beginnt
<a name="sdk-start-mtg"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein neues Meeting beginnt.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Das Amazon Chime SDK-Meeting endet
<a name="sdk-end-mtg"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein aktives Meeting endet.

**Anmerkung**  
Aus Effizienzgründen sendet der Service dieses Ereignis auch, wenn Sie den [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 Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Amazon Chime SDK-Teilnehmer wurde hinzugefügt
<a name="sdk-add-attendee"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein neuer Teilnehmer zu einem aktiven Meeting hinzugefügt wird.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Der Amazon Chime SDK-Teilnehmer wurde gelöscht
<a name="sdk-remove-attendee"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn Sie den [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 zum Entfernen eines Teilnehmers aus einem aktiven Meeting. 

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Der Teilnehmer am Amazon Chime SDK ist autorisiert
<a name="sdk-auth-attendee"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein Benutzer, der dem Meeting bereits beigetreten ist, dasselbe Teilnahme-Token verwendet, um dem Meeting erneut beizutreten. Beispielsweise kann ein Benutzer von einem Desktop-Computer zu einem Mobilgerät wechseln. Dadurch wird das Meeting quasi an das neue Gerät „übergeben“. 

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Teilnehmer am Amazon Chime SDK nimmt an einem Meeting teil
<a name="sdk-join-attendee"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein vorhandener Teilnehmer über den angegebenen Netzwerktransport an einem Amazon Chime SDK-Meeting teilnimmt.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Teilnehmer am Amazon Chime SDK verlässt ein Meeting
<a name="sdk-leave-attendee"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein vorhandener Teilnehmer ein Amazon Chime SDK-Meeting über den angegebenen Netzwerktransport verlässt.

**Anmerkung**  
Der Service sendet niemals `chime:AttendeeLeft` `chime:AttendeeDropped` AND-Ereignisse für dieselbe Abwesenheitsaktion. Löschen und Verlassen sind unterschiedliche Aktionen, und das System sendet das Ereignis, das jeder Aktion entspricht.  
Nehmen wir zum Beispiel an, ein Teilnehmer mit einer schlechten Verbindung nimmt um 11 Uhr an einer Besprechung teil. Sie können die folgenden Aktionen erwarten:  

```
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 Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Teilnehmer des Amazon Chime SDK wird von einem Meeting ausgeschlossen
<a name="sdk-drop-attendee"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein aktueller Teilnehmer von einem Amazon Chime SDK-Meeting ausgeschlossen wird, in der Regel aufgrund einer schlechten Verbindung. Wenn der Service 10-15 Sekunden lang keine Pakete empfängt, geht er davon aus, dass der Client gelöscht wurde, und gibt das Ereignis aus.

Der Dienst löst normalerweise Drop-Aktionen aus, aber Clients können sie auch auslösen. Nehmen wir zum Beispiel an, ein Benutzer schaltet seinen Laptop von Wi-Fi auf Ethernet um. Dies stellt eine Änderung des Netzwerkadapters dar, und die Verbindung wird zurückgesetzt. Dadurch wird wiederum der Websocket zurückgesetzt und eine kombinierte Drop-Join-Aktion ausgelöst.

**Anmerkung**  
Der Dienst sendet niemals `chime:AttendeeLeft` `chime:AttendeeDropped` UND-Ereignisse für dieselbe „Verlassen“ -Aktion. Löschen und Verlassen sind unterschiedliche Aktionen, und das System sendet das Ereignis, das jeder Aktion entspricht.  
Nehmen wir zum Beispiel an, ein Teilnehmer mit einer schlechten Verbindung nimmt um 11 Uhr an einer Besprechung teil. Sie können die folgenden Aktionen erwarten:  

```
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 Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Amazon Chime SDK-Teilnehmer startet Videostreaming
<a name="sdk-attendee-video-start"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein vorhandener Teilnehmer mit dem Streamen von Videos beginnt.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Teilnehmer am Amazon Chime SDK stoppt das Streamen von Videos
<a name="sdk-attendee-video-stop"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein vorhandener Teilnehmer das Streamen von Videos beendet.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Amazon Chime SDK-Teilnehmer beginnt, den Bildschirm zu teilen
<a name="sdk-attendee-screenshare-start"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein vorhandener Teilnehmer beginnt, seinen Bildschirm zu teilen.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Amazon Chime SDK-Teilnehmer teilt den Bildschirm nicht mehr
<a name="sdk-attendee-screenshare-stop"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn ein vorhandener Teilnehmer seinen Bildschirm nicht mehr teilt.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Die Teilnehmerfunktionen des Amazon Chime SDK wurden aktualisiert
<a name="sdk-attendee-capability-updated"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Funktionen eines vorhandenen Teilnehmers aktualisiert werden.

**Example Ereignisdaten**  

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

## Amazon Chime SDK-Teilnehmerinhalte treten einem Meeting bei
<a name="sdk-content-join"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn eine Inhaltsfreigabe über den angegebenen Netzwerktransport an einem Amazon Chime SDK-Meeting teilnimmt.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Amazon Chime SDK-Teilnehmerinhalte verlassen ein Meeting
<a name="sdk-content-leave"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn eine Inhaltsfreigabe ein Amazon Chime SDK-Meeting über den angegebenen Netzwerktransport verlässt.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Amazon Chime SDK-Teilnehmerinhalte werden aus einem Meeting gelöscht
<a name="sdk-content-drop"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn eine Inhaltsfreigabe aufgrund eines Amazon Chime SDK-Meetings unterbrochen wird, was in der Regel auf eine geringe Bandbreite zurückzuführen ist.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Amazon Chime SDK-Teilnehmerinhalte starten Videostreaming
<a name="sdk-content-start-stream"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn eine Inhaltsfreigabe das Streamen von Videos startet.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

## Amazon Chime SDK-Teilnehmerinhalte werden nicht mehr per Video gestreamt
<a name="sdk-content-stop-stream"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn eine Inhaltsfreigabe das Streamen von Videos beendet.

**Example Ereignisdaten**  
Das folgende Beispiel zeigt die Daten für dieses Ereignis.  

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

# Grundlegendes zu CloudWatch Amazon-Metriken für Amazon Chime SDK-Besprechungen
<a name="sdk-usage-metrics"></a>

Wenn Sie das Amazon Chime SDK verwenden, sendet es Service- und Nutzungsmetriken an CloudWatch. Mithilfe der Metriken können Sie mithilfe von CloudWatch Grafiken und Dashboards überwachen, wie Sie die Amazon Chime SDK-Services nutzen. Die Metriken erfassen Daten für jede API, die Sie aufrufen.

In den folgenden Abschnitten werden die Metriken aufgeführt und beschrieben.

**Topics**
+ [Servicemetriken](#service-metrics)
+ [Metriken zur API-Nutzung](#usage-metrics)

## Servicemetriken
<a name="service-metrics"></a>

Das Amazon Chime SDK veröffentlicht die folgenden Servicemetriken im `AWS/ChimeSDK` Namespace:


| Metrik | Einheit | Beschreibung | 
| --- | --- | --- | 
| `AttendeeAuthorizationSuccess` | Anzahl | Gesamtzahl der erfolgreichen Autorisierungsversuche. Erfolg bedeutet, dass ein Teilnehmer an der Besprechung teilnehmen durfte. | 
| `AttendeeAuthorizationError` | Anzahl | Die Gesamtzahl der fehlgeschlagenen Autorisierungen weist darauf hin, dass der Teilnehmer nicht an der Besprechung teilnehmen konnte. | 
| `AttendeeAudioDrops` | Anzahl | Gesamtzahl der Audioausfälle. | 
| `AttendeeContentDrops` | Anzahl | Gesamtzahl der Drops beim Teilen von Inhalten. | 
| `MeetingSQSNotificationErrors` | Anzahl | Gesamtzahl der SQS-Benachrichtigungsfehler. | 
| `MeetingSNSNotificationErrors` | Anzahl | Gesamtzahl der Fehler bei SNS-Benachrichtigungen. | 

## Metriken zur API-Nutzung
<a name="usage-metrics"></a>

Die API-Nutzungsmetriken entsprechen den AWS Servicekontingenten. Sie können Alarme konfigurieren, mit denen Sie benachrichtigt werden, wenn sich Ihre Nutzung einem Servicekontingent nähert. Weitere Informationen zur CloudWatch Integration mit Servicekontingenten finden Sie unter [AWS-Nutzungsmetriken](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html) im * CloudWatch Amazon-Benutzerhandbuch*.

Das Amazon Chime SDK veröffentlicht die folgenden API-Metriken im `AWS/Usage` Namespace mit dem `ChimeSDK` Servicenamen.


| Metrik | Beschreibung | 
| --- | --- | 
| `CallCount` | Die Gesamtzahl der Aufrufe einer API im Amazon Chime SDK. SUM steht für die Gesamtzahl der API-Aufrufe im angegebenen Zeitraum. | 
| `ErrorCount` | Die Gesamtzahl der Fehler, die von einer API im Amazon Chime SDK ausgelöst wurden. SUM steht für die Gesamtzahl der API-Aufrufe im angegebenen Zeitraum. | 
| `ThrottleCount` | Die Gesamtzahl der Drosselungsfehler, die von einer API im Amazon Chime SDK ausgelöst wurden. SUM, die die Gesamtzahl der API-Aufrufe im angegebenen Zeitraum darstellt. | 

Das Amazon Chime SDK veröffentlicht Nutzungsmetriken im `AWS/Usage` Namespace mit den folgenden Dimensionen:


| Dimension | Beschreibung | 
| --- | --- | 
| Service | Der Name des AWS Dienstes, der die Ressource enthält. Für Nutzungsmetriken des Amazon Chime SDK lautet `ChimeSDK` der Wert für diese Dimension. | 
| Typ | Der Typ der Entität, die gemeldet wird. Der einzig gültige Wert für Amazon Chime SDK-Nutzungsmetriken ist`API`. | 
| Ressource | Der Typ der Ressource, die die Metrik meldet. Für Nutzungsmetriken des Amazon Chime SDK ist der Wert für diese Dimension der Name der API. | 
| Klasse | Die Klasse der nachverfolgten Ressource. Der einzig gültige Wert für Amazon Chime SDK-Metriken ist`None`. | 

# Amazon Chime SDK-Medien-Pipelines erstellen
<a name="media-pipelines"></a>

In diesem Abschnitt zeigen wir Ihnen, wie Sie Medien-Pipelines erstellen, die zum Aufzeichnen oder Streamen eines Amazon Chime SDK-Meetings verwendet werden. Bevor Sie beginnen, müssen Sie Ihre Client-Anwendung in die Amazon Chime SDK-Clientbibliothek integrieren. Weitere Informationen finden Sie unter [Erfahren Sie mehr über die Amazon Chime SDK-Clientbibliotheken](mtgs-sdk-client-lib.md). Weitere Informationen zu Medien-Pipelines finden Sie unter [Aufzeichnen von Amazon Chime SDK-Meetings mithilfe von Medien-Pipelines](https://aws.amazon.com/blogs//business-productivity/capture-amazon-chime-sdk-meetings-using-media-capture-pipelines/) im *AWS Business* Productivity Blog.

**Wichtig**  
Sie und Ihre Endbenutzer müssen sich darüber im Klaren sein, dass die Aufzeichnung von Amazon Chime SDK-Besprechungen Gesetzen oder Vorschriften in Bezug auf die Aufzeichnung elektronischer Kommunikation unterliegen kann. Es liegt in Ihrer Verantwortung und Ihren Endbenutzern, alle geltenden Gesetze in Bezug auf die Aufzeichnungen einzuhalten, einschließlich der ordnungsgemäßen Benachrichtigung aller Teilnehmer einer aufgezeichneten Sitzung, dass die Sitzung oder Kommunikation aufgezeichnet wird, und deren Zustimmung einzuholen.   
Sie und Ihre Endnutzer sind für alle Inhalte verantwortlich, die über den Media Live Connector-Dienst gestreamt werden, und müssen sicherstellen, dass diese Inhalte nicht gegen Gesetze verstoßen, Rechte Dritter verletzen oder missbrauchen oder anderweitig gegen eine wesentliche Bestimmung Ihrer Vereinbarung mit Amazon verstoßen.

**Topics**
+ [Überlegungen zur Erstellung von Amazon Chime SDK-Medien-Pipelines](creating-media-pipelines-considerations.md)
+ [Grundlegendes zu den Standardlimits für aktive Amazon Chime SDK-Medien-Pipelines](media-pipelines-limits.md)
+ [Migration zum Amazon Chime SDK Media Pipelines Namespace](migrate-pipelines.md)
+ [Grundlegendes zur Erstellung der Amazon Chime SDK-Medienpipeline](create-pipeline.md)
+ [Medienerfassungspipelines für Amazon Chime SDK-Besprechungen erstellen](capture-pipe-config.md)
+ [Pipelines zur Medienverkettung für Amazon Chime SDK-Meetings erstellen](create-concat-pipe.md)
+ [Erstellung von Media Live Connector-Pipelines für Amazon Chime SDK-Meetings](connector-pipe-config.md)
+ [Medienstream-Pipelines mit dem Amazon Chime SDK erstellen](create-media-stream-pipeline.md)
+ [Zusammenstellen von Audio und Video in einer einzigen Ansicht in Amazon Chime SDK-Meetings](pipeline-compositing.md)
+ [Eine serviceverknüpfte Rolle für Amazon Chime SDK-Medien-Pipelines erstellen](create-pipeline-role.md)
+ [Medien-Pipeline-Ereignisse des Amazon Chime SDK verwenden](media-pipe-events.md)
+ [Bewährte Methoden zum Stoppen von Amazon Chime SDK-Medien-Pipelines](stop-pipe-best-practices.md)

# Überlegungen zur Erstellung von Amazon Chime SDK-Medien-Pipelines
<a name="creating-media-pipelines-considerations"></a>

Eine Medienpipeline kann aus einer der folgenden Pipelines bestehen: 
+ **Medienerfassung** — Verwenden Sie Medienerfassungspipelines, um Audio-, Video- und Content-Share-Streams sowie Besprechungsereignisse und Datennachrichten aufzuzeichnen. Alle Medienerfassungspipelines speichern ihre Daten in dem von Ihnen [erstellten Amazon Simple Storage Service](https://aws.amazon.com/s3/) (S3) -Bucket. Sie können pro Amazon Chime SDK-Meeting eine Medienerfassungspipeline erstellen. Weitere Informationen finden Sie unter [Grundlegendes zur Erstellung der Amazon Chime SDK-Medienpipeline](create-pipeline.md).
+ **Medienverkettung — Verwenden Sie Medienverkettungspipelines**, um die Artefakte aus einer Medienerfassungspipeline zu verketten. Verkettungspipelines funktionieren unabhängig von Medienerfassungs- und Live-Connector-Pipelines. Weitere Informationen finden Sie unter [Pipelines zur Medienverkettung für Amazon Chime SDK-Meetings erstellen](create-concat-pipe.md).
+ **Media Live Connector** — Verwenden Sie Media Live Connector-Pipelines, um eine Verbindung zu Diensten herzustellen, mit denen Sie Amazon Chime SDK-Meetings an einen RTMP-Endpunkt streamen können. Sie können bis zu eine Media Live Connector-Pipeline pro Amazon Chime SDK-Meeting erstellen. Weitere Informationen finden Sie unter [Erstellung von Media Live Connector-Pipelines für Amazon Chime SDK-Meetings](connector-pipe-config.md).
+ **Medienstream** — Verwenden Sie Medienstream-Pipelines, um einzelne Audiodaten für alle Teilnehmer eines Meetings sowie die gemischten Audiodaten aufzunehmen, die durch eine Medienverkettungspipeline generiert werden. Alle Medienstream-Pipelines speichern ihre Daten in [Amazon Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/what-is-kinesis-video.html) (KVS). Weitere Informationen finden Sie unter [Medienstream-Pipelines mit dem Amazon Chime SDK erstellen](create-media-stream-pipeline.md).

Die Pipelines, die Sie erstellen, hängen vom verwendeten Namespace ab. Wenn Sie den `Chime` Namespace verwenden, können Sie nur Medienerfassungspipelines erstellen. Wenn Sie den `ChimeSdkMediaPipelines` Namespace verwenden, können Sie auch Medienverkettungs- und Media Live Connector-Pipelines erstellen und Compositing-Funktionen verwenden. Wenn Sie zum Namespace migrieren möchten, finden Sie weitere Informationen unter. `ChimeSdkMediaPipelines` [Migration zum Amazon Chime SDK Media Pipelines Namespace](migrate-pipelines.md)

# Grundlegendes zu den Standardlimits für aktive Amazon Chime SDK-Medien-Pipelines
<a name="media-pipelines-limits"></a>

In der folgenden Tabelle sind die Standardgrenzwerte für aktive Medien-Pipelines in jeder Region aufgeführt. Jeder Pipeline-Typ wird auf den Grenzwert angerechnet. Wenn Sie das Limit für eine Region überschreiten, lösen die [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), und [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 Ausnahmen „**Ressourcenlimit überschritten**“ aus.

Sie können die Seite „**Servicekontingente**“ in der AWS Konsole verwenden, um Ihre aktiven Pipeline-Limits anzupassen, oder Sie können sich an Ihren [Kundendienstmitarbeiter](https://docs.aws.amazon.com/awssupport/latest/user/getting-started.html) wenden. Weitere Informationen zu den Amazon Chime SDK-Meetinglimits finden Sie unter[Kontingente für das Amazon Chime SDK](meetings-sdk.md#mtg-limits).


| Region | Standard-Limit für aktive Pipelines | 
| --- | --- | 
| 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 | 

# Migration zum Amazon Chime SDK Media Pipelines Namespace
<a name="migrate-pipelines"></a>

Sie verwenden den `ChimeSdkMediaPipelines` Namespace, um Medien-Pipeline-API-Endpunkte in jeder AWS Region zu adressieren, in der sie verfügbar sind. Verwenden Sie diesen Namespace, wenn Sie gerade erst anfangen, das Amazon Chime SDK zu verwenden. Weitere Informationen zu Regionen finden Sie [Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md) in diesem Handbuch.

Bestehende Anwendungen, die den [Amazon Chime Chime-Namespace](https://docs.aws.amazon.com/chime/latest/APIReference/API_Operations_Amazon_Chime.html) verwenden, sollten eine Migration zum dedizierten Namespace planen.

**Topics**
+ [Gründe für die Migration Ihrer Pipelines](#pipeline-migration-reasons)
+ [Bevor Sie Ihre Pipelines migrieren](#migration-prerequisites)

## Gründe für die Migration Ihrer Pipelines
<a name="pipeline-migration-reasons"></a>

Aus den folgenden Gründen empfehlen wir Ihnen, zum `ChimeSdkMediaPipelines` Namespace zu migrieren:

**Wahl des API-Endpunkts**  
Der Amazon Chime SDK Media Capture-Namespace ist der einzige API-Namespace, der API-Endpunkte in jeder Region verwenden kann, in der sie verfügbar sind. Weitere Informationen zu Regionen finden Sie unter. [Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md) Wenn Sie andere API-Endpunkte als verwenden möchten`us-east-1`, müssen Sie den `ChimeSdkMediaPipelines` Namespace verwenden. Weitere Informationen zu den aktuellen Endpunkten finden Sie [API-Zuordnung](migrate-from-chm-namespace.md#name-end-map) in diesem Handbuch.

**Aktualisierte und neue Medienpipeline APIs**  
Wir fügen nur die Medienpipeline APIs im `ChimeSdkMediaPipelines` Namespace hinzu oder aktualisieren sie.

## Bevor Sie Ihre Pipelines migrieren
<a name="migration-prerequisites"></a>

Beachten Sie vor der Migration die Unterschiede zwischen den Namespaces. In der folgenden Tabelle sind sie aufgeführt und beschrieben.


| Item | Namespace für Medien-Pipelines | Chime-Namespace | 
| --- | --- | --- | 
|  Namespace-Namen  |  ChimeSdkMediaPipelines  |  Glockenspiel  | 
|  Regionen  |  Mehrere  |  nur us-east-1  | 
|  Endpunkte  |  https://. media-pipelines-chime *region .amazonaws.com*  |  https://service.chime.aws.amazon.com  | 
|  Dienstauftraggeber  |  mediapipelines.chime.amazonaws.com  |  chime.amazonaws.com  | 
|  APIs  |  Nur für Medien-Pipelines APIs   |  APIs für Medienleitungen und andere Teile von Amazon Chime  | 
|  Treffen  |  Medien-Pipelines in den `eu-central-1` Regionen `us-west-2``ap-southeast-1`, und funktionieren nur mit Besprechungen, die im Amazon Chime SDK Meetings-Namespace erstellt wurden. Medien-Pipelines in der `us-east-1` Region funktionieren mit Besprechungen, die von einem beliebigen Meeting-Endpunkt in einem der Namespaces erstellt wurden.  |  Medien-Pipelines funktionieren mit Besprechungen, die von beliebigen Meeting-Endpunkten in beiden Namespaces erstellt wurden.  | 
| Standardmäßig aktive Medien-Pipelines | 100 in der Region us-east-1 und 10 in den Regionen us-west-2, ap-southeast-1 und eu-central-1.  | 100 nur in us-east-1. | 
|  Servicegebundene Rolle  |  AWSServiceRoleForAmazonChimeSDKMediaRohrleitungen  |     | 
|  Tags  |  Verfügbar  |  Für die Medienpipeline APIs nicht verfügbar.  | 
| CloudTrail Quelle des Ereignisses | chime-sdk-media-pipelines.amazonaws.com | chime.amazonaws.com. | 
| Live-Anschluss für Medien | Verfügbar |  Für die Medienpipeline nicht verfügbar APIs.  | 
| Zusammenstellen | Verfügbar |  Für die Medienpipeline nicht verfügbar. APIs  | 
| Verkettung | Verfügbar | Nicht verfügbar. | 

Die folgende Liste enthält weitere Informationen zu den Unterschieden zwischen Chime und AWS ChimeSdkMediaPipelines Namespaces.

**Namespace-Namen**  
Der Amazon Chime SDK-Namespace verwendet den `AWS.Chime` formalen Namen. Der Amazon Chime SDK Media Pipelines Namespace verwendet den `AWS.ChimeSDKMediaPipelines` formalen Namen. Das genaue Format des Namens variiert je nach Plattform.  
Diese Codezeile von Node.js adressiert beispielsweise den `chime` Namespace:  

```
const chimeMediaPipelines = AWS.Chime();
```
Um zum Media Pipelines SDK-Namespace zu migrieren, aktualisieren Sie diesen Code mit dem neuen Namespace und der Endpunktregion.  

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

**Regionen**  
Der Amazon Chime Chime-Namespace adressiert nur API-Endpunkte in der Region US-EAST-1. Der Amazon Chime SDK Media Pipelines Namespace adressiert Amazon Chime SDK-Medien-Pipeline-API-Endpunkte in jeder Region, in der sie verfügbar sind. Eine aktuelle Liste der Medien-Pipeline-Regionen finden Sie in diesem Handbuch. [Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md)

**Endpunkte**  
Um eine Medienerfassungspipeline zu ändern, müssen Sie denselben Endpunkt verwenden, auf dem Sie die Pipeline erstellt haben. Wenn Sie beispielsweise Pipelines über einen Endpunkt in eu-central-1 erstellt haben, müssen Sie eu-central-1 verwenden, um mit dieser Pipeline zu interagieren. Weitere Informationen zu den aktuellen Endpunkten finden Sie in diesem Handbuch. [API-Zuordnung](migrate-from-chm-namespace.md#name-end-map)

**Dienstauftraggeber**  
Der [Amazon Chime SDK Media Pipelines](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) Namespace verwendet einen neuen Dienstprinzipal:. `mediapipelines.chime.amazonaws.com` Wenn Sie Amazon S3 S3-Bucket oder andere IAM-Richtlinien haben, die Zugriff auf Services gewähren, müssen Sie diese Richtlinien aktualisieren, um Zugriff auf den neuen Service Principal zu gewähren.  
Wenn Sie beispielsweise Medien-Pipelines erstellen, müssen Sie dem neuen Service Principal die unter aufgeführten Richtlinienberechtigungen hinzufügen. [Erstellen eines Amazon S3 S3-Buckets für Amazon Chime SDK-Medienerfassungspipelines](create-s3-bucket.md) Weitere Informationen zu Richtlinien finden Sie unter [AWS JSON Policy Elements: Principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) im IAM-Benutzerhandbuch.

**APIs**  
Der Amazon Chime SDK Media Pipelines Namespace enthält nur APIs , dass Medien-Pipelines erstellt und verwaltet werden. Der Amazon Chime Chime-Namespace umfasst APIs Medien-Pipelines, Besprechungen und andere Teile des Amazon Chime Chime-Dienstes.

**Besprechungen**  
Medien-Pipelines in der IAD-Region funktionieren mit Besprechungen, die von einem beliebigen Meeting-Endpunkt mit einem der beiden Namespaces erstellt wurden.

**Servicegebundene Rolle**  
Nur für den Amazon Chime SDK Media Pipelines Namespace. *Erstellen Sie die Pipelines-Rolle AWSService RoleForAmazonChimeSDKMedia.*

**Tags**  
Der [Amazon Chime SDK Media Pipelines](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) Namespace unterstützt Tags. Die Rolle muss berechtigt sein, den `TagResource` Vorgang aufzurufen, wenn der [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)oder [CreateMediaLiveConnectorPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html) APIs mit einem oder mehreren Tags aufgerufen wird.

# Grundlegendes zur Erstellung der Amazon Chime SDK-Medienpipeline
<a name="create-pipeline"></a>

Sie folgen einem mehrstufigen Prozess, um eine Amazon Chime SDK-Medienpipeline zu erstellen, und Sie können verschiedene Arten von Pipelines erstellen. Die folgende Liste beschreibt den Erstellungsprozess und enthält Links zu weiteren Informationen über die Erstellung der verschiedenen Arten von Pipelines. 
+ Erstellen Sie einen Amazon-S3-Bucket. Sie müssen den Bucket in derselben AWS Region wie das Meeting erstellen. Weitere Informationen finden Sie unter [Erstellen eines Amazon S3 S3-Buckets für Amazon Chime SDK-Medienerfassungspipelines](create-s3-bucket.md).
+ Erstellen Sie eine serviceverknüpfte Rolle mit dem Namen`AWSServiceRoleForAmazonChimeSDKMediaPipelines`. Auf diese Weise können Medien-Pipelines in Ihrem Namen auf Besprechungen zugreifen. Weitere Informationen finden Sie unter [Eine serviceverknüpfte Rolle für Amazon Chime SDK-Medien-Pipelines erstellen](create-pipeline-role.md).
+ Erstellen Sie eine IAM-Rolle mit ausreichenden Rechten, um mit der [Amazon Chime SDK-Medienpipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) zu interagieren. APIs Um diese Rolle zu erstellen, empfehlen wir, die vom [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) verwaltete Richtlinie von der IAM-Konsole aus hinzuzufügen. Die Richtlinie enthält das Notwendige APIs.

  Ihre IAM-Rolle muss außerdem über die Berechtigung verfügen, die Amazon S3 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html)S3-API für alle Ressourcen aufzurufen. Das folgende Beispiel zeigt eine typische Richtlinie dafür.

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

****  

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

------

Sobald Sie über diese Elemente verfügen, finden Sie in diesen Themen Informationen zum Erstellen von Pipelines.
+ [Medienerfassungspipelines für Amazon Chime SDK-Besprechungen erstellen](capture-pipe-config.md)
+ [Pipelines zur Medienverkettung für Amazon Chime SDK-Meetings erstellen](create-concat-pipe.md)
+ [Erstellung von Media Live Connector-Pipelines für Amazon Chime SDK-Meetings](connector-pipe-config.md)
+ [Medienstream-Pipelines mit dem Amazon Chime SDK erstellen](create-media-stream-pipeline.md)

# Medienerfassungspipelines für Amazon Chime SDK-Besprechungen erstellen
<a name="capture-pipe-config"></a>

Medienerfassungspipelines erfassen Audio-, Video- und Inhaltsstreams sowie Besprechungsereignisse und Datennachrichten. Alle Medienerfassungspipelines speichern ihre Daten in einem [Amazon Simple Storage Service](https://aws.amazon.com/s3/) (S3) -Bucket, den Sie erstellen. Sie können pro Amazon Chime SDK-Meeting eine Medienerfassungspipeline erstellen.

In den folgenden Abschnitten wird erklärt, wie Sie eine Medienerfassungspipeline erstellen. Gehen Sie nach der aufgeführten Reihenfolge vor.

**Topics**
+ [Erstellen eines Amazon S3 S3-Buckets für Amazon Chime SDK-Medienerfassungspipelines](create-s3-bucket.md)
+ [Serverseitige Verschlüsselung für einen Amazon S3 S3-Bucket für Amazon Chime SDK-Medienerfassungspipelines aktivieren](sse-kms.md)
+ [Serverseitige Verschlüsselung auf Objektebene mit Schlüssel aktivieren AWS KMS](using-kms-keys-for-encryption.md)
+ [Erstellung der Amazon Chime SDK-Medienerfassungspipeline](create-capture-pipe.md)
+ [Arbeiten mit Medienerfassungsartefakten des Amazon Chime SDK](artifacts.md)
+ [Konfiguration des Audioordners für Amazon Chime SDK-Medienerfassungspipelines](configure-audio.md)
+ [Konfiguration des Videoordners für Amazon Chime SDK-Medienerfassungspipelines](configure-video.md)
+ [Grundlegendes zu Nachrichten im Datenkanalordner für Amazon Chime SDK-Medienerfassungspipelines](data-channel.md)
+ [Grundlegendes zur Amazon S3 S3-Bucket-Ordnerstruktur für Amazon Chime SDK-Medienerfassungspipelines](capture-folder-structure.md)
+ [Grundlegendes zu Besprechungsereignisdateien für Medienerfassungspipelines des Amazon Chime SDK](meeting-events.md)
+ [Grundlegendes zu Transkriptionsdateien für Amazon Chime SDK-Medienerfassungspipelines](transcription-messages.md)
+ [Verkettung von Datenströmen für Medienerfassungspipelines des Amazon Chime SDK](concatenate-streams.md)

# Erstellen eines Amazon S3 S3-Buckets für Amazon Chime SDK-Medienerfassungspipelines
<a name="create-s3-bucket"></a>

Sie können die Amazon S3 S3-Konsole oder die AWS CLI verwenden AWS SDKs, um einen Amazon S3 S3-Bucket zu erstellen. Weitere Informationen finden Sie unter [Bucket erstellen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) im *Amazon Simple Storage Service (S3) -Benutzerhandbuch*.

Der Amazon S3 S3-Bucket für Ihre Media Capture-Pipeline muss zu demselben AWS Konto gehören wie das Amazon Chime SDK-Meeting. Darüber hinaus müssen Sie dem Amazon Chime SDK-Servicechef [mediapipelines.chime.amazonaws.com](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) die `s3:PutObjectAcl` Zustimmung `s3:PutObject` und erteilen. Sie können das mit der Amazon S3 S3-Konsole oder der AWS Command Line Interface (AWS CLI) tun. Der Amazon S3 S3-Bucket muss zu einer der verfügbaren [Amazon Chime SDK-Medienregionen](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html) gehören.

**Anmerkung**  
Stellen Sie sicher, dass Sie Ihrem IAM-Benutzer eine Richtlinie hinzufügen, um Zugriff auf Ihren Bucket zu gewähren. Wenn Sie eine Region verwenden, die standardmäßig AWS deaktiviert ist, müssen Sie außerdem über einen Amazon S3 S3-Bucket in dieser Region verfügen.  
Standardmäßig deaktiviert AWS die folgenden Regionen, und Sie können dort keine Meeting-Ressourcen hosten, bis Sie sie aktivieren:  
Afrika (Kapstadt)
Asia Pacific (Hongkong)
Asien-Pazifik (Jakarta)
Europa (Milan)
Middle East (Bahrain)
Wenn Sie eine dieser Regionen verwenden, muss sie über einen Amazon S3 S3-Bucket verfügen. Dies gilt auch dann, wenn Sie Amazon S3 verwenden APIs , um mit Regionen zu kommunizieren, die nicht standardmäßig blockiert sind und bereits über einen Bucket verfügen. Weitere Informationen zur Aktivierung blockierter Regionen finden Sie unter [Verwaltung von AWS-Regionen](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) in der *Allgemeinen AWS-Referenz*.

Sobald Sie einen Bucket erstellt haben, notieren Sie seinen ARN. Sie verwenden ihn, um eine Medienerfassungspipeline zu erstellen.

Das folgende Beispiel zeigt eine Amazon S3 S3-Bucket-Richtlinie.

------
#### [ 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:*"
                }
            }
        }
    ]
}
```

------

# Serverseitige Verschlüsselung für einen Amazon S3 S3-Bucket für Amazon Chime SDK-Medienerfassungspipelines aktivieren
<a name="sse-kms"></a>

Um die serverseitige Verschlüsselung für einen Amazon Simple Storage Service (Amazon S3) -Bucket zu aktivieren, können Sie diese Arten von Verschlüsselungsschlüsseln verwenden:
+ Ein verwalteter Amazon S3 S3-Schlüssel
+ Ein vom Kunden verwalteter Schlüssel im AWS Key Management Service (KMS)
**Anmerkung**  
Der Key Management Service unterstützt zwei Arten von Schlüsseln: vom Kunden verwaltete Schlüssel und AWS verwaltete Schlüssel. Amazon Chime SDK-Meetings unterstützen nur vom Kunden verwaltete Schlüssel. 

## Verwenden eines verwalteten Amazon S3 S3-Schlüssels
<a name="s3-keys"></a>

Sie verwenden die Amazon S3 S3-Konsole, CLI oder REST-API, um die serverseitige Verschlüsselung für einen Amazon S3 S3-Bucket zu aktivieren. Wählen Sie in beiden Fällen **Amazon S3 Key** als Verschlüsselungsschlüsseltyp. Es sind keine weiteren Maßnahmen erforderlich. Wenn Sie den Bucket für die Medienerfassung verwenden, werden die Artefakte hochgeladen und serverseitig verschlüsselt. Weitere Informationen finden Sie unter [Spezifizierung der Amazon S3 S3-Verschlüsselung](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-s3-encryption.html) im *Amazon S3 S3-Benutzerhandbuch*. 

## Verwenden Sie einen Schlüssel, den Sie besitzen
<a name="customer-key"></a>

Um die Verschlüsselung mit einem von Ihnen verwalteten Schlüssel zu aktivieren, müssen Sie die serverseitige Verschlüsselung des Amazon S3 S3-Buckets mit einem vom Kunden verwalteten Schlüssel aktivieren und dann der Schlüsselrichtlinie eine Erklärung hinzufügen, die es Amazon Chime ermöglicht, den Schlüssel zu verwenden und alle hochgeladenen Artefakte zu verschlüsseln.

1. Erstellen Sie einen vom Kunden verwalteten Schlüssel in KMS. Informationen dazu finden Sie unter [Serverseitige Verschlüsselung mit AWS KMS (SSE-KMS) angeben](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-kms-encryption.html) im *Amazon S3 S3-Benutzerhandbuch*.

1. Fügen Sie der Schlüsselrichtlinie eine Anweisung hinzu, die es der `GenerateDataKey` Aktion ermöglicht, einen Schlüssel zur Verwendung durch den Amazon Chime SDK-Serviceprinzipal zu generieren,`mediapipelines.chime.amazonaws.com`.

   Dieses Beispiel zeigt eine typische Aussage.

   ```
   ...
   {
       "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. Wenn Sie eine Medienverkettungspipeline verwenden, fügen Sie der Schlüsselrichtlinie eine Anweisung hinzu, die es dem Amazon Chime SDK-Serviceprinzipal, ermöglicht`mediapipelines.chime.amazonaws.com`, die Aktion zu verwenden. `kms:Decrypt`

1. Konfigurieren Sie den Amazon S3 S3-Bucket so, dass die serverseitige Verschlüsselung mit dem Schlüssel aktiviert wird.

# Serverseitige Verschlüsselung auf Objektebene mit Schlüssel aktivieren AWS KMS
<a name="using-kms-keys-for-encryption"></a>

Media Capture Pipeline und Media Concatenation Pipeline können AWS Key Management Service (AWS KMS) vom Kunden verwaltete Schlüssel verwenden, um serverseitige Verschlüsselung (SSE) für einzelne Objekte in einem Amazon S3 S3-Bucket zu aktivieren. Um dies zu konfigurieren, müssen Sie den API-Aufruf verwenden. [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) Die Media Concatenation Pipeline verwendet die serverseitigen Verschlüsselungsparameter der zugehörigen Media Capture-Pipeline.

Um SSE für einzelne Objekte (SSE auf Objektebene) mithilfe Ihres vom AWS KMS Kunden verwalteten Schlüssels zu aktivieren, müssen Sie die `SseAwsKeyManagementParams` Struktur angeben und während des API-Aufrufs Folgendes angeben: `SinkIamRoleArn` [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)

1. Verwenden Sie den `AwsKmsKeyId` Parameter in der `SseAwsKeyManagementParams` Struktur, um den AWS KMS Schlüssel anzugeben. Sie können die Schlüssel-ID mithilfe der ID, des ARN oder des Alias des Schlüssels angeben.

1. Verwenden Sie den `SinkIamRoleArn` Parameter, um die IAM-Rolle für den Zugriff auf den AWS KMS Schlüssel und den Amazon S3 S3-Bucket anzugeben.

1. Optional können Sie den `AwsKmsEncryptionContext` Parameter in der `SseAwsKeyManagementParams` Struktur verwenden, um den Verschlüsselungskontext anzugeben, der zusammen mit AWS KMS Schlüsselartefakten verwendet werden soll, um die Sicherheit zu erhöhen.

**Anmerkung**  
Die `SinkIamRoleArn` Parameter `AwsKmsKeyId` und sind voneinander abhängig. Wenn beide vorhanden und gültig sind, übernimmt die Media Capture-Pipeline die Rolle und platziert jedes Artefakt mit dem angegebenen Schlüssel im angegebenen Amazon S3 S3-Bucket-Sink. AWS KMS Der [CreateMediaConcatenationPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html)API-Aufruf hat keine neuen Parameter, verwendet aber die oben genannten Parameter, sofern angegeben. Wenn Sie beabsichtigen, Artefakte zu verketten, stellen Sie sicher, dass Ihre Ressourcenkonfiguration wie im folgenden [Konfiguration](#using-kms-keys-for-encryption-config) Abschnitt beschrieben festgelegt ist und über einen längeren Zeitraum erhalten bleibt.

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

Er `SinkIamRoleArn` muss dieselben Berechtigungen und denselben Zugriff wie der Principal haben, um Artefakte in den Amazon S3 S3-Bucket zu legen. Weitere Informationen zu den erwarteten Standardberechtigungen im Amazon S3 S3-Bucket finden Sie unter [Erstellen eines Amazon S3 S3-Buckets für Amazon Chime SDK Media Capture Pipelines](https://docs.aws.amazon.com/chime-sdk/latest/dg/create-s3-bucket.html). Um SSE für einzelne Objekte zu aktivieren, muss Ihr Amazon S3 S3-Bucket es der mit der angegebenen IAM-Rolle ermöglichen`SinkIamRoleArn`, dieselben Aktionen auszuführen, die Sie von der aufrufenden IAM-Identität erwarten würden. Sie können dies erreichen, indem Sie den folgenden Prinzipal zu Ihrer Amazon S3 S3-Bucket-Berechtigungsrichtlinie hinzufügen.

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

Das `AwsKmsKeyId` sollte auf einen Schlüssel verweisen, der die Ausführung `SinkIamRoleArn` ermöglicht`GenerateDataKey`. Wenn die Media Concatenation Pipeline verwendet werden soll, sollte der AWS KMS Schlüssel auch die Verwendung der Aktion ermöglichen. `Decrypt` Sehen Sie sich das folgende Beispiel an.

**Anmerkung**  
Die Ressource ist so eingestellt, dass sie Platzhalter verwendet`“*”`, was in diesem Zusammenhang einer AWS KMS wichtigen Richtlinie für „sich selbst“ steht.

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

Die `SinkIamRoleArn` Rolle muss über eine Vertrauensbeziehung verfügen, die es dem Dienst ermöglicht, sie zu übernehmen. Sehen Sie sich das folgende Beispiel an.

```
{
    "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>:*"
        }
    }
}
```

Sie `SinkIamRoleArn` sollten über die folgenden Mindestberechtigungsrichtlinien für Media Capture Pipeline verfügen. Sehen Sie sich das folgende Beispiel an.

```
{
    "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>:*"
        }
    }
}
```

Darüber hinaus muss dem Anrufer die Möglichkeit gegeben werden, `SinkIamRoleArn` zum Dienst weiterzuleiten. In Fällen, in denen der Anrufer nicht über eine solche Erlaubnis verfügt, sollte sie explizit hinzugefügt werden. Sehen Sie sich das folgende Beispiel an.

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

## Implementierung der Medienverkettung
<a name="media-concatenation-implementatoin"></a>

Wenn Sie beabsichtigen, die Media Concatenation Pipeline nach Media Capture zu verwenden, informieren Sie [Aufbau einer Amazon Chime SDK-Pipeline zur Medienverkettung](create-concat-pipe-steps.md) sich über die erforderlichen Berechtigungen. Damit die Pipeline mit dem AWS KMS Schlüssel für SSE auf Objektebene funktioniert, müssen die `SinkIamRoleArn` Berechtigungen (zulässige Aktionen) für den AWS KMS Schlüssel und den Amazon S3 S3-Bucket erweitert werden. Sehen Sie sich das folgende Beispiel an.

```
...
{
    ...
    {
        ...
        "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>/*",
    }
    ...
}
...
```

# Erstellung der Amazon Chime SDK-Medienerfassungspipeline
<a name="create-capture-pipe"></a>

Nachdem Sie Ihren Amazon S3-Bucket oder Ihre Amazon S3 S3-Buckets erstellt und konfiguriert haben, erstellen Sie eine Medienerfassungspipeline.

**Um eine Medienerfassungspipeline zu erstellen**
+ Rufen Sie die [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 auf.

  Verwenden Sie den Bucket-ARN als `SinkArn` Parameter.

Sobald der Vorgang erfolgreich ist, erstellt das Amazon Chime SDK einen Teilnehmer, der dem Meeting beitritt und es aufzeichnet.

Nachdem Sie eine Medienaufnahme-Pipeline erstellt und deren Berechtigungen festgelegt haben, erstellen Sie eine Medienverkettungspipeline, um die 5-Sekunden-Medienblöcke zu einer einzigen Datei zu verketten. Weitere Informationen finden Sie weiter unten in diesem Abschnitt. [Pipelines zur Medienverkettung für Amazon Chime SDK-Meetings erstellen](create-concat-pipe.md)

# Arbeiten mit Medienerfassungsartefakten des Amazon Chime SDK
<a name="artifacts"></a>

Während eines Amazon Chime SDK-Meetings erstellt eine Medienerfassungspipeline die folgenden Arten von Artefakten. 
+ Audio
+ Video
+ Datenkanalnachrichten
+ Besprechungsereignisse
+ Transkriptionsnachrichten

Die Pipeline erstellt die Artefakte in einer Reihe von Ordnern in Ihrem Amazon S3 S3-Bucket, und Sie können die Audio- und Videoordner so konfigurieren, dass bestimmte Arten von Artefakten eingeschränkt werden. In den folgenden Abschnitten werden die Ordnerstruktur, die Konfiguration von Ordnern, das Festlegen von Berechtigungen für Ihren Amazon S3 S3-Bucket und das Verketten der Artefaktdateien erläutert.

# Konfiguration des Audioordners für Amazon Chime SDK-Medienerfassungspipelines
<a name="configure-audio"></a>

Der Audioordner enthält MP4 5-Sekunden-Dateien des gemischten Audiostreams, d. h. sie enthalten Audio von allen Teilnehmern sowie das Video des aktiven Sprechers. Der Ordner enthält Dateien für das gesamte Meeting. Bei Bedarf können Sie den Ordner so konfigurieren, dass er nur die Audioartefakte enthält. Jeder Dateiname enthält einen min-seconds-milleseconds Zeitstempel von *yyyy-mm-dd-hour-*. Der Zeitstempel ist in UTC und markiert die Startzeit. Sie können den Ordner so konfigurieren, dass er nur Audioartefakte enthält.

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

# Konfiguration des Videoordners für Amazon Chime SDK-Medienerfassungspipelines
<a name="configure-video"></a>

Der Videoordner enthält MP4 5-Sekunden-Dateien, die Videostreams sowie Streams zur gemeinsamen Nutzung von Inhalten enthalten, sofern diese in der API-Anfrage angegeben sind. Jeder Dateiname enthält einen < yyyy-mm-dd-hour - min-seconds-milleseconds >- <attendeeID>Zeitstempel mit einer Teilnehmer-ID. <attendeeID>Der Videoblock zum Teilen von Inhalten wird als < yyyy-mm-dd-hour - min-seconds-milleseconds >- \$1content .mp4 angehängt. Sie können den Ordner so konfigurieren, dass er nur Videoartefakte enthält.

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

# Grundlegendes zu Nachrichten im Datenkanalordner für Amazon Chime SDK-Medienerfassungspipelines
<a name="data-channel"></a>

Der Datenkanalordner enthält Datennachrichten im TXT-Format, und jede Nachricht ist ein JSON-Objekt. Nachrichten sind mit allen Konfigurationsoptionen sichtbar. Dateinamen enthalten den min-seconds-milleseconds Zeitstempel *yyyy-mm-dd-hour-*. Dieses Beispiel zeigt die Datenfelder in einer Nachricht.

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

# Grundlegendes zur Amazon S3 S3-Bucket-Ordnerstruktur für Amazon Chime SDK-Medienerfassungspipelines
<a name="capture-folder-structure"></a>

Die Amazon S3 S3-Buckets für Medienerfassungspipelines verwenden diese Ordnerstruktur.

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

# Grundlegendes zu Besprechungsereignisdateien für Medienerfassungspipelines des Amazon Chime SDK
<a name="meeting-events"></a>

Der Ordner Meeting-Events enthält Besprechungsereignisse im TXT-Format, und jedes Ereignis ist ein JSON-Objekt. Nachrichten sind mit allen Konfigurationsoptionen sichtbar. Dateinamen enthalten den Zeitstempel < yyyy-mm-dd-hour - min-seconds-milleseconds >. Dieses Beispiel zeigt die Felder und Daten in einer typischen Ereignisdatei.

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

# Grundlegendes zu Transkriptionsdateien für Amazon Chime SDK-Medienerfassungspipelines
<a name="transcription-messages"></a>

Der Ordner Transcription-Messages enthält Transkriptionsdateien im TXT-Format. Der Ordner empfängt jedoch nur Dateien, wenn Sie die Live-Transkription aktivieren. Weitere Informationen zur Aktivierung der Live-Transkription finden Sie unter. [Live-Transkription mit Amazon Chime SDK verwenden](meeting-transcription.md)

Der Ordner enthält alle teilweisen und vollständigen Transkriptionsnachrichten, und jede Nachricht ist ein JSON-Objekt. Dateinamen enthalten den Zeitstempel < yyyy-mm-dd-hour - min-seconds-milleseconds >. Beispiele für Transkriptionsdateien finden Sie unter. [Verarbeitung eines empfangenen Amazon Chime SDK-Live-Transkriptereignisses](delivery-examples.md)

# Verkettung von Datenströmen für Medienerfassungspipelines des Amazon Chime SDK
<a name="concatenate-streams"></a>

**Anmerkung**  
Informationen zur Automatisierung der Verkettung von Medienerfassungsartefakten finden Sie in diesem Handbuch. [Pipelines zur Medienverkettung für Amazon Chime SDK-Meetings erstellen](create-concat-pipe.md)

In diesem Beispiel wird ffmpeg verwendet, um Video- oder Audiodateien zu einer einzigen MP4-Datei zu verketten. Erstellen Sie zunächst eine Datei filelist.txt, die alle Eingabedateien enthält. Verwenden Sie dieses Format: 

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

Verwenden Sie als Nächstes diesen Befehl, um die Eingabedatei zu verketten:

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

Weitere Informationen zu Pipelines zur Medienverkettung finden Sie in diesem Handbuch. [Pipelines zur Medienverkettung für Amazon Chime SDK-Meetings erstellen](create-concat-pipe.md)

# Pipelines zur Medienverkettung für Amazon Chime SDK-Meetings erstellen
<a name="create-concat-pipe"></a>

Sie verwenden Medienverkettungspipelines, um die durch Medienerfassungspipelines generierten Artefakte (Dateien) zu verketten.

Medienerfassungspipelines erfassen den Inhalt eines Meetings, indem sie die Medienstreams aufteilen und diese Artefakte in Ihrem Amazon S3 S3-Bucket speichern. Medienerfassungspipelines erzeugen die folgenden Arten von Artefakten: 
+ Audio
+ Video
+ Inhalte werden geteilt
+ Datenkanal-Nachrichten
+ Transkriptionsnachrichten
+ Besprechungsereignisse
+ Zusammengesetztes Video, d. h. geteilte Inhalte und mehrere Videostreams, die in einem Raster als Videokacheln angezeigt werden.

Medienverkettungspipelines ermöglichen es Ihnen, jeden Artefakttyp zu einer einzigen Datei zu verketten und diese größeren Dateien dann in Ihrem Amazon S3 S3-Bucket zu speichern. Sie können eine Medienverkettungspipeline erstellen, ohne auf das Ende des Medienerfassungsereignisses zu warten. Die Verkettungspipeline beginnt jedoch erst, wenn die Capture-Pipeline beendet wird.

**Anmerkung**  
Medienerfassungspipelines, Medienverkettungspipelines und Amazon S3 S3-Buckets müssen sich im selben Konto befinden. AWS 

**Topics**
+ [Architektur der Amazon Chime SDK-Verkettungspipeline](concat-architecture.md)
+ [Aufbau einer Amazon Chime SDK-Pipeline zur Medienverkettung](create-concat-pipe-steps.md)
+ [Grundlegendes zur Amazon S3 S3-Bucket-Ordnerstruktur für Amazon Chime SDK-Verkettungspipelines](concat-folder-structure.md)

# Architektur der Amazon Chime SDK-Verkettungspipeline
<a name="concat-architecture"></a>

Das folgende Diagramm zeigt die Architektur einer Medienverkettungspipeline.

![\[Diagramm, das die Architektur einer Medienverkettungspipeline zeigt.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/concatenation-pipe-architecture-2.png)


In dem Diagramm startet die Medien-Pipeline-Steuerebene beim Empfang einer [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)Anfrage eine Medienerfassungspipeline in der Medien-Pipeline-Datenebene. Die Datenebene überträgt dann alle 5 Sekunden die erfassten Chunks in den Capture-Bucket. Beim Empfang einer [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)Anfrage wartet die Steuerungsebene der Medienpipeline, bis die angegebene Medienerfassungspipeline abgeschlossen ist, und startet dann eine Medienverkettungspipeline in der Medien-Pipeline-Datenebene. Die Datenebene liest dann die erfassten Blöcke im Bucket und überträgt die verketteten Artefakte in den Verkettungs-Bucket.

# Aufbau einer Amazon Chime SDK-Pipeline zur Medienverkettung
<a name="create-concat-pipe-steps"></a>

Sie folgen einem mehrstufigen Prozess, um eine Amazon Chime SDK-Pipeline zur Medienverkettung zu erstellen. In den folgenden Schritten wird der Prozess beschrieben.

1. Erstellen Sie einen Amazon S3 S3-Bucket, der als Datensenke der Media Capture-Pipeline verwendet werden soll, und konfigurieren Sie dann die Bucket-Richtlinie. Informationen zur Aktivierung der serverseitigen Verschlüsselung für den Amazon S3 S3-Bucket finden Sie unter [Serverseitige Verschlüsselung für einen Amazon S3-Bucket aktivieren](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html) in diesem Handbuch. Wenn Sie einen Amazon Amazon S3 S3-Bucket zur Verwendung mit Medienerfassungspipelines erstellt haben, müssen Sie die `s3:ListBucket` Aktionen `s3:GetObject` und zur Richtlinie dieses Buckets hinzufügen. Für die `s3:ListBucket` Aktion ist eine Genehmigung für den Bucket erforderlich. Für die anderen Aktionen ist eine Genehmigung für die Objekte im Bucket erforderlich. Sie müssen zwei verschiedene Amazon-Ressourcennamen (ARNs) verwenden, um Berechtigungen auf Bucket- und Objektebene anzugeben.

   Das folgende Beispiel zeigt die Bucket-Richtlinie. Kopieren Sie dieses Beispiel und fügen Sie es nach Bedarf ein.

------
#### [ 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.  Erstellen Sie einen Amazon Amazon S3 S3-Bucket, der als Datensenke der Media Concatenation Pipeline verwendet werden soll, und konfigurieren Sie dann die Bucket-Richtlinie. Informationen zur Aktivierung der serverseitigen Verschlüsselung für den Amazon S3 S3-Bucket finden Sie unter [Serverseitige Verschlüsselung für einen Amazon S3-Bucket aktivieren](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html) in diesem Handbuch. 

   Das folgende Beispiel zeigt die Richtlinie.

------
#### [ 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:*"
                   }
               }
           }
       ]
   }
   ```

------
**Anmerkung**  
Sie können einen einzigen Amazon S3 S3-Bucket für Medienerfassungs- und Medienverkettungspipelines verwenden. In diesem Fall müssen Sie jedoch der in Schritt 2 beschriebenen Richtlinie für Medienverkettungen die `s3:ListBucket` Berechtigungen `s3:GetObject` und hinzufügen. Wenn Sie nicht möchten, dass die Concatenation-Bucket-Richtlinie über diese Berechtigungen verfügt, erstellen Sie separate Buckets für jede Pipeline. 

1. Verwenden Sie die [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, um eine Medienerfassungspipeline zu erstellen. Besorgen Sie sich als Teil davon den ARN der Pipeline. Informationen zum Abrufen des ARN finden Sie unter[Grundlegendes zur Erstellung der Amazon Chime SDK-Medienpipeline](create-pipeline.md). Sie verwenden den ARN im nächsten Schritt.

1. Verwenden Sie die [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, um eine Verkettungspipeline zu erstellen.

   Das folgende Beispiel zeigt einen Anforderungstext. Das *Path* Feld ist optional und enthält standardmäßig die ID der Verkettungspipeline.
**Anmerkung**  
Sie müssen eine verwenden, die in den `MediaPipelineArn` letzten 30 Tagen erstellt wurde.

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

   Die Verkettung beginnt immer dann, wenn die Capture-Pipeline stoppt. Die Verkettungspipeline wird nach Abschluss der Verkettung gestoppt.

# Grundlegendes zur Amazon S3 S3-Bucket-Ordnerstruktur für Amazon Chime SDK-Verkettungspipelines
<a name="concat-folder-structure"></a>

Die Amazon S3 S3-Buckets für Medienverkettungspipelines verwenden diese Ordnerstruktur:

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

**Anmerkung**  
**Wenn Sie beim Erstellen einer Medienpipeline ein Präfix angeben, wird der Pfad zu den Ordnern zum Bucket-Name/Präfix.** Ohne Präfix wird der Pfad zu *Bucket-Name*/*Medien-Pipeline-ID*. Sie geben ein Präfix im `Destination` Feld des `S3BucketSinkConfiguration` Objekts an. Die verketteten Dateinamen bestehen aus der *Medien-Pipeline-ID .mp4 für Mediendateien* und der *Medien-Pipeline-ID .txt* für Textdateien.

# Erstellung von Media Live Connector-Pipelines für Amazon Chime SDK-Meetings
<a name="connector-pipe-config"></a>

In den folgenden Abschnitten werden das Real-Time Messaging Protocol (RTMP) sowie die Audio- und Videoeinstellungen für eine Media Live Connector-Pipeline aufgeführt und beschrieben.

**RTMP-Einstellungen**  
Media Live Connector-Pipelines unterstützen RTMP über eine Verbindung. TLS/SSL Die Senken-URL besteht aus der Stream-URL und dem Stream-Schlüssel. Sie URLs folgen diesem Format:

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

Die folgenden Beispiele zeigen, wie Sie eine Verbindung zu gängigen Streaming-Plattformen herstellen können.
+ **Amazon Interactive Video Service (IVS) — rtmps: //a1b2c3d4e5f6.global-contribute.live-video.net:443/app/** *IVS-stream-key*
+ **YouTube**— rtmps: //a.youtube.com/live2/ *stream-key*
+ **Twitch —** rtmps: //live.twitch.tv/app/ *primary-stream-key*

**Wichtig**  
RTMPS verwendet Verschlüsselung, um sicherzustellen, dass ein Stream nicht von einer nicht autorisierten Entität abgefangen wird. Es hat sich bewährt, RTMPS zu verwenden, wenn Sie zusätzliche Datensicherheit benötigen.

**Audioeinstellungen**  
Media Live Connector-Pipelines unterstützen die folgenden Audioeinstellungen:
+ **Codec — AAC**
+ **Abtastrate** — 44100 Hz oder 48000 Hz. Die Standardeinstellung ist 44100 Hz.
+ **Kanäle** — Mono oder Stereo. Die Standardeinstellung ist mono.

**Videoeinstellungen**  
Media Live Connector-Pipelines verwenden den H264-Encoder. Sie können HD bei 1280x720 oder FHD bei 1920x1080 verwenden. Beide Auflösungen verwenden 30 Bilder pro Sekunde, wobei alle zwei Sekunden ein Keyframe erscheint.

**Stoppt die Media Live Connector-Pipelines**  
Rufen Sie als bewährte Methode zum Stoppen von Media Live Connector-Pipelines die API auf [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). Durch das Beenden eines Streams auf einer Streaming-Plattform wie IVS wird eine Media Live Connector-Pipeline nicht gestoppt.

# Medienstream-Pipelines mit dem Amazon Chime SDK erstellen
<a name="create-media-stream-pipeline"></a>

Medienstream-Pipelines erfassen einzelne Audiodaten für alle Teilnehmer einer Besprechung sowie gemischte Audiodaten, die durch eine Medienverkettungspipeline generiert werden. Alle Medienstream-Pipelines speichern ihre Daten in [Amazon Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/what-is-kinesis-video.html) (KVS).

Sie erstellen den Videostream, indem Sie die API aufrufen. [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) Sie können eine Medienstream-Pipeline pro Amazon Chime SDK-Meeting erstellen.

**Anmerkung**  
Wenn für ein Meeting eine Opt-in-Region verwendet wird [MediaRegion](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html#chimesdk-meeting-chime_CreateMeeting-request-MediaRegion), muss sich der KVS-Stream in derselben Region befinden. Wenn ein Meeting beispielsweise die `af-south-1` Region verwendet, muss sich auch der KVS-Stream in der Region befinden. `af-south-1` Wenn das Meeting jedoch eine Region verwendet, die AWS standardmäßig aktiviert, kann sich der KVS-Stream in jeder verfügbaren Region befinden, einschließlich einer Opt-in-Region. Wenn das Meeting beispielsweise verwendet`ca-central-1`, kann sich der KVS-Stream in`eu-west-2`,`us-east-1`, oder einer anderen Region befinden`af-south-1`, die das Amazon Chime SDK unterstützt.  
Um zu erfahren, welche AWS Region ein Meeting verwendet, rufen Sie die [GetMeeting](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_GetMeeting.html)API auf und verwenden Sie den [MediaRegion](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html#chimesdk-meeting-chime_CreateMeeting-request-MediaRegion)Parameter aus der Antwort.  
Weitere Informationen zu Regionen, für die Sie sich anmelden können, finden Sie [Verfügbare AWS-Regionen für das Amazon Chime SDK](sdk-available-regions.md) in diesem Leitfaden und unter [Spezifizieren Sie, welche AWS Regionen Ihr Konto verwenden kann](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#rande-manage-enable.html), im *Referenzhandbuch zur AWS Kontoverwaltung.*

In den folgenden Abschnitten wird erklärt, wie Sie eine Medienstream-Pipeline erstellen. Gehen Sie nach der aufgeführten Reihenfolge vor.

**Topics**
+ [Erstellen eines Kinesis Video Streams Streams-Pools für Amazon Chime SDK-Medienstream-Pipelines](create-kvs-pool.md)
+ [Beispielcode für Kinesis Video Streams Streams-Pools für Amazon Chime SDK-Medienstream-Pipelines](pool-creation-code.md)
+ [Erstellen von Amazon Chime SDK-Medienstream-Pipelines](create-stream-pipeline.md)
+ [Beispielcode für Amazon Chime SDK-Medienstream-Pipelines](pipeline-creation-code.md)
+ [Verwenden von Event Bridge-Benachrichtigungen für Amazon Chime SDK-Medienstream-Pipelines](media-stream-event-bridge.md)
+ [Verwenden von Medienstream-Pipeline-Daten im Amazon Chime SDK](media-stream-tips-tricks.md)

# Erstellen eines Kinesis Video Streams Streams-Pools für Amazon Chime SDK-Medienstream-Pipelines
<a name="create-kvs-pool"></a>

Der Kinesis Video Streams (KVS) -Pool für Ihre Medienstream-Pipeline muss zu demselben AWS Konto gehören wie das Amazon Chime SDK-Meeting. Sie erstellen einen Kinesis Video Streams Streams-Pool, indem Sie die [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 aufrufen.

Das folgende Diagramm zeigt die Architektur eines Kinesis Video Streams Streams-Pools für Medienpipeline. Die Zahlen im Bild entsprechen dem unten nummerierten Text:

![\[Diagramm, das einen API-Aufruf zeigt, der einen Kinesis Video Streams Streams-Pool erstellt.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/media-stream-pool-architecture.png)


Im Diagramm:

1. Sie rufen die [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 auf.

1. Die Media Pipeline-Kontrollebene erstellt und verwaltet die Kinesis Video Streams (KVS) und den Pool in Ihrem Namen in Ihrem Konto.

Der KVS-Poolbetrieb, d. h. das Erstellen, Aktualisieren und Löschen von Streams im Pool, erfolgt asynchron. Aus diesem Grund verwenden Event Bridge-Benachrichtigungen den `Chime Media Pipeline Kinesis Video Pool State Change` Detailtyp, um den Status der Streams in einem Pool zu kommunizieren.

Sie können einen Pool einmal erstellen und ihn für verschiedene Besprechungen wiederverwenden. Sie können auch nach Bedarf verschiedene Pools erstellen und Pools löschen, wenn Sie sie nicht benötigen.

Pools werden automatisch auf der Grundlage Ihrer Anzahl gleichzeitiger Anrufe skaliert. Sie können alle nicht benötigten Pools löschen.

**Anmerkung**  
Wenn Sie einen Pool löschen, müssen Sie warten, bis der Pool vollständig gelöscht ist, bevor Sie die KVS-Streams im Pool löschen. Eine Event Bridge-Benachrichtigung zeigt an, wenn der Pool vollständig gelöscht wurde. Dies geschieht, nachdem alle Besprechungen, die den Pool nutzen, beendet sind. Sie können auch die [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 aufrufen, um den `PoolId` für einen bestimmten KVS-Pool anzuzeigen.  
Wenn Sie die Kinesis Video Streams [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html)Streams-API aufrufen, können Sie diese Benennungszeichenfolge verwenden, um nach den Streams in einem Pool zu suchen und diese zu löschen. Sie können die [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 auch aufrufen, um die `PoolId` für einen bestimmten KVS-Pool anzuzeigen. Die Beispiele im nächsten Abschnitt erklären, wie das geht.

# Beispielcode für Kinesis Video Streams Streams-Pools für Amazon Chime SDK-Medienstream-Pipelines
<a name="pool-creation-code"></a>

Die folgenden Beispiele zeigen, wie Kinesis Video Streams (KVS) -Pools erstellt, aktualisiert, abgerufen, aufgelistet und gelöscht werden. Erweitern Sie jeden Abschnitt, um mehr zu erfahren.

## Importe und allgemeine Variablen
<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'])
```

**Ausgabe:**

```
{
    "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'])
```

**Ausgabe:**

```
{
    "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'])
```

**Ausgabe:**

```
{
    "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)
```

**Ausgabe:**

```
[
    {
        "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
)
```

**Ausgabe**: Eine erfolgreiche `delete_media_pipeline_kinesis_video_stream_pool` Anfrage hat keinen Hauptteil.

# Erstellen von Amazon Chime SDK-Medienstream-Pipelines
<a name="create-stream-pipeline"></a>

Die Chime Media Stream-Pipeline muss zu demselben AWS Konto gehören wie das Amazon Chime SDK-Meeting. Sie erstellen die Amazon Chime SDK-Medienstream-Pipeline, indem Sie die [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 aufrufen und eine Quelle und eine Senke angeben.

Das folgende Diagramm zeigt die Architektur einer Amazon Chime SDK-Medienstream-Pipeline. Die Zahlen im Diagramm entsprechen dem nummerierten Text unten.

![\[Das Diagramm zeigt einen API-Aufruf, der einen Medienstream-Pool erstellt.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/media-stream-pipe-architecture.png)


Im Diagramm:

1. Sie rufen die `CreateMediaStreamPipeline` API auf. Geben Sie in der Anfrage die Quellen und Senken für die Streams an. Geben Sie an, ob Sie Einzelaudio, gemischtes Audio oder beides aufnehmen möchten. Geben Sie den ARN Ihres KVS-Pools in die Anfrage ein.
   + Das Quellen-Array besteht aus `SourceType` und`SourceArn`. Sie müssen die verwenden`ChimeSdkMeeting SourceType`. Das `SourceArn` ist der ARN von`ChimeSdkMeeting`.
   + Das Sinks-Array besteht aus`SinkType`, `SinkArn``ReservedStreamCapacity`, und`MediaStreamType`. Wir unterstützen nur die`KinesisVideoStreamPoolSinkType`. Das `SinkArn` ist der ARN von`KinesisVideoStreamPool`. Der `MediaStreamType` steuert den Medientyp, der zur Senke gestreamt wird, entweder `MixedAudio` oder`IndividualAudio`. `ReservedStreamCapacity`legt die Anzahl der Streams fest, die dem `MediaStreamType` `KinesisVideoStreamPool` vom zugewiesen wurden.
     + Wenn Sie `IndividualAudio` sowohl als auch streamen möchten`MixedAudio`, erstellen Sie zwei Senkenobjekte im `Sinks` Array, eines für `IndividualAudio` und eines für`MixedAudio`. Der `SinkArn` (der ARN von`KinesisVideoStreamPool`) kann für jede Senke variieren.
     + Um nur einzelne Audiodaten oder gemischte Audiodaten zu streamen, erstellen Sie ein Senkenobjekt mit den gewünschten Audiodaten`MediaStreamType`.
   + Beachten Sie Folgendes:
     + Wenn Sie die [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 mit `KinesisVideoStreamPool` as the aufrufen`SinkType`, `SinkARN` muss sie zu der Region der Steuerungsebene gehören, in der sie aufgerufen `CreateMediaStreamPipeline` wird.

       Wenn Sie beispielsweise eine Medienstream-Pipeline in erstellen`us-east-1`, müssen Sie einen `KinesisVideoStreamPool` Eingang verwenden. `us-east-1`
     + `ReservedStreamCapacity`sollte sein, **1** wenn Sie den angeben `MixedAudio``MediaStreamType`, und dazwischen, **1-10** wenn Sie den angeben `IndividualAudio``MediaStreamType`.

1. Die Datenebene der Medienpipeline ruft die [ PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)KVS-API auf, um einzelne Audiodaten in einem KVS-Stream zu speichern, der zu dem von Ihnen angegebenen KVS-Pool gehört.

1. Die Datenebene der Medienpipeline ruft die `PutMedia` KVS-API auf, um gemischtes Audio in einem Stream zu speichern, der zu dem von Ihnen angegebenen KVS-Pool gehört.

**Anmerkung**  
Nach dem Aufruf der [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 können Builder [Medien-Pipeline-Ereignisse](media-pipe-events.md) verwenden oder die [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 aufrufen, um festzustellen, ob der Pipeline-Status lautet. `InProgress`  
Sobald der Pipeline-Status erreicht ist`InProgress`, werden die Medien — eine beliebige Kombination von `IndividualAudio` und `MixedAudio` — zu KVS gestreamt.   
Für den `IndividualAudio` Stream-Typ besteht eine 1:1 -Zuordnung zwischen dem Teilnehmer IDs und dem aus dem zugewiesenen KVS-Stream. `KinesisVideoStreamPool` Die Zuordnung gilt für die gesamte Lebensdauer der Medienpipeline.  
Um herauszufinden, welcher KVS-Stream einer Teilnehmer-ID zugeordnet ist oder für welchen er zugewiesen ist MixedAudio, verwenden Sie eine der folgenden Methoden:  
Verwenden Sie [Event Bridge-Benachrichtigungen](media-stream-event-bridge.md). Jede Benachrichtigung enthält Informationen wie den Teilnehmer IDs und den KVS-ARN, der das Audio des Teilnehmers streamt. Wenn eine `IndividualAudio` oder `MixedAudio` Streaming-Sitzung beginnt, senden wir ein Ereignis. `chime:MediaPipelineKinesisVideoStreamStart` Streaming-Sitzungen enden, wenn ein Teilnehmer den Anruf (für`IndividualAudio`) verlässt oder wenn das Meeting endet.
Verwenden Sie die persistenten Metadaten, die die Kinesis Video Streams mit jedem Fragment senden. Die Metadaten enthalten Informationen, die denen ähneln, die Event Bridge sendet. Builder müssen mit dieser Lösung alle Streams von analysieren, `KinesisVideoStreamPool` indem sie den Poolnamen als Präfix in der [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html)Kinesis Video Streams Streams-API angeben.
Die Media Stream-Pipeline wird beendet, wenn das Meeting gelöscht oder die [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 für diese Media-Stream-Pipeline aufgerufen wird. Eine [Event Bridge-Benachrichtigung](media-pipe-events.md) wird ebenfalls gesendet, um auf die Beendigung der Medienpipeline hinzuweisen.

# Beispielcode für Amazon Chime SDK-Medienstream-Pipelines
<a name="pipeline-creation-code"></a>

Die folgenden Beispiele zeigen, wie Medienstream-Pipelines für gemischtes Audio, individuelles Audio und beides erstellt werden. Erweitern Sie jeden Abschnitt, um mehr zu erfahren.

## CreateMediaStreamPipelinefür gemischtes Audio
<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'
        },
    ]
)
```

**Antwort:**

```
{
    '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'
            },
        ]
    }
}
```

## CreateMediaStreamPipelinefür individuelles Audio
<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'
        },
    ]
)
```

**Antwort:**

```
{
    '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'
            },
        ]
    }
}
```

## CreateMediaStreamPipelinefür gemischtes und individuelles Audio
<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'
        },
    ]
)
```

**Antwort:**

```
{
    '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'
            },
        ]
    }
}
```

# Verwenden von Event Bridge-Benachrichtigungen für Amazon Chime SDK-Medienstream-Pipelines
<a name="media-stream-event-bridge"></a>

Darüber hinaus senden Medienstream-Pipelines Event Bridge-Benachrichtigungen[Medien-Pipeline-Ereignisse des Amazon Chime SDK verwenden](media-pipe-events.md), wenn sie das Streaming an KVS starten und beenden und wenn sich der Status des Videopools ändert.

**Topics**
+ [Grundlegendes zu Medienstream-Pipeline-Ereignissen im Amazon Chime SDK](stream-pipe-events.md)
+ [Grundlegendes zu Kinesis Video Streams Streams-Poolereignissen für Amazon Chime SDK-Medienstream-Pipelines](media-stream-pool-events.md)

# Grundlegendes zu Medienstream-Pipeline-Ereignissen im Amazon Chime SDK
<a name="stream-pipe-events"></a>

Medienstream-Pipelines senden die folgenden Ereignisse. Erweitern Sie jeden Abschnitt, um mehr zu erfahren.

## Amazon Chime Media Stream-Pipeline Kinesis Video Stream starten
<a name="stream-pipe-kvs-start"></a>

Die Amazon Chime SDK-Medienpipeline sendet dieses Ereignis, wenn die Medienstream-Pipeline beginnt, Audio vom Meeting zu empfangen und dieses Audio an KVS zu streamen. Leere `ExternalUserId` Felder `AttendeeId` und geben an, dass die Medienpipeline gemischte Audiodaten an den KVS-Stream gesendet hat.

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

## Amazon Chime Media Stream-Pipeline Kinesis Video Stream End
<a name="stream-pipe-kvs-stop"></a>

Die Medienpipeline sendet dieses Ereignis an Event Bridge, wenn das Streaming zu KVS beendet wird.

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

# Grundlegendes zu Kinesis Video Streams Streams-Poolereignissen für Amazon Chime SDK-Medienstream-Pipelines
<a name="media-stream-pool-events"></a>

Medien-Pipelines senden die folgenden Ereignisse an Event Bridge, wenn sich der Status der Pools ändert. Erweitern Sie jeden Abschnitt, um mehr zu erfahren.

## Amazon Chime Media Pipeline Kinesis Videopool aktiv
<a name="kvs-pool-active"></a>

Die Medienpipeline sendet dieses Ereignis. Es wird gesendet, nachdem die [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 einen Pool erstellt hat.

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

## Amazon Chime Chime Media Pipeline Kinesis Videopool aktualisiert
<a name="kvs-pool-updated"></a>

Die Medienpipeline sendet dieses Ereignis, nachdem die [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 einen Pool aktualisiert hat.

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

## Amazon Chime Media Pipeline Kinesis-Videopool gelöscht
<a name="kvs-pool-deleted"></a>

Die Medienpipeline sendet dieses Ereignis an Event Bridge, wenn sie einen Pool [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)löscht.

Weitere Informationen zum Löschen von Pools finden Sie [Erstellen eines Kinesis Video Streams Streams-Pools für Amazon Chime SDK-Medienstream-Pipelines](create-kvs-pool.md) in diesem Abschnitt.

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

## Vorübergehender Ausfall von Amazon Chime Media Pipeline Kinesis Video Pool
<a name="kvs-pool-temp-failure"></a>

Die Medienpipeline sendet das folgende Ereignis an Event Bridge, wenn ein Videopool vorübergehend ausfällt.

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

## Dauerhafter Ausfall von Amazon Chime Media Pipeline Kinesis Video Pool
<a name="kvs-pool-perm-failure"></a>

Die Medienpipeline sendet das folgende Ereignis an Event Bridge, wenn ein Videopool dauerhaft ausfällt.

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

Sie erhalten das folgende zusätzliche Media Pipeline-Ereignis, wenn Ihr AWS-Konto das Amazon Kinesis Kinesis-Videostream-Limit überschritten hat.

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

# Verwenden von Medienstream-Pipeline-Daten im Amazon Chime SDK
<a name="media-stream-tips-tricks"></a>

Sie können die Metadaten in den Benachrichtigungen verwenden, um KVS ARNs, Fragmentnummern und Fragmentzeitstempel abzurufen. Diese Informationen können Ihnen helfen, die Audiodaten in einem KVS-Stream zu verarbeiten.

Sie können KVS auch ARNs zusammen mit dem KVS verwenden, um Daten aus einem Stream APIs zu lesen. Je nach Anwendungsfall rufen Sie und auf [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html). [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 In der Regel geht einem `GetMediaForFragmentList` Aufruf der API ein Aufruf der [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_ListFragments.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_ListFragments.html)API voraus. Weitere Informationen finden Sie unter [Lesen von Daten aus Streams](https://aws.amazon.com/kinesis/video-streams/faqs/) in *Amazon Kinesis Video Streams FAQs*.

Je nach Anwendungsfall können Builder die Kinesis Video Streams Streams-Parser-Bibliothek verwenden, die wiederum die KVS-API verwendet. [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html)

Medienstream-Pipelines fügen jedem Fragment die folgenden Metadaten für Besprechungen und Teilnehmer hinzu.

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

Mediendaten werden im MKV-Format gespeichert. Alle MKV-Audiodaten sind AAC-codiert. Weitere Informationen finden Sie im [Kinesis Video Streams-Datenmodell](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-data.html) im *Kinesis Video Streams Developer Guide*.

# Zusammenstellen von Audio und Video in einer einzigen Ansicht in Amazon Chime SDK-Meetings
<a name="pipeline-compositing"></a>

Die Medien-Pipelines des Amazon Chime SDK unterstützen die Zusammenstellung von Audio- und Webcam-Videos sowie Videostreams zum Teilen von Inhalten in einer einzigen Ansicht. Sie können dann den Live Connector verwenden, um diese einzelne Ansicht an Streaming-Dienste wie Amazon Interactive Video Service, Twitch oder YouTube Live zu senden. Zusammengesetzte Videos können auch zur Speicherung oder weiteren Verwendung in Amazon Simple Storage Service aufgenommen werden.

Beim Compositing wird ein sogenanntes Standard-Bildschirmlayout verwendet`GridView`, das sich wie folgt verhält. 
+ Wenn nur Webcam-Videos aktiv sind, werden die Streams nach dem folgenden Rastermuster `GridView` organisiert:  
![\[Ein vierspaltiges, vierreihiges Raster, das die Umrisse von Personen zeigt.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/grid-no-content-share.png)

  Das Raster zeigt maximal 25 Webcam-Streams an und ordnet die Kacheln danach an, wann Benutzer ihre Kameras einschalten.
+ `GridView`bietet zwei Ausrichtungen der Leinwand, `Landscape` und`Portrait`. Querformat, die Standardausrichtung, unterstützt Videoauflösungen von 1280 x 720 und 1920 x 1080 für FHD. Portrait unterstützt Auflösungen von 720x1280 und 1080x1920 für FHD.
+ Sie können die Reihenfolge, Position, Gesamtzahl, das Seitenverhältnis der Kacheln, den Eckenradius, die Randfarbe, die Randstärke und die Hervorhebungsfarbe der Videokacheln konfigurieren.
+ Wenn während einer Besprechung jemand seinen Bildschirm teilt, wechseln die Videokacheln der Webcam dynamisch, um Platz für die gemeinsame Nutzung von Inhalten zu schaffen. Sie steuern diese Übergänge und die Positionen der Videokacheln mithilfe einer der Layoutkonfigurationen, die im nächsten Abschnitt beschrieben werden.

**Über die Layoutkonfigurationen**  
Wenn jemand eine Inhaltsfreigabe startet, können Sie mithilfe einer der folgenden Layoutkonfigurationen wählen, wie die Inhaltsfreigabe und die Webcam-Videostreams zusammengesetzt werden sollen.
+ `ActiveSpeakerOnlyConfiguration`setzt das Inhaltsvideo im Vollbildmodus zusammen, wobei das Webcam-Video des aktiven Sprechers in einer Ecke überlagert wird. Sie können die Ecke angeben.
+ `PresenterOnlyConfiguration`setzt das Inhaltsvideo im Vollbildmodus zusammen, wobei das Webcam-Video des Moderators in einer Ecke eingeblendet wird. Sie können die Ecke angeben.
+ `VerticalLayoutConfiguration`setzt das Inhaltsvideo mit dem Webcam-Video in einer angrenzenden vertikalen Spalte zusammen. Sie können die Spalte rechts oder links neben der Inhaltsfreigabe anzeigen.
+ `HorizontalLayoutConfiguration`setzt das Inhaltsvideo mit dem Webcam-Video in einer angrenzenden horizontalen Reihe zusammen. Sie können die Zeile über oder unter der Inhaltsfreigabe anzeigen.

Bei zusammengesetzten Layouts wird automatisch zwischen dem `GridView` ausgewählten Layout gewechselt, je nachdem, ob die gemeinsame Nutzung von Inhalten aktiv ist oder nicht.

In den folgenden Themen wird erklärt, wie Sie die globalen `GridView` Einstellungen und die einzelnen Konfigurationslayouts verwenden.

**Topics**
+ [Einstellung der Leinwandausrichtung für Compositing in Amazon Chime SDK-Meetings](canvas-orientation.md)
+ [Festlegen von Rahmen- und Eckattributen für das Compositing in Amazon Chime SDK-Meetings](video-attribute.md)
+ [Verwenden der Layoutkonfigurationen für das Compositing in Amazon Chime SDK-Meetings](compositing-layouts.md)

# Einstellung der Leinwandausrichtung für Compositing in Amazon Chime SDK-Meetings
<a name="canvas-orientation"></a>

Beim Compositing enthält die *Leinwand* alle Ihre Videostreams. Sie können eine `Landscape` `Portrait` Oder-Ausrichtung für die Leinwand angeben. Das Querformat bietet ein Seitenverhältnis von 16:9. Portrait bietet ein Seitenverhältnis von 9:16.

Die folgende Abbildung zeigt die Ausrichtung im Hochformat.

![\[Das Bild zeigt zwei Videokacheln in einem Fenster im Hochformat (vertikal).\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/compositing-portrait-with-tile.png)


Das folgende Beispiel zeigt, wie eine Leinwand im Portraitformat mit der Videokachel in der oberen rechten Ecke implementiert wird. In diesem Beispiel erscheint der aktive Sprecher in der Kachel. Weitere Informationen finden Sie unter [ActiveSpeakerOnlyConfiguration](compositing-layouts.md#active-speaker-only).

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

Die folgende Abbildung zeigt die Ausrichtung im Querformat.

![\[Das Bild zeigt zwei Videokacheln in einem Fenster im Querformat (horizontal).\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/compositing-landscape-with-tile.png)


**CanvasOrientation**  
*Beschreibung* — Die Ausrichtungseinstellung, Querformat oder Hochformat.  
*Zulässige Werte* — `Landscape` \$1 `Portrait`  
*Erforderlich* — Nein  
*Standard* — Querformat

# Festlegen von Rahmen- und Eckattributen für das Compositing in Amazon Chime SDK-Meetings
<a name="video-attribute"></a>

Wie gewünscht können Sie den `VideoAttribute` Parameter verwenden, um die Rand- und Eckeinstellungen für Ihre Videokacheln festzulegen. Sie können Farben, Breiten und abgerundete Ecken angeben. Sie können auch eine Markierungsfarbe angeben, und der Rand nimmt diese Farbe an, wenn jemand spricht. 

Ihre Attributeinstellungen gelten für alle Layouts, unabhängig davon, ob Inhalte gemeinsam genutzt werden.

Die folgende Abbildung zeigt eine Videokachel, auf die eine Rahmenfarbe und ein Eckenradius angewendet wurden.

![\[Bild einer Bildschirmübertragung und einer Videokachel mit rotem Rand und abgerundeten Ecken.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/compositing-speaker-border.png)


Das folgende Beispiel zeigt, wie die einzelnen Attribute verwendet werden. In diesem Fall haben Videokacheln abgerundete Ecken mit einem Radius von fünf Pixeln. Die Kacheln haben einen grünen Rand, der ebenfalls fünf Pixel breit ist. Wenn der Sprecher spricht, ändert das `HighlightColor` Attribut die Rahmenfarbe in Rot.

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

**VideoAttribute**  
*Beschreibung* — Legt die Einstellungen für Videokachelränder und abgerundete Ecken fest  
*Zulässige Werte* — `BorderColor` \$1 `BorderThickness` \$1 `CornerRadius` \$1 `HighlightColor`  
*Erforderlich* — Nein

**VideoAttribute.BorderColor**  
*Beschreibung* — Definiert die Rahmenfarbe für alle Videokacheln  
*Zulässige Werte* — Farbnamen wie Rot, Grün oder Blau  
*Erforderlich* — Nein

**VideoAttribute.BorderThickness**  
*Beschreibung* — Definiert die Randstärke in Pixeln für alle Videokacheln  
*Typ* – Ganzzahl  
*Zulässige Werte* — 1—20  
*Erforderlich* — Nein

**VideoAttribute.CornerRadius**  
*Beschreibung* — Definiert den Eckenradius in Pixeln für alle Videokacheln.   
*Typ* – Ganzzahl  
*Zulässige Werte* — 1—20  
*Erforderlich* — Nein

**VideoAttribute.HighlightColor**  
*Beschreibung* — Definiert eine Rahmenfarbe, die angezeigt wird, wenn ein Moderator oder Redner spricht  
*Zulässige Werte* — Farbnamen wie Rot, Grün oder Blau  
*Erforderlich* — Nein

# Verwenden der Layoutkonfigurationen für das Compositing in Amazon Chime SDK-Meetings
<a name="compositing-layouts"></a>

In den folgenden Themen wird erklärt, wie die verschiedenen Konfigurationslayouts verwendet werden. Die Layouts werden nur wirksam, wenn jemand eine Inhaltsfreigabe startet. Erweitern Sie jeden Abschnitt, um mehr zu erfahren.

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

`ActiveSpeakerOnlyConfiguration`zeigt die Inhaltsfreigabe und das Video des aktiven Sprechers an, was bedeutet, dass die sprechende Person in der kleinen Videokachel erscheint, die den Stream zum Teilen von Inhalten überlagert.

Die folgende Abbildung zeigt die Konfiguration und die verfügbaren Positionen für die Lautsprecherkachel.

![\[Das Bild zeigt eine große Videokachel in der Mitte eines Fensters und eine kleine Kachel in der oberen linken Ecke.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/compositing-active-speaker-4x.png)


Das folgende Beispiel zeigt, wie das `ActiveSpeakerOnly` Layout programmgesteuert implementiert wird. In diesem Fall wird die Moderator-Kachel in der oberen linken Ecke angezeigt.

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

**ActiveSpeakerOnlyConfiguration**  
*Beschreibung* — Die Konfigurationseinstellungen für eine Videokachel `ActiveSpeakerOnly`  
*Typ* — ActiveSpeakerOnlyConfiguration Objekt  
*Erforderlich* — Nein

**ActiveSpeakerOnlyConfiguration.ActiveSpeakerPosition**  
*Beschreibung* — Die Position der Videokachel des aktiven Lautsprechers  
*Typ* – Zeichenfolge  
*Gültige Werte* — `TopLeft` \$1 `TopRight` \$1 `BottomLeft` \$1 `BottomRight`  
*Erforderlich* — Nein  
*Standard* — `TopRight`

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

`PresenterOnlyConfiguration`zeigt die Inhaltsfreigabe und nur das Video des Moderators an, unabhängig davon, wer spricht. Die folgende Abbildung zeigt die Konfiguration.

![\[Bild von vier Bildschirmen. Jeder Bildschirm hat in der Mitte ein Fenster zum Teilen und in jeder Ecke eine Videokachel.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/compositing-presenter-only-4x.png)


Das folgende Beispiel zeigt, wie das Layout programmgesteuert implementiert wird, wobei sich der Moderator oben rechts befindet.

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

**PresenterOnlyConfiguration**  
*Beschreibung* — Die Konfigurationseinstellungen für ein Layout `PresenterOnly`  
*Typ* — `PresenterOnlyConfiguration` Objekt  
*Erforderlich* — Nein

**PresenterOnlyConfiguration.PresenterPosition**  
*Beschreibung* — Die Position der Videokachel des Moderators  
*Typ* – Zeichenfolge  
*Gültige Werte* — `TopLeft` \$1 `TopRight` \$1 `BottomLeft` \$1 `BottomRight`  
*Erforderlich* — Nein  
*Standard* — `TopRight`

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

`HorizontalLayoutConfiguration`zeigt die gemeinsame Nutzung von Inhalten und die Videostreams horizontal an. Sie können die `TilePosition` Einstellung verwenden, um die Kacheln über oder unter dem Content Share-Stream anzuzeigen. Moderatoren werden immer auf der linken Seite angezeigt. Zusätzliche Kacheln werden in der Reihenfolge angezeigt, die von vorgegeben wird. `JoinSequence` 

Die folgende Abbildung zeigt die Kacheln unter dem Content Share-Stream.

![\[Das Bild zeigt eine große Kachel in der Mitte und 4 kleinere Kacheln in einer Linie darunter.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/compositing-horizontal-bottom.png)


Das folgende Beispiel zeigt, wie ein horizontales Layout programmgesteuert implementiert wird. In diesem Fall ordnet das Layout die Kacheln nach `SpeakerSequence` und platziert sie unterhalb der Bildschirmfreigabe. Das Layout erlaubt maximal vier Kacheln und wendet ein Seitenverhältnis von 16:9 an.

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

**HorizontalLayoutConfiguration**  
*Beschreibung* — Die Konfigurationseinstellungen für ein horizontales Layout  
*Typ* — HorizontalLayoutConfiguration Objekt  
*Erforderlich* — Nein

**HorizontalLayoutConfiguration.TilePosition**  
*Beschreibung* — Platziert Kacheln über oder unter einem geteilten Inhalt.  
*Typ* — Zeichenfolge  
*Gültige Werte* — `Bottom` \$1 `Top`  
*Erforderlich* — Nein  
*Standard* — Unten

**HorizontalLayoutConfiguration.TileOrder**  
*Beschreibung* — Sortiert die Kacheln danach, wann Benutzer beitreten oder wann sie sprechen  
*Typ* – Zeichenfolge  
*Gültige Werte* — `JoinSequence` \$1 `SpeakerSequence`  
*Erforderlich* — Nein  
*Standard* — JoinSequence

**HorizontalLayoutConfiguration.TileCount**  
*Beschreibung* — Gibt die Anzahl der Kacheln an, die während einer Bildschirmübertragung sichtbar bleiben  
*Typ* – Ganzzahl  
*Gültige Werte* — 1—10  
*Erforderlich* — Nein  
*Standard* — 4

**HorizontalLayoutConfiguration.TileAspectRatio**  
*Beschreibung* — Legt das Seitenverhältnis der Kacheln fest  
*Typ* – Ganzzahl  
*Gültige Werte* *— *n**/**n**  
*Erforderlich* — Nein  
*Standard* — 16/9, Wert gilt für alle Kacheln

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

`VerticalLayoutConfiguration`zeigt das Teilen von Inhalten und die vier neuesten Videos im Stapel auf der rechten Seite an. Moderatoren werden immer im Vordergrund angezeigt. Andere Teilnehmer erscheinen in der Reihenfolge, die von vorgegeben wird. `TileOrder`

![\[Das Bild zeigt eine große Videokachel in der Mitte eines Fensters und 4 kleinere, gestapelte Kacheln auf der rechten Seite.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/grid-vertical.png)


Das folgende Beispiel zeigt, wie das vertikale Layout programmgesteuert implementiert wird. In diesem Fall ordnet das Layout die Kacheln nach JoinSequence und platziert sie rechts neben der Bildschirmübertragung. Das Layout erlaubt maximal vier Kacheln und wendet ein Seitenverhältnis von 16:9 an.

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

**VerticalLayoutConfiguration**  
*Beschreibung* — Die Konfigurationseinstellungen für ein vertikales Layout  
*Typ* — VerticalLayoutConfiguration Objekt  
*Erforderlich* — Nein

**VerticalLayoutConfiguration.TilePosition**  
*Beschreibung* — Platziert Kacheln rechts oder links neben einem geteilten Inhalt.  
*Typ* – Zeichenfolge  
*Gültige Werte* — `Bottom` \$1 `Top`  
*Erforderlich* — Nein  
*Standard* — Unten

**VerticalLayoutConfiguration.TileOrder**  
*Beschreibung* — Sortiert die Kacheln danach, wann Benutzer beitreten oder wann sie sprechen  
*Typ* – Zeichenfolge  
*Gültige Werte* — `JoinSequence` \$1 `SpeakerSequence`  
*Erforderlich* — Nein  
*Standard* — JoinSequence

**VerticalLayoutConfiguration.TileCount**  
*Beschreibung* — Gibt die Anzahl der Kacheln an  
*Typ* – Ganzzahl  
*Gültige Werte* — 1—10  
*Erforderlich* — Nein  
*Standard* — 4

**VerticalLayoutConfiguration.TileAspectRatio**  
*Beschreibung* — Legt das Seitenverhältnis der Kacheln fest  
*Typ* – Ganzzahl  
*Gültige Werte* *— *n**/**n**  
*Erforderlich* — Nein  
*Standard* — 9/16, Wert gilt für alle Kacheln

# Eine serviceverknüpfte Rolle für Amazon Chime SDK-Medien-Pipelines erstellen
<a name="create-pipeline-role"></a>

In den folgenden Abschnitten wird erklärt, wie Sie eine servicebezogene Rolle erstellen, die Medien-Pipelines Zugriff auf Ihre Amazon Chime SDK-Meetings gewährt.

**Topics**
+ [Rollenberechtigungen einrichten](#pipeline-role-permissions)
+ [Erstellen der serviceverknüpfte -Rolle](#create-sl-role)
+ [Bearbeiten der serviceverknüpften Rolle](#edit-pipeline-role)
+ [Löschen der serviceverknüpften -Rolle](#delete-pipeline-role)
+ [Regionen, die serviceverknüpfte Rollen unterstützen](#role-supported-regions)

## Rollenberechtigungen einrichten
<a name="pipeline-role-permissions"></a>

*Medien-Pipelines verwenden eine dienstverknüpfte Rolle namens AWSService RoleForAmazonChime SDKMedia Pipelines.* Diese Rolle ermöglicht es den Capture-Pipelines, auf Amazon Chime SDK-Meetings zuzugreifen und in Ihrem Namen Metriken CloudWatch auf Amazon zu veröffentlichen. Die Rolle vertraut dem Service. `mediapipelines.chime.amazonaws.com`

Die Rollenberechtigungsrichtlinie ermöglicht es dem Amazon Chime SDK, die folgenden Aktionen für alle AWS Ressourcen durchzuführen:
+ Aktion: `cloudwatch:PutMetricData` für `all AWS resources`
+ Aktion: `chime:CreateAttendee` für `all AWS resources`
+ Aktion: `chime:DeleteAttendee` für `all AWS resources`
+ Aktion: `chime:GetMeeting` für `all AWS resources`
+ Aktion: `kinesisvideo:CreateStream` für `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Aktion: `kinesisvideo:PutMedia` für `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Aktion: `kinesisvideo:UpdateDataRetention` für `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Aktion: `kinesisvideo:DescribeStream` für `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Aktion: `kinesisvideo:GetDataEndpoint` für `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Aktion: `kinesisvideo:ListStreams` für `arn:aws:kinesisvideo:*:111122223333:stream/*`

Sie müssen Berechtigungen konfigurieren, damit eine IAM-Entität (z. B. Benutzer, Gruppe oder Rolle) eine serviceverknüpfte Rolle erstellen, bearbeiten oder löschen kann. Weitere Informationen zu Berechtigungen finden Sie unter Berechtigungen für [mit dem Service verknüpfte Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) im *IAM-Benutzerhandbuch*. 

## Erstellen der serviceverknüpfte -Rolle
<a name="create-sl-role"></a>

Sie verwenden die IAM-Konsole, um eine serviceverknüpfte Rolle für die Verwendung mit Amazon Chime SDK-Medien-Pipelines zu erstellen. Sie benötigen IAM-Administratorrechte, um diese Schritte ausführen zu können. Wenn Sie dies nicht tun, wenden Sie sich an einen Systemadministrator.

**So erstellen Sie die Rolle**

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie dann die IAM-Konsole unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam).

1. Klicken Sie im Navigationsbereich der IAM-Konsole auf **Rollen**, und wählen Sie dann **Rolle erstellen**.

1. Wählen Sie den Rollentyp **AWS-Service** und anschließend **Chime SDK Media Pipelines** aus.

   Die IAM-Richtlinie wird angezeigt.

1. Aktivieren Sie das Kontrollkästchen neben der Richtlinie und wählen Sie dann **Weiter: Tags** aus.

1. Wählen Sie **Weiter: Prüfen** aus.

1. Bearbeiten Sie die Beschreibung nach Bedarf und wählen Sie dann **Rolle erstellen** aus.

Sie können auch die AWS CLI oder die AWS API verwenden, um eine serviceverknüpfte Rolle mit dem Namen *mediapipelines.chime.amazonaws.com* zu erstellen. Führen Sie in der AWS CLI diesen Befehl aus:

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

Weitere Informationen zum Erstellen der Rolle finden Sie unter [Creating a Service Linked Role](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) im *IAM-Benutzerhandbuch*. Wenn Sie diese Rolle löschen, können Sie sie mit demselben Verfahren erneut erstellen.

## Bearbeiten der serviceverknüpften Rolle
<a name="edit-pipeline-role"></a>

Sie können die mit dem Dienst verknüpfte *AWSServiceRoleForAmazonChimeSDKMediaPipeline-Rolle* nicht bearbeiten. Nachdem Sie die Rolle erstellt haben, können Sie ihren Namen nicht mehr ändern, da andere Entitäten möglicherweise auf die Rolle verweisen. Sie können jedoch IAM verwenden, um die Beschreibung der Rolle zu bearbeiten. Weitere Informationen finden Sie unter [Bearbeiten einer serviceverknüpften Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) im *IAM-Benutzerhandbuch*.

## Löschen der serviceverknüpften -Rolle
<a name="delete-pipeline-role"></a>

Wenn Sie keine serviceverknüpfte Rolle benötigen, empfehlen wir, sie zu löschen. Dazu löschen Sie zunächst die Medien-Pipelines, die die Rolle verwenden. Sie können die AWS CLI oder die [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 verwenden, um die Pipelines zu löschen. 

**Verwenden der CLI zum Löschen von Pipelines**  
Verwenden Sie diesen Befehl in der AWS CLI, um Medien-Pipelines in Ihrem Konto zu löschen.

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

**Verwenden einer API zum Löschen von Pipelines**  
Verwenden Sie die [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, um Medien-Pipelines in Ihrem Konto zu löschen.

**Die Rolle wird gelöscht**  
Nachdem Sie die Pipelines gelöscht haben, können Sie die IAM-Konsole, die AWS CLI oder die AWS API verwenden, um die Rolle zu löschen. Weitere Informationen zum Löschen von Rollen finden Sie unter [Löschen einer serviceverknüpften Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) im *IAM-Benutzerhandbuch*.

## Regionen, die serviceverknüpfte Rollen unterstützen
<a name="role-supported-regions"></a>

Das Amazon Chime SDK unterstützt die Verwendung von serviceverknüpften Rollen in allen AWS Regionen, in denen der Service verfügbar ist. Weitere Informationen finden Sie unter [Amazon Chime SDK-Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) in der. *Allgemeine Amazon Web Services-Referenz*

# Medien-Pipeline-Ereignisse des Amazon Chime SDK verwenden
<a name="media-pipe-events"></a>

Jede Art von Medienpipeline sendet Lebenszyklusereignisse, die Sie verwenden können, um Benachrichtigungen auszulösen und nachgelagerte Workflows zu initiieren. Einige Beispiele für die Verwendung von Medien-Pipeline-Ereignissen sind:
+ Verarbeitung aufgenommener Medien nach Abschluss einer Medienpipeline.
+ Benachrichtigung der Besprechungsteilnehmer, wenn eine Medienpipeline vorübergehend ausfällt.
+ Beenden einer Besprechung, wenn eine Medienpipeline dauerhaft ausfällt.

Sie können Ereignisse an Amazon EventBridge, Amazon Simple Notification Service (SNS) und Amazon Simple Queue Service (SQS) senden. Weitere Informationen finden Sie unter [Events from AWS services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) im * EventBridge Amazon-Benutzerhandbuch*.

## Amazon Chime SDK-Medienpipeline erstellt
<a name="media-pipeline-create"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Medienpipeline erstellt wird.

**Beispiel: Ereignisdaten**  
 Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

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

## Die Amazon Chime SDK-Medienpipeline wurde gelöscht
<a name="media-pipeline-delete"></a>

Das Amazon Chime SDK sendet dieses Ereignis, nachdem die Medienpipeline erfolgreich beendet wurde. 

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

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

## Die Amazon Chime SDK-Medienpipeline hat einen vorübergehenden Fehler
<a name="pipeline-temp-failure"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Medienpipeline vorübergehend ausfällt.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

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

## Medienpipeline für das Amazon Chime SDK ist in Bearbeitung
<a name="pipeline-in-progress"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Medienpipeline mit der Erfassung von Artefakten beginnt.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

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

## Dauerhafter Ausfall der Amazon Chime SDK-Medienpipeline
<a name="pipeline-perm-failure"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn eine Medienpipeline dauerhaft ausfällt.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

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

# Amazon S3 S3-Bucket-Berechtigungen für Amazon Chime SDK-Medien-Pipelines einrichten
<a name="s3-permissions"></a>

Wenn Sie noch keinen Amazon S3 S3-Bucket erstellt haben, stellen Sie sicher, dass Sie Ihren Bucket in dem Konto und der Region erstellen, in der Sie Meetings veranstalten. Stellen Sie außerdem sicher, dass Sie dem Service angemessene Berechtigungen gewähren. Weitere Informationen zum Erstellen eines Amazon S3 S3-Buckets finden Sie unter[Erstellen eines Amazon S3 S3-Buckets für Amazon Chime SDK-Medienerfassungspipelines](create-s3-bucket.md).

# Medien-Pipeline-Ereignisse des Amazon Chime SDK senden an CloudTrail
<a name="pipeline-cloudtrail"></a>

AWS wird CloudTrail für Sie aktiviert, wenn Sie Ihr AWS Konto erstellen. Wenn ein Benutzer eine unterstützte API im Media Pipeline SDK aufruft, CloudTrail protokolliert es diese Aktivität für diese API zusammen mit anderen AWS Ereignissen im **Ereignisverlauf**. Sie können die Media Pipeline-Ereignisse in Ihrem AWS-Konto anzeigen, suchen und herunterladen. Weitere Informationen finden Sie im *CloudTrail Benutzerhandbuch* unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).

Für eine fortlaufende Aufzeichnung von Medien-Pipeline-Ereignissen können Sie einen *Trail* erstellen. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an Ihren Amazon S3 S3-Bucket. Das folgende Beispiel zeigt einen Medien-Pipeline-Trail. Zu den Daten gehören der Benutzer, der die API aufgerufen hat, die IAM-Rolle, mit der die API aufgerufen wurde, und Zeitstempel. Weitere Informationen zur Verwendung CloudTrail finden Sie unter [Protokollierung und Überwachung](https://docs.aws.amazon.com/chime-sdk/latest/ag/monitoring-overview.html) im *Amazon Chime SDK-Administratorhandbuch*.

```
{
   "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"
       }
    },  
  ]
}
```

# Bewährte Methoden zum Stoppen von Amazon Chime SDK-Medien-Pipelines
<a name="stop-pipe-best-practices"></a>

Rufen Sie als bewährte Methode zum Stoppen von Medien-Pipelines die API auf [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). Mit der API können Sie Medienerfassungs- und Media Live Connector-Pipelines löschen. Sie können die [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 auch aufrufen, um Medienerfassungspipelines zu löschen. Alle Medienleitungen werden beendet, wenn das Meeting endet.

# Live-Transkription mit Amazon Chime SDK verwenden
<a name="meeting-transcription"></a>

Sie verwenden die Live-Transkription des Amazon Chime SDK, um Live-Transkripte Ihrer Besprechungen mit Benutzerattributionen zu erstellen. Die Live-Transkription von Amazon Chime SDK ist in die Dienste Amazon Transcribe und Amazon Transcribe Medical integriert, um während der Bearbeitung Transkripte von Amazon Chime SDK-Besprechungen zu generieren.

Die Live-Transkription des Amazon Chime SDK verarbeitet das Audio jedes Benutzers separat, um die Genauigkeit in Szenarien mit mehreren Lautsprechern zu verbessern. Das Amazon Chime SDK verwendet seinen aktiven Talker-Algorithmus, um die beiden aktivsten Sprecher auszuwählen, und sendet dann deren Audio in separaten Kanälen über einen einzigen Stream an Amazon Transcribe. Besprechungsteilnehmer erhalten vom Benutzer zugeordnete Transkriptionen über Amazon Chime SDK-Datennachrichten. Sie können Transkriptionen auf vielfältige Weise verwenden, z. B. um Untertitel anzuzeigen, Besprechungsprotokolle zu erstellen oder die Transkriptionen für die Inhaltsanalyse zu verwenden.

Bei der Live-Transkription wird für die Dauer der Meeting-Transkription ein Stream zu Amazon Transcribe verwendet. Es fallen die Standardkosten von Amazon Transcribe und Amazon Transcribe Medical an. Weitere Informationen finden Sie unter [Amazon Transcribe Pricing](https://aws.amazon.com/transcribe/pricing/). Bei Fragen zur Nutzung oder Abrechnung wenden Sie sich an Ihren AWS Kundenbetreuer.

**Wichtig**  
[Standardmäßig kann Amazon Transcribe vom Service verarbeitete Audioinhalte verwenden und speichern, um AWS KI/ML-Dienste zu entwickeln und zu verbessern, wie in Abschnitt 50 der Servicebedingungen näher beschrieben.AWS](https://aws.amazon.com/service-terms/) Die Nutzung von Amazon Transcribe kann bundesstaatlichen und staatlichen Gesetzen oder Vorschriften in Bezug auf die Aufzeichnung oder das Abfangen von elektronischer Kommunikation unterliegen. Es liegt in Ihrer Verantwortung und Ihren Endnutzern, alle geltenden Gesetze in Bezug auf die Aufzeichnung einzuhalten, einschließlich der ordnungsgemäßen Benachrichtigung aller Teilnehmer einer aufgezeichneten Sitzung oder Kommunikation darüber, dass die Sitzung oder Kommunikation aufgezeichnet wird, und alle erforderlichen Einwilligungen einzuholen. Sie können die AWS Verwendung von Audioinhalten zur Entwicklung und Verbesserung von AWS KI/ML-Diensten deaktivieren, indem Sie mithilfe AWS von Organizations eine Opt-Out-Richtlinie für KI-Dienste konfigurieren.

**Topics**
+ [Systemarchitektur](#sys-architecture)
+ [Abrechnung und Nutzung](#billing-and-usage)
+ [Konfiguration Ihres Kontos für Amazon Chime SDK Live-Transkription](configure-transcribe.md)
+ [Auswahl der Live-Transkriptionsoptionen für das Amazon Chime SDK](transcription-options.md)
+ [Live-Transkription des Amazon Chime SDK starten und beenden](initiate-transcription.md)
+ [Live-Transkriptionsparameter des Amazon Chime SDK](#transcription-parameters)
+ [Grundlegendes zu Live-Transkriptionsereignissen im Amazon Chime SDK](transcription-events.md)
+ [Live-Transkriptionsnachrichten des Amazon Chime SDK verstehen](process-msgs.md)
+ [Verarbeitung eines empfangenen Amazon Chime SDK-Live-Transkriptereignisses](delivery-examples.md)
+ [Analysieren von Amazon Chime SDK-Transkripten](parse-transcripts.md)

## Systemarchitektur
<a name="sys-architecture"></a>

Das Amazon Chime SDK erstellt über eine serviceseitige Integration mit Ihrem Amazon Transcribe- oder Amazon Transcribe Medical-Konto Besprechungstranskriptionen in Echtzeit, ohne dass Audio das AWS Netzwerk verlässt. Um die Genauigkeit zu erhöhen, werden die Audiodaten der Benutzer separat verarbeitet und dann in das Meeting gemischt. Das Amazon Chime SDK verwendet seinen aktiven Talker-Algorithmus, um die beiden aktivsten Sprecher auszuwählen, und sendet dann deren Audio in separaten Kanälen über einen einzigen Stream an Amazon Transcribe oder Amazon Transcribe Medical. Um die Latenz zu reduzieren, werden vom Benutzer zugeordnete Transkriptionen über Datennachrichten direkt an jeden Besprechungsteilnehmer gesendet. Wenn Sie eine Medienpipeline zur Audioaufnahme von Besprechungen verwenden, werden auch die Transkriptionsinformationen der Besprechung erfasst.

![\[Ein Diagramm, das den Datenfluss bei der Besprechungstranskription zeigt.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/transcription-architecture.png)


## Abrechnung und Nutzung
<a name="billing-and-usage"></a>

Bei der Live-Transkription wird für die Dauer der Meeting-Transkription ein Stream zu Amazon Transcribe oder Amazon Transcribe Medical verwendet. Es fallen die Standardkosten von Amazon Transcribe und Amazon Transcribe Medical an. Weitere Informationen finden Sie unter [Amazon Transcribe Pricing.](https://aws.amazon.com/transcribe/pricing/) Bei Fragen zur Nutzung oder Abrechnung wenden Sie sich an Ihren AWS Kundenbetreuer.

# Konfiguration Ihres Kontos für Amazon Chime SDK Live-Transkription
<a name="configure-transcribe"></a>

Bevor Sie die Live-Transkription mit Amazon Chime SDK verwenden können, müssen Sie Amazon Chime SDK die Erlaubnis erteilen, Amazon Transcribe und Amazon Transcribe Medical in Ihrem Konto anzurufen. AWS Dazu fügen Sie Ihrem Konto die Rolle Chime Transcription hinzu, die mit dem Service verknüpft ist. Informationen zur Erstellung der serviceverknüpften Rolle für die Live-Transkription finden Sie unter [Rollen mit Live-Transkription verwenden](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-transcription.html) im *Amazon Chime* SDK-Administrationshandbuch. *Weitere Informationen zu serviceverknüpften IAM-Rollen finden Sie unter [Service Linked Roles im IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html).*

# Auswahl der Live-Transkriptionsoptionen für das Amazon Chime SDK
<a name="transcription-options"></a>

Wenn Sie die Live-Transkription des Amazon Chime SDK verwenden, verwenden Sie Amazon Transcribe oder [https://aws.amazon.com/transcribe/](https://aws.amazon.com/transcribe/) Medical in Ihrem Konto. AWS [Sie haben Zugriff auf alle [von Amazon Transcribe unterstützten Streaming-Sprachen](https://docs.aws.amazon.com/transcribe/latest/dg/what-is-transcribe.html) sowie auf Funktionen wie [benutzerdefinierte Vokabulare](https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary.html) und Vokabelfilter.](https://docs.aws.amazon.com/transcribe/latest/dg/filter-unwanted-words.html) Wenn Sie Amazon Transcribe Medical verwenden, können Sie ein medizinisches Fachgebiet und einen Konversationstyp auswählen und optional ein beliebiges benutzerdefiniertes Vokabular angeben. Es fallen die Standardkosten von Amazon Transcribe und Amazon Transcribe Medical an.

Der Prozess der Auswahl der Transkriptionsoptionen folgt diesen Schritten. 

## Schritt 1: Auswahl eines Transkriptionsdienstes
<a name="choose-service"></a>

Sie müssen entscheiden, welchen Transkriptionsdienst Sie verwenden möchten, [Amazon Transcribe oder [Amazon](https://aws.amazon.com/transcribe/medical/) Transcribe](https://aws.amazon.com/transcribe/) Medical. 

Wenn Ihr Anwendungsfall medizinische Sprach-zu-Text-Funktionen erfordert, möchten Sie wahrscheinlich Amazon Transcribe Medical verwenden. Für alle anderen Anwendungsfälle möchten Sie wahrscheinlich Amazon Transcribe verwenden.

Sie geben an, welcher Transkriptionsdienst verwendet werden soll, wenn Sie die API aufrufen: `StartMeetingTranscription`
+ Um Amazon Transcribe zu verwenden, geben Sie ein mit `TranscriptionConfiguration` an. `EngineTranscribeSettings` 
+ Um Amazon Transcribe Medical zu verwenden, geben Sie ein mit `TranscriptionConfiguration` an. `EngineTranscribeMedicalSettings`

## Schritt 2: Auswahl einer Transkriptionsregion
<a name="choose-region"></a>

Sie müssen eine AWS Region für den Transkriptionsdienst auswählen. [Informationen zu den verfügbaren AWS Regionen für Amazon Transcribe und Amazon Transcribe Medical finden Sie in der AWS Tabelle Regional Services.](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)

 Im Allgemeinen bietet die niedrigste Latenz zwischen der Medienregion und der Transkriptionsregion eines Meetings die beste Benutzererfahrung. Verwenden Sie für die niedrigste Latenz, wann immer möglich dieselbe Region für Medien und Transkription. Möglicherweise müssen Sie bei der Auswahl einer Region jedoch andere Faktoren berücksichtigen, z. B. gesetzliche Anforderungen oder die Regionen, in denen Sie Amazon Transcribe oder Amazon Transcribe Medical konfiguriert haben.

Die Funktionen von Amazon Transcribe und Amazon Transcribe Medical, wie z. B. benutzerdefinierte Vokabulare oder Vokabelfilter, sind regionsspezifisch. Wenn Sie eine dieser Funktionen konfigurieren, sollten Sie dies in allen AWS Regionen, in denen Sie die Live-Transkription verwenden möchten, identisch tun. Alternativ können Sie dieselbe Amazon Transcribe Transcribe-Region für alle Besprechungen verwenden.

Sie können die Region angeben, die der Transkriptionsservice verwendet. Sie tun dies, indem Sie den Namen der Region zum `Region` Feld der Einstellungen der Transkriptions-Engine hinzufügen, wenn Sie die `StartMeetingTranscription` API aufrufen. Wenn Sie keine Region angeben, versucht das Amazon Chime SDK, den Transkriptionsservice in der Medienregion des Meetings zu verwenden. Damit das Amazon Chime SDK die Region für den Transkriptionsservice für Sie auswählt, geben Sie diese `auto` in das `Region` Feld ein. Wenn Sie das tun, wählt Amazon Chime den Transkriptionsservice Region basierend auf der Medienregion des Meetings aus, wie in den folgenden Tabellen beschrieben. Weitere Informationen zur `StartMeetingTranscription` API finden Sie [Live-Transkription des Amazon Chime SDK starten und beenden](initiate-transcription.md) in diesem Handbuch.

**Anmerkung**  
Die vom Amazon Chime SDK ausgewählte Transkriptionsregion kann sich ändern AWS, da Amazon Chime SDK, Amazon Transcribe und Amazon Transcribe Medical mehr Regionen verfügbar machen.

**Automatische Regionsauswahl für Amazon Transcribe**  



|  Amazon Chime SDK Medienregion  |  Regionscode  |  Transkriptionsregion  | 
| --- | --- | --- | 
|  USA Ost (Ohio)  |  us-east-2  | us-east-2  | 
|  USA Ost (Nord-Virginia)  |  us-east-1  | us-east-1  | 
|  USA West (Nordkalifornien)  |  us-west-1  | us-west-2 | 
|  USA West (Oregon)  |  us-west-2  | us-west-2  | 
|  **Afrika (Kapstadt) \$1**  |  af-south-1  | eu-west-2  | 
|  Asien-Pazifik (Mumbai)  |  ap-south-1  | eu-west-2 | 
|  Asien-Pazifik (Seoul)  |  ap-northeast-2  | ap-northeast-2 | 
|  Asien-Pazifik (Singapur)  |  ap-southeast-1  | ap-northeast-1 | 
|  Asien-Pazifik (Sydney)  |  ap-southeast-2  | ap-southeast-2 | 
|  Asien-Pazifik (Tokio)  |  ap-northeast-1  | ap-northeast-1 | 
|  Kanada (Zentral)  |  ca-central-1  | ca-central-1 | 
|  Europa (Frankfurt)   |  eu-central-1  | eu-central-1  | 
|  Europa (Irland)  |  eu-west-1  | eu-west-1 | 
|  Europa (London)  |  eu-west-2  | eu-west-2  | 
|  Europa (Mailand) **\$1**  |  eu-south-1  | eu-central-1  | 
|  Europa (Paris)  |  eu-west-3  | eu-central-1  | 
|  Europa (Stockholm)  |  eu-north-1  | eu-central-1 | 
|  Südamerika (São Paulo)  |  sa-east-1  | sa-east-1 | 
|  GovCloud (US-Ost)  |  us-gov-east-1  |  us-gov-west-1  | 
|  GovCloud (US-West)  |  us-gov-west-1  |  us-gov-west-1  | 

**Automatische Regionsauswahl für Amazon Transcribe Medical**  



|  Amazon Chime SDK Medienregion  |  Regionscode  |  Transkriptionsregion  | 
| --- | --- | --- | 
|  USA Ost (Ohio)  |  us-east-2  | us-east-2 | 
|  USA Ost (Nord-Virginia)  |  us-east-1  | us-east-1 | 
|  USA West (Nordkalifornien)  |  us-west-1  | us-west-2 | 
|  USA West (Oregon)  |  us-west-2  | us-west-2 | 
|  **Afrika (Kapstadt) \$1**  |  af-south-1  |  eu-west-1  | 
|  Asien-Pazifik (Mumbai)  |  ap-south-1  | eu-west-1  | 
|  Asien-Pazifik (Seoul)  |  ap-northeast-2  | us-west-2 | 
|  Asien-Pazifik (Singapur)  |  ap-southeast-1  | ap-southeast-2 | 
|  Asien-Pazifik (Sydney)  |  ap-southeast-2  | ap-southeast-2 | 
|  Asien-Pazifik (Tokio)  |  ap-northeast-1  | us-west-2 | 
|  Kanada (Zentral)  |  ca-central-1  | ca-central-1 | 
|  Europa (Frankfurt)   |  eu-central-1  | eu-west-1 | 
|  Europa (Irland)  |  eu-west-1  | eu-west-1 | 
|  Europa (London)  |  eu-west-2  | us-east-1 | 
|  Europa (Mailand) **\$1**  |  eu-south-1  | eu-west-1 | 
|  Europa (Paris)  |  eu-west-3  | eu-west-1 | 
|  Europa (Stockholm)  |  eu-north-1  | eu-west-1 | 
|  Südamerika (São Paulo)  |  sa-east-1  | us-east-1 | 

**Anmerkung**  
Um die Live-Transkription in Regionen zu verwenden, die mit einem Sternchen (**\$1**) gekennzeichnet sind, müssen Sie zuerst die Region in Ihrem AWS Konto aktivieren. Weitere Informationen finden Sie unter [Aktivieren einer Region in der](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html). Allgemeine AWS-Referenz

Weitere Informationen zu den Regionen und Endpunkten der einzelnen Dienste finden Sie unter:
+ [Amazon Chime SDK Medienregionen](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html)
+ [Amazon Transcribe Transcribe-Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region)
+ [Endpunkte und Kontingente von Amazon Transcribe Medical](https://docs.aws.amazon.com/general/latest/gr/transcribe-medical.html)

## Schritt 3: Überprüfen Sie die Servicekontingente
<a name="transcribe-quotas"></a>

Für jedes Amazon Chime SDK-Meeting mit Live-Transkription ist genau ein HTTP/2-Stream zu Amazon Transcribe oder Amazon Transcribe Medical erforderlich. Für beide Dienste gelten regionale Servicekontingente für die Anzahl gleichzeitiger HTTP/2-Streams und für Start-Stream-Transaktionen pro Sekunde. Weitere Informationen zu den Kontingenten finden Sie unter [Richtlinien und Kontingente](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html) im *Amazon Transcribe Developer Guide*. Informationen zu Kontingenterhöhungen finden Sie unter Service Quotas in der AWS Konsole.

# Live-Transkription des Amazon Chime SDK starten und beenden
<a name="initiate-transcription"></a>

Sie verwenden die Amazon Chime [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html)SDK-API, um die Meeting-Transkription zu initiieren, indem Sie a `TranscriptionConfiguration` auf das Meeting anwenden. Der Amazon Chime SDK-Controller leitet die Konfiguration asynchron an das Meeting weiter. Der Erfolg oder Misserfolg der Initiierung der Besprechungstranskription wird durch eine Nachricht über Amazon Simple Notification Service (Amazon SNS) und Amazon signalisiert. EventBridge

**Die Transkription wird gestartet**  
Dieses Beispiel zeigt, wie Sie die Live-Transkription mit Amazon Transcribe starten.

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

Dieses Beispiel zeigt, wie Sie die Live-Transkription mit Amazon Transcribe Medical starten.

```
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`— Startet die Transkription für das Meeting.  
`meetingId`— Die von der [CreateMeetingAPI](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax) zurückgegebene ID des Meetings.  
`TranscriptionConfiguration`— Kapselt die Parameter für die Live-Transkription. Sie müssen genau eine Konfiguration angeben, oder. `EngineTranscribeSettings` `EngineTranscribeMedicalSettings`

`EngineTranscribeSettings`— Spezifiziert die Verwendung von Amazon Transcribe und leitet dessen Einstellungen an weiter. [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` – Erforderlich.  
`VocabularyFilterMethod` – Optional.  
`VocabularyFilterName` – Optional.  
`VocabularyName` – Optional.  
`Region` – Optional.  
`EnablePartialResultsStabilization` – Optional.  
`PartialResultsStability` – Optional.  
` ContentIdentificationType` – Optional.  
`ContentRedactionType` – Optional.  
`PiiEntityTypes ` – Optional.  
`LanguageModelName` – Optional.

`EngineTranscribeMedicalSettings`— Spezifiziert die Verwendung von Amazon Transcribe Medical und leitet dessen Einstellungen an weiter. [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` – Erforderlich.  
`Speciality` – Erforderlich.  
`Type` – Erforderlich.  
`VocabularyName` – Optional.  
`Region` – Optional.  
` ContentIdentificationType` – Optional.

**Antworten**  
Amazon Transcribe und Amazon Transcribe Medical nehmen die folgenden Antworten entgegen:
+ `OK`(200) mit leerem Text, wenn Sie das erfolgreich auf das `TranscriptionConfiguration` Meeting anwenden.

**Fehlermeldungen**  
Amazon Transcribe und Amazon Transcribe Medical zeigen die folgenden Fehlermeldungen an:
+ **BadRequestException (400):** Die Eingabeparameter entsprechen nicht den Einschränkungen des Dienstes.
+ **ForbiddenException (403): Dem** Client ist es dauerhaft untersagt, die Anfrage zu stellen.
+ **NotFoundException (404):** Das `meetingId` existiert nicht.
+ **ResourceLimitExceededException (400):** Die Anfrage überschreitet das Ressourcenlimit. Beispielsweise ist bei zu vielen Besprechungen die Live-Transkription aktiviert.
+ **ServiceFailureException (500):** Beim Dienst ist ein unerwarteter Fehler aufgetreten.
+ **ServiceUnavailableException (503):** Der Dienst ist derzeit nicht verfügbar.
+ **ThrottledClientException (429):** Der Client hat sein Limit für die Anforderungsrate überschritten.
+ **UnauthorizedClientException (401):** Der Client ist derzeit nicht berechtigt, die Anfrage zu stellen.

Wenn Sie `StartMeetingTranscription` ein zweites Mal anrufen, `TranscriptionConfiguration` wird der für das Meeting verwendete Wert aktualisiert.

**Die Transkription wird beendet**  
Sie verwenden die [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, um die Transkription `TranscriptionConfiguration` für ein bestimmtes Meeting zu entfernen `meetingID` und zu beenden. Wenn Sie ein Meeting beenden, wird die Transkription automatisch beendet.

Dieses Beispiel zeigt die Anforderungssyntax, die aufgerufen wird`StopMeetingTranscription`.

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

**Antworten**  
Amazon Transcribe und Amazon Transcribe Medical nehmen die folgenden Antworten entgegen:
+ `OK`(200) mit leerem Text, wenn Sie den erfolgreich aus dem `TranscriptionConfiguration` Meeting entfernen.

**Fehlermeldungen**  
Amazon Transcribe und Amazon Transcribe Medical zeigen die folgenden Fehlermeldungen an:
+ **BadRequestException (400):** Die Eingabeparameter entsprechen nicht den Einschränkungen des Dienstes.
+ **ForbiddenException (403): Dem** Client ist es dauerhaft untersagt, die Anfrage zu stellen.
+ **NotFoundException (404):** Das `meetingId` existiert nicht.
+ **ServiceFailureException (500):** Der Dienst ist auf einen unerwarteten Fehler gestoßen.
+ **ServiceUnavailableException (503):** Der Dienst ist derzeit nicht verfügbar.
+ **ThrottledClientException (429):** Der Client hat sein Limit für die Anforderungsrate überschritten.
+ **UnauthorizedClientException (401):** Der Client ist derzeit nicht berechtigt, die Anfrage zu stellen.

## Live-Transkriptionsparameter des Amazon Chime SDK
<a name="transcription-parameters"></a>

Amazon Transcribe und Amazon Transcribe Medical APIs bieten beim Initiieren der Streaming-Transkription eine Reihe von Parametern, z. B. und. [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html) Sie können diese Parameter in der `StartMeetingTranscription` API verwenden, es sei denn, das Amazon Chime SDK legt den Wert des Parameters fest. Beispielsweise sind die `MediaSampleRateHertz` Parameter `MediaEncoding` und nicht verfügbar, da das Amazon Chime SDK sie automatisch festlegt.

Amazon Transcribe und Amazon Transcribe Medical validieren die Parameter, sodass Sie neue Parameterwerte verwenden können, sobald sie verfügbar sind. Wenn Amazon Transcribe Medical beispielsweise die Unterstützung für eine neue Sprache einführt, müssen Sie nur den neuen Sprachwert im `LanguageCode` Parameter angeben. 

# Grundlegendes zu Live-Transkriptionsereignissen im Amazon Chime SDK
<a name="transcription-events"></a>

Das Amazon Chime SDK sendet Ereignisse im Transkriptionslebenszyklus, mit denen Sie Benachrichtigungen auslösen und nachgelagerte Workflows einleiten können. Einige Beispiele für die Verwendung von Transkriptionsereignissen sind:
+ Messung der Akzeptanz von Live-Transkription in Amazon Chime SDK-Besprechungen
+ Sprachpräferenzen verfolgen

Sie können Ereignisse an Amazon EventBridge, Amazon Simple Notification Service und Amazon Simple Queue Service senden. Weitere Informationen finden Sie unter [Events from AWS services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) im * EventBridge Amazon-Benutzerhandbuch*.

## Die Transkription der Amazon Chime SDK-Besprechung wurde gestartet
<a name="transcript-start"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Meeting-Transkription gestartet oder aktualisiert [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_TranscriptionConfiguration.html)wird. 

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

## Die Transkription der Amazon Chime SDK-Besprechung wurde gestoppt
<a name="transcript-stop"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Meeting-Transkription gestoppt wird.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

## Die Transkription der Amazon Chime SDK-Besprechung wurde unterbrochen
<a name="transcript-interrupted"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Meeting-Transkription unterbrochen wird.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

## Die Transkription der Amazon Chime SDK-Besprechung wurde wieder aufgenommen
<a name="transcript-resumed"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Besprechungstranskription nach einer Unterbrechung wieder aufgenommen wird.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

## Die Transkription der Amazon Chime SDK-Besprechung ist fehlgeschlagen
<a name="transcript-failed"></a>

Das Amazon Chime SDK sendet dieses Ereignis, wenn die Meeting-Transkription nicht gestartet oder nach einer Unterbrechung nicht fortgesetzt werden konnte.

**Beispiel: Ereignisdaten**  
Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
    "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)": "{...}"
    }
}
```

# Live-Transkriptionsnachrichten des Amazon Chime SDK verstehen
<a name="process-msgs"></a>

Der Amazon Chime SDK-Service gibt Transkriptionsinformationen an die Teilnehmer weiter, indem er `TranscriptEvent` Objekte in Datennachrichten sendet. A `TranscriptEvent` liefert ein `Transcript` oder ein. `TranscriptionStatus` 

A `Transcript` beinhaltet Ergebnisse mit Zeitstempel, vom Benutzer zugewiesenen Wörtern und Satzzeichen. Ein Ergebnis kann „teilweise“ sein. In diesem Fall aktualisiert das System es in der Regel zu einem späteren Zeitpunkt. `TranscriptEvent` Auf diese Weise können Sie Transkriptionen schnell einsehen und bei Bedarf später Inline-Aktualisierungen vornehmen.

A `TranscriptStatus` kann eines der `TranscriptionStatusType` Ereignisse auslösen, die im Beispiel im nächsten Abschnitt aufgeführt sind.

Neuere Versionen von Amazon Chime SDKs enthalten zusätzliche Datentypen und Hilfsfunktionen für die allgemeine Verarbeitung a. `TranscriptEvent`

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

Dieses Beispiel zeigt ein typisches Transkriptionsereignis.

```
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;
}
```

## Richtlinien für Daten
<a name="data-guidelines"></a>

Behalten Sie diese Richtlinien stets im Hinterkopf.

1. `transcription.results`kann mehr als ein Ergebnis haben.

1. Wenn`transcription.results[i].isPartial = true`, dann gibt es möglicherweise ein Update für das gesamte Ergebnis. Das Update ist wahrscheinlich, aber nicht garantiert. Das Update hat dasselbe`transcript.result[i].resultId`. Wenn Sie Transkriptionen mit geringer Zuverlässigkeit vermeiden möchten, können Sie Teilergebnisse komplett überspringen. Wenn Sie Ergebnisse mit niedriger Latenz wünschen, können Sie Teilergebnisse anzeigen und sie dann vollständig überschreiben, wenn das Update eintrifft.

1. `transcription.results[i].alternatives`enthält immer mindestens einen Eintrag. Wenn es mehr als einen Eintrag enthält, steht der vertrauenswürdigste Eintrag an erster Stelle in der Liste. In den meisten Fällen können Sie den ersten Eintrag übernehmen `transcription.results[i].alternatives` und die anderen ignorieren.

1. `transcription.results[i].alternatives[j].items`enthält einen Eintrag für jedes Wort oder Satzzeichen.

1. `transcription.results[i].alternatives[j].items[k].`Inhalt ist das, was gesprochen wurde.

1. `transcription.results[i].alternatives[j].items[k].attendee`ist die Benutzerzuweisung (wer) des Inhalts.

1. `transcription.results[i].alternatives[j].items[k].startTimeMs`ist das „Wann“ des Inhalts. Auf diese Weise kann die vom Benutzer zugeordnete Transkription für verschiedene Benutzer in der Reihenfolge word-by-word wiedergegeben werden, in der die Wörter gesprochen wurden.

1. Das `transcription.results[i].alternatives[j].items[k].endTimeMs` Feld kann im Allgemeinen ignoriert werden, wird aber nur der Vollständigkeit halber angegeben, wer was wann gesagt hat.

1. `transcription.results[i].alternatives[j].items[k].vocabularyFilterMatch`ist wahr, wenn der Inhalt mit einem Wort im Filter übereinstimmt, andernfalls ist es falsch.

1. `transcription.results[i].alternatives[j].items[k].confidence`ist ein Wert zwischen 0 und 1. Er gibt die Gewissheit der Engine an, dass der Inhalt des Elements korrekt mit dem gesprochenen Wort übereinstimmt, wobei 0 die niedrigste und 1 die höchste Konfidenz darstellt.

1. `transcription.results[i].alternatives[j].items[k].stable`gibt an, ob sich das aktuelle Wort bei future Aktualisierungen von Teilergebnissen ändern wird. Dieser Wert kann nur wahr sein, wenn Sie die Funktion zur Stabilisierung von Teilergebnissen aktivieren, indem Sie `true` in Ihrer Anfrage `EnablePartialResultsStabilization` auf einstellen.

1. `transcription.results[i].alternatives[j].entities`enthält einen Eintrag für jede Entität, die von den Funktionen zur Inhaltserkennung oder Redaktion erkannt wird. Die Liste wird nur aufgefüllt, wenn Sie die Option Inhaltsidentifizierung oder Schwärzung aktivieren. Bei einer Entität kann es sich um Daten wie personenbezogene Daten oder persönliche Gesundheitsinformationen handeln. Sie können Entitäten verwenden, um interessante Wörter während der Transkription hervorzuheben oder entsprechende Maßnahmen zu ergreifen.

1. `transcription.results[i].alternatives[j].entities[k].category`ist die Kategorie der Entität. Sie entspricht dem Typ „Inhaltsidentifikation“ oder „Redaktion“, wie z. B. „PII“ oder „PHI“, der in der Anfrage angegeben ist.

1. `transcription.results[i].alternatives[j].entities[k].confidence`misst, wie stark der Motor dafür ist, dass der jeweilige Inhalt wirklich eine Einheit ist. Beachten Sie, dass dies etwas anderes ist als die Konfidenz auf Artikelebene, mit der gemessen wird, wie sicher die Engine von der Richtigkeit der Wörter selbst ist.

1. `transcription.results[i].alternatives[j].entities[k].content`ist der eigentliche Text, aus dem die Entität besteht. Dies können mehrere Elemente sein, z. B. eine Adresse.

1. `transcription.results[i].alternatives[j].entities[k].startTimeMs`erfasst den Zeitpunkt, zu dem die Entität anfängt, gesprochen zu werden.

1. `transcription.results[i].alternatives[j].entities[k].endTimeMs`erfasst den Zeitpunkt, zu dem das Sprechen der Entität beendet wurde.

1. `transcription.results[i].alternatives[j].entities[k].type`wird nur für die Transcribe-Engine unterstützt und stellt den Untertyp der Entität bereit. Dies sind Werte wie `ADDRESS`, `CREDIT\$1DEBIT\$1NUMBER` usw.

## Registrierung von Event-Handlern für TranscriptEvents
<a name="register-handler"></a>

In den folgenden Beispielen wird die Amazon Chime SDK-Clientbibliothek für JavaScript verwendet. Das Muster ist jedoch in allen Amazon Chime SDKs einheitlich.

Das `TranscriptionController` im `RealtimeController` und `RealtimeControllerFacade` beinhaltet spezifische Funktionen zum Hinzufügen eines Handlers, der Folgendes verarbeitet`TranscriptionEvents`:

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

Der `TranscriptionController` hat zwei Funktionen zur Verwaltung des An- und Abmeldens von Callbacks: `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;
}
```

**Verwenden der optionalen `TranscriptionController`**  
Wir bieten eine Standardimplementierung der `TranscriptionController` Schnittstelle named`DefaultTranscriptionController`. Die Standardimplementierung in `DefaultRealtimeController` und `DefaultAudioVideoFacade` gibt ein `DefaultTranscriptionController` Objekt zurück:

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

`DefaultRealtimeController`nimmt auch ein optionales `TranscriptionController` Objekt in seinen Konstruktor auf. Dadurch können Sie das `DefaultTranscriptionController` Verhalten überschreiben. Entwickleranwendungen abonnieren oder kündigen einen oder mehrere Callbacks über das `TranscriptionController` Objekt des `AudioVideoFacade` Objekts:

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

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

# Verarbeitung eines empfangenen Amazon Chime SDK-Live-Transkriptereignisses
<a name="delivery-examples"></a>

Die folgenden Beispiele zeigen, wie eine empfangene Datei verarbeitet wird. `TranscriptEvent`

**Anmerkung**  
Die genaue Leistung hängt von mehreren Faktoren ab, unter anderem davon, wie schnell Personen sprechen und wann sie eine Pause einlegen.

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

Dieses Beispiel zeigt eine typische `StartMeetingTranscription` Operation.

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

Die Operation generiert eine`TranscriptEvent`.

```
{   
    status: {        
        type: 'started',        
        eventTimeMs: 1620118800000,        
        transcriptionConfig: {                    
            LanguageCode: 'en-US'        
        }    
    }
}
```

## Beispiel 2: Ein teilweises Transkriptergebnis
<a name="example-2"></a>

In diesem Beispiel sagt ein Teilnehmer: „Der schnelle braune Fuchs springt über den faulen Hund.“ Beachten Sie, dass in diesem Beispiel der `isPartial` Wert ist. `true` Wenn Sie sich die Nachricht genauer ansehen, können Sie feststellen, dass das System das Wort „Fuchs“ als „Fakten“ verarbeitet hat. Das System verwendet dasselbe`resultId`, um das Protokoll zu aktualisieren. 

```
{
    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
                }]
            }]
        }]
    }
}
```

## Beispiel 3: Ein endgültiges Transkriptergebnis
<a name="example-3"></a>

Im Falle eines unvollständigen Transkripts verarbeitet das System die Phrase erneut. Dieses Beispiel hat den `isPartial` Wert`false`, und die Nachricht enthält „fox“ statt „facts“. Das System gibt die Nachricht mit derselben ID erneut aus.

```
{
    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
                }]
            }]
        }]
    }
}
```

# Analysieren von Amazon Chime SDK-Transkripten
<a name="parse-transcripts"></a>

Verwenden Sie den folgenden Befehl, um den Transkriptionsinhalt einer Transkriptionsnachricht zu analysieren. Der Befehl analysiert vollständige Sätze aus den Dateien 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"])
```

# Verwenden der Medienreplikation für Amazon Chime SDK-Besprechungen
<a name="media-replication"></a>

Sie können die Medienreplikation verwenden, um eine primäre WebRTC-Sitzung mit mehreren Replikatsitzungen zu verknüpfen, um ein größeres Publikum zu erreichen. Jede WebRTC-Mediensitzung unterstützt 250 Verbindungen, und Sie können eine primäre Sitzung in mehrere Replikatsitzungen replizieren. Teilnehmer, die mit einer Replikatsitzung verbunden sind, erhalten nur die Audio- und Videodaten der Moderatoren, die mit der primären Sitzung verbunden sind. Sie haben keine Kenntnis von den Teilnehmern, die mit der replizierten Sitzung verbunden sind, weshalb sich die Medienreplikation ideal für Webinare und andere Anwendungsfälle eignet, bei denen Datenschutz gewünscht wird.

Die folgende Abbildung zeigt die Medienreplikation zwischen einer primären Sitzung, bei der die Moderatoren Audio und Video gemeinsam nutzen, und einer Replikationssitzung, bei der die Teilnehmer die Medien konsumieren.

![\[Moderatoren nehmen an einer Hauptsitzung teil.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/replication-1.png)


**Anmerkung**  
Das Servicekontingent *Chime SDK Meetings — Replikat-Meetings pro primärem Meeting* hat einen Standardwert von 4, und Sie können dieses Limit auf Anfrage erhöhen. Weitere Informationen zu Kontingenten finden Sie unter [AWS Servicekontingenten](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) in der *AWS Allgemeinen* Referenz.

**Topics**
+ [Interaktive Teilnehmer](#interactive-participants)
+ [Teilnehmer aus aller Welt](#global-participants)
+ [Lebenszyklus einer Sitzung](#session-lifecycle)

## Interaktive Teilnehmer
<a name="interactive-participants"></a>

Teilnehmern, die mit einer Replikatsitzung verbunden sind, kann Zugriff auf die Teilnahme an der primären Sitzung gewährt werden. Da jeder eine WebRTC-Verbindung nutzt, kommt es bei Moderatoren und Teilnehmern nicht zu Verzögerungen bei der Transcodierung. Wenn Teilnehmer zwischen primärer und replizierter Sitzung wechseln, verwenden sie ihre WebRTC-Verbindungen wieder, sodass der Wechsel extrem schnell ist. Auf diese Weise können die Teilnehmer zur Live-Konversation beitragen, ohne Inhalte zu verpassen.

Die folgende Abbildung zeigt einen Teilnehmer einer Replikatsitzung, der seine WebRTC-Verbindung verwendet, um zur primären Sitzung zu wechseln.

![\[Das Diagramm zeigt zwei Teilnehmer, die von einer Replikatbesprechung zur Hauptbesprechung wechseln.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/replication-2.png)


## Teilnehmer aus aller Welt
<a name="global-participants"></a>

Sie können die AWS Region für jede WebRTC-Mediensitzung auswählen. Auf diese Weise können Sie Replikatsitzungen in Regionen erstellen, die näher an Ihren Teilnehmern liegen als an der Region der primären Sitzung. Wenn Sie dies tun, fließen Medien von der primären Sitzung zu den Replikatsitzungen im AWS-Netzwerk und dann von der Replikatsitzung zum Teilnehmer über das Internet. Wenn Sie vor einem globalen Publikum präsentieren, können Sie durch Replikatsitzungen in der Nähe Ihrer Teilnehmer sicherstellen, dass Medien im AWS-Netzwerk statt im Internet rund um die Welt übertragen werden, um ein besseres Meeting-Erlebnis zu erzielen.

Die folgende Abbildung zeigt eine primäre Sitzung und replizierte Sitzungen in verschiedenen Regionen.

![\[Diagramm, das Teilnehmer in 3 Regionen zeigt, die sich eine Präsentation ansehen.\]](http://docs.aws.amazon.com/de_de/chime-sdk/latest/dg/images/replication-3.png)


## Lebenszyklus einer Sitzung
<a name="session-lifecycle"></a>

Sitzungen erstellen  
Sie verwenden die [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) oder [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 um WebRTC-Mediensitzungen zu erstellen. Standardmäßig APIs erstellen sie eine primäre Sitzung, sofern Sie nicht ausdrücklich eine Replikatsitzung erstellen.  
Sie erstellen eine Replikatsitzung, indem Sie `PrimaryMeetingId` im `CreateMeeting` oder `CreateMeetingWithAttendees` API-Aufruf die der primären Sitzung angeben. `MeetingId`  
Wenn Sie den Wert `MeetingId` einer Replikatsitzung als angeben`PrimaryMeetingId`, schlägt der API-Aufruf fehl.

Teilnehmer werden erstellt  
 Um die Teilnehmeranmeldedaten zu erstellen, die für die Teilnahme an einer WebRTC-Mediensitzung erforderlich sind, können Sie den [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), oder [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.   
Wenn Sie Sitzungen für eine große Anzahl von Teilnehmern erstellen, verwenden Sie `CreateMeetingWithAttendees` oder, `BatchCreateAttendee` um die Anzahl der erforderlichen API-Aufrufe zu minimieren.

Teilnehmer löschen  
Sie verwenden die [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 zum Widerrufen der Anmeldedaten eines Teilnehmers für eine WebRTC-Mediensitzung. Wenn der Teilnehmer mit der Sitzung verbunden ist, wird die Verbindung getrennt und er kann nicht wieder teilnehmen.  
Wenn Sie das verwenden [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 zum Löschen einer WebRTC-Mediensitzung. Die API löscht automatisch alle Teilnehmer und Sie müssen nicht anrufen. `DeleteAttendee`

Zwischen den Sitzungen wechseln  
Damit ein Teilnehmer von einer Replikatsitzung zu einer primären Sitzung wechseln kann, müssen Sie in der Hauptbesprechung Anmeldeinformationen für ihn erstellen. Weitere Informationen finden Sie *weiter oben in dieser Liste unter Teilnehmer erstellen*. Verwenden Sie die Anmeldeinformationen mit der `promoteToPrimaryMeeting` Methode in der Amazon Chime SDK-Clientbibliothek, um zur primären Sitzung zu wechseln.  
Um die Teilnehmer wieder zu einer Replikatsitzung umzuschalten, verwenden Sie die `demoteFromPrimaryMeeting` Methode in der Amazon Chime SDK-Clientbibliothek, oder verwenden Sie die [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, um ihre primären Sitzungsanmeldedaten ungültig zu machen.  
Ein Moderator, der eine direkte Verbindung zu einer primären Sitzung herstellt, kann nicht zu einer Replikatsitzung wechseln.
Weitere Informationen zum Wechseln zwischen Sitzungen finden Sie in der Dokumentation zur Client-Bibliothek:  
+ [Amazon Chime SDK for Android aktiviert](https://github.com/aws/amazon-chime-sdk-android) GitHub.
+ [Amazon Chime SDK for iOS aktiviert](https://github.com/aws/amazon-chime-sdk-ios) GitHub.
+ [Amazon Chime SDK-Clientbibliothek für JavaScript](https://github.com/aws/amazon-chime-sdk-js) on GitHub.

Sitzungen löschen  
Sie verwenden die [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 zum Löschen von WebRTC-Mediensitzungen.  
Wenn Sie eine primäre Sitzung löschen, löscht die `DeleteMeeting` API automatisch alle angehängten Replikatsitzungen. Um also alle Sitzungen zu löschen, löschen Sie einfach die primäre.  
Der Dienst löscht automatisch eine primäre Sitzung, wenn fünf aufeinanderfolgende Minuten lang keine Teilnehmer eine Verbindung herstellen. Der Dienst löscht Replikatsitzungen nur automatisch, wenn er eine primäre Sitzung löscht. Das heißt, Sie können Replikatsitzungen erstellen, wenn Sie eine primäre Sitzung erstellen, und die Replikate sind für die Dauer der Primärsitzung verfügbar.

# Problembehandlung und Debuggen von Amazon Chime SDK-Besprechungen
<a name="troubleshoot-sdk-meetings"></a>

Verwenden Sie die folgenden Themen, um Probleme zu diagnostizieren und zu beheben, die bei der Arbeit mit dem Amazon Chime SDK auftreten. 

**Topics**
+ [Grundlegendes zu den Systemanforderungen für Amazon Chime SDK-Meetings](ts-supported-browsers.md)
+ [Einrichtung der Protokollierung und Überwachung für Amazon Chime SDK-Besprechungen](ts-log-monitor.md)
+ [Problembehandlung bei Amazon Chime SDK-Besprechungen](self-troubleshooting.md)
+ [Grundlegendes zu häufigen Problemen bei Amazon Chime SDK-Besprechungen](common-issues.md)

# Grundlegendes zu den Systemanforderungen für Amazon Chime SDK-Meetings
<a name="ts-supported-browsers"></a>

Stellen Sie im Rahmen der Problembehandlung sicher, dass Sie für unterstützte Browser programmieren. Eine aktuelle Liste der unterstützten Browser, Versionen und Betriebssysteme finden Sie unter[Amazon Chime SDK-Systemanforderungen](meetings-sdk.md#mtg-browsers). Im [Entwicklerhandbuch und FAQs auf Github](https://github.com/aws/amazon-chime-sdk-js/issues/1059) werden Browser- und andere Kompatibilitätsprobleme behandelt. Machen Sie sich außerdem mit den [bekannten Browserproblemen](https://aws.github.io/amazon-chime-sdk-js/modules/faqs.html#known-browser-issues) GitHub und möglichen Problemumgehungen vertraut.

Wenn Sie gerade erst mit Amazon Chime SDK Meetings begonnen haben, bietet die [Builder Journey des Amazon Chime SDK](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/20_Builders_Journey.md) einen step-by-step Leitfaden für die Entwicklung mit dem Amazon Chime SDK sowie die Tools, die für die Fehlerbehebung erforderlich sind.

# Einrichtung der Protokollierung und Überwachung für Amazon Chime SDK-Besprechungen
<a name="ts-log-monitor"></a>

Die Protokollierung hilft Ihnen dabei, Informationen wie serverseitige Besprechungsereignisse und clientseitige Browserkonsolenprotokolle zu sammeln.

Das Amazon Chime SDK bietet serverseitige Besprechungsereignisse, die Sie an Amazon senden können, EventBridge und Amazon CloudWatch Events-Protokolle. Sie können CloudWatch Metriken und Erkenntnisse erstellen und diese in Ihrem Dashboard zur Überwachung verwenden. Im Blogbeitrag [Serverseitige Protokollierung und Überwachung von Amazon Chime SDK-Ereignissen](https://aws.amazon.com/blogs/business-productivity/server-side-logging-and-monitoring-of-amazon-chime-sdk-events/) wird erklärt, wie die CloudWatch Metriken, Einblicke und das Dashboard aktiviert werden.

Das Amazon Chime SDK bietet clientseitige Ereignisse zu Audio- und Videoqualität, Netzwerkbandbreite und Verbindungsproblemen. Im Blogbeitrag [Überwachung und Fehlerbehebung mit Amazon Chime SDK Meeting-Ereignisse](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/) wird erklärt, wie Sie CloudWatch Metrics, Insights und Dashboard für Verbindungsfehler, Probleme mit der Audioqualität und Fehler bei der Mikrofon- und Kameraeinrichtung aktivieren. Weitere Informationen zu Besprechungsereignissen finden Sie unter [Besprechungsereignisse](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/06_Meeting_Events.md) auf Github. 



## Optionen für die Fehlerbehebung bei Metriken
<a name="ts-cloudwatch-options"></a>

Sie haben die folgenden Optionen für die Erfassung von Ereignissen zur Fehlerbehebung.
+ Senden Sie bei jedem Ereignis Metriken 
+ Batch-Ereignisse alle N Sekunden 
+ Senden Sie Metriken am Ende des Meetings 
+ Protokollierungsebene für Protokolle der Browserkonsole

## Empfohlene Metriken
<a name="ts-cloudwatch-metrics"></a>

Sie sollten mindestens die folgenden Messwerte sammeln und protokollieren.
+ SDK-Plattform und -Version
+ Browser und Version
+ Betriebssystem
+ Logische Kerne
+ Das Treffen hat begonnen
+ Das Treffen wurde beendet
+ Der Teilnehmer ist beigetreten
+ Teilnehmer ist gegangen
+ Die Anzahl der Teilnehmer fiel

Je nachdem, mit welchen Problemen Sie konfrontiert sind, können die folgenden Messwerte außerdem Informationen zu Konnektivitäts-, Bandbreiten- und Qualitätsproblemen liefern. Sie können jedes Vorkommen dieser Metriken protokollieren oder sie einfach zählen. Durch das Zählen können Sie sich einen Überblick über die zugrunde liegenden Probleme verschaffen:
+ connectionDidSuggestStopVideo
+ connectionDidBecomeGut
+ connectionDidBecomeSchlecht
+ Teilnahmezeit der Teilnehmer > t Sekunden
+ MeetingStartFailed
+ MeetingFailed

## Aktivierung der clientseitigen Protokollierung
<a name="client-side-logging"></a>

Sie können Browserprotokolle auf der `INFO` Ebene aktivieren, indem Sie sie an das Objekt `LogLevel.INFO` übergeben. `ConsoleLogger`

```
const logger = new ConsoleLogger('MyLogger', LogLevel.INFO);const meetingSession = new DefaultMeetingSession(configuration,logger,deviceController); 
```

Sie können die `POSTLogger` Komponente im Amazon Chime SDK auch verwenden, JavaScript um Browserprotokolle in Ihrem Backend zu erfassen, z. B. Amazon CloudWatch Logs. `POSTLogger`stellt `HTTP POST` Anfragen zum Hochladen von Browserprotokollen an die angegebene URL im [POSTLoggerKonstruktor](https://aws.github.io/amazon-chime-sdk-js/classes/postlogger.html). Beispielsweise GitHub verwendet die [serverlose Amazon Chime SDK-Demo](https://github.com/aws/amazon-chime-sdk-js/blob/main/demos/browser/app/meetingV2/meetingV2.ts#L1773) die, um Browserprotokolle `POSTLogger` zur future Untersuchung an Amazon CloudWatch Logs zu senden.

## Serverseitige Protokollierung aktivieren
<a name="server-side-logging"></a>

Das Amazon Chime SDK für ruft JavaScript auch die `eventDidReceive` Observer-Methode mit wichtigen Besprechungsereignissen wie `MeetingStartFailed` und `MeetingFailed` auf. Besprechungsereignisse enthalten häufig spezifische Gründe für Fehlschläge. Nehmen wir zum Beispiel an, dass bei einer großen Gruppe von Kunden Ausfälle auftreten. Ihre Webanwendung kann diese Besprechungsereignisse sammeln und sie dann an uns weitergeben, um die Ursache zu beheben. Weitere Informationen zu Besprechungsereignissen finden Sie im [Leitfaden für Besprechungsereignisse](https://aws.github.io/amazon-chime-sdk-js/modules/meetingevents.html) und im Blogbeitrag [Überwachung und Fehlerbehebung mit Amazon Chime SDK für Besprechungsereignisse](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/). GitHub

# Problembehandlung bei Amazon Chime SDK-Besprechungen
<a name="self-troubleshooting"></a>

In den Abschnitten dieses Themas werden verschiedene Möglichkeiten zur Selbstbehebung von Amazon Chime SDK-Besprechungen erläutert.

**Topics**
+ [Überprüfung FAQs und bekannte Probleme](#check-faqs)
+ [Überprüfung des Netzwerkzugriffs](#net-acess)

## Überprüfung FAQs und bekannte Probleme
<a name="check-faqs"></a>

In diesen FAQs und in den Listen bekannter Probleme finden Sie Hinweise GitHub zur Fehlerbehebung und zum Debuggen.
+ [Amazon Chime SDK — JavaScript — Treffen](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/07_FAQs.md#meetings)
+ [Amazon Chime SDK — JavaScript - Medien](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/07_FAQs.md#media)
+ [Amazon Chime SDK — JavaScript — Netzwerke](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/07_FAQs.md#networking)
+ [Amazon Chime SDK — Audio und Video](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/07_FAQs.md#audio-and-video)

## Überprüfung des Netzwerkzugriffs
<a name="net-acess"></a>

Unternehmen verfügen häufig über Netzwerk-Firewalls, die den Zugriff auf bestimmte Ports oder Verbindungen zu IP-Adressbereichen außerhalb ihres Netzwerks einschränken. In den folgenden Abschnitten werden einige Möglichkeiten erläutert, wie Sie den Netzwerkzugriff überprüfen können.

**Topics**
+ [Validierung von AWS SDK- und Amazon Chime SDK-Subnetzen und -Ports](#subnets-ports)
+ [Verwenden von Demo-Apps zur Reproduktion von Problemen](#repro-on-demo-apps)
+ [Verwenden des Meeting Readiness Checker](#ready-checker)

### Validierung von AWS SDK- und Amazon Chime SDK-Subnetzen und -Ports
<a name="subnets-ports"></a>

Anwendungen, die das Amazon Chime SDK verwenden, verwenden zwei Stufen: Server und Client. Die Serverebene verwendet das AWS SDK und verfügt über serverseitige Meeting-Handler. Die Client-Ebene verwendet den Client. SDKs

Das AWS SDK wird verwendet, um Server aufzurufen, APIs [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)z. Solche APIs stellen eine Verbindung zu den AWS globalen Service-Endpunkten in den `us-gov-west-1` Regionen `us-east-1``us-west-2`,`ap-southeast-1`,`eu-central-1`,`us-gov-east-1`, und her. Auf der Seite [AWS IP-Adressbereiche](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html) in der *AWS Allgemeinen Referenz* sind die IP-Adressbereiche für jede Region aufgeführt. Informationen zu Service-Endpunkten und Kontingenten finden Sie im [Amazon Chime SDK Endpoints](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) and Quotas.

Der Client SDKs, z. B. das Amazon Chime SDK für JavaScript, stellt eine Verbindung zu Service-Endpunkten in der `*.chime.aws` Domain her. 

Verwenden Sie die folgenden Validierungen, um sicherzustellen, dass Sie über Netzwerkberechtigungen verfügen:
+ Führen Sie den [Amazon Chime SDK Meeting Readiness Checker aus](https://github.com/aws/amazon-chime-sdk-js#meeting-readiness-checker), GitHub um zu überprüfen, ob Sie Ihr Netzwerk und Ihre Ports erreichen können.
+ Stellen Sie sicher, dass Sie die Domain\$1.chime.aws von Ihrem Netzwerk oder dem Netzwerk Ihres Endbenutzers aus auflösen können. 
+ Stellen Sie sicher, dass Ihre Firewall Verbindungen zum AWS IP-Bereich über den TCP-Port 443 für Steuerbefehle und den UDP-Port 3478 für Medien zulässt. 

### Verwenden von Demo-Apps zur Reproduktion von Problemen
<a name="repro-on-demo-apps"></a>

Es hat sich bewährt, den Debugging-Prozess zu starten, indem Sie versuchen, Ihr Problem in einer der Demo-Apps zu reproduzieren. Auf diese Weise kann das Serviceteam herausfinden, wo das Problem liegen könnte. Wenn Sie das Problem mit einer Demo-App nicht reproduzieren können, können Sie den Code der App überprüfen, um zu sehen, wie der entsprechende Anwendungsfall implementiert wurde.




| Amazon Chime SDK | Feature | Ressourcen für die Demo-App | 
| --- | --- | --- | 
| JavaScript SDK | Meetings | [Demo-Anweisungen](https://github.com/aws/amazon-chime-sdk-js/tree/main/demos/serverless), [Quellcode](https://github.com/aws/amazon-chime-sdk-js/tree/main/demos/browser) | 
| React-Komponenten | Meetings |   [Demo-Anweisungen](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/meeting) [Quellcode](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/meeting/src)   | 
| Besprechungs-Chat | Messaging |   [Blogbeitrag](https://aws.amazon.com/blogs/business-productivity/build-meeting-features-into-your-amazon-chime-sdk-messaging-application/), [Demo-Anweisungen](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/chat), [Quellcode](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/chat/src)   | 
| iOS/Android | Meetings |  (Blogbeitrag) [Erstellen einer Meeting-Anwendung auf Android mithilfe des Amazon Chime SDK](https://aws.amazon.com/blogs/business-productivity//building-a-meeting-application-on-android-using-the-amazon-chime-sdk/) (Blogbeitrag) [Erstellen einer Meeting-Anwendung auf iOS mithilfe des Amazon Chime SDK](https://aws.amazon.com/blogs/business-productivity/building-a-meeting-application-on-ios-using-the-amazon-chime-sdk/)   | 
| PSTN-Audio | Eingehende Anrufe |   [Quellcode](https://github.com/aws-samples/amazon-chime-sma-update-call) des [Blogbeitrags](https://github.com/aws-samples/amazon-chime-sma-update-call)   | 

### Verwenden des Meeting Readiness Checker
<a name="ready-checker"></a>

Verwenden Sie den [Amazon Chime SDK Meeting Readiness Checker](https://github.com/aws/amazon-chime-sdk-js#meeting-readiness-checker) auf. GitHub Der Checker hilft bei der Überprüfung von Audio- und Videogeräten sowie Benutzerverbindungen. Sie können die Ergebnisse Ihren Endbenutzern präsentieren, indem Sie pass/fail Statuen verwenden, die die Ursache aller Probleme aufdecken.

# Grundlegendes zu häufigen Problemen bei Amazon Chime SDK-Besprechungen
<a name="common-issues"></a>

In den folgenden Abschnitten finden Sie Methoden zur Behebung häufiger Probleme bei Besprechungen.

**Topics**
+ [Probleme mit der Verbindung](#connectivity-issues)
+ [Probleme mit der Audio- und Videoqualität](#a-v-quality)
+ [Überprüfung der SDK-Kontingente und API-Drosselung für Amazon Chime SDK-Meetings](quotas-throttling.md)
+ [Eröffnung von Supportfällen für Amazon Chime SDK-Besprechungen](open-support-cases.md)

## Probleme mit der Verbindung
<a name="connectivity-issues"></a>

Informationen zu Verbindungsproblemen finden Sie unter[Überprüfung des Netzwerkzugriffs](self-troubleshooting.md#net-acess).

## Probleme mit der Audio- und Videoqualität
<a name="a-v-quality"></a>

Probleme mit der Audio- und Videoqualität können verschiedene Ursachen haben. Zwei Hauptgründe für eine suboptimale audio/video Qualität sind die Netzwerkbandbreite und die Geräteleistung. Ausführliche Informationen zu den verschiedenen Herausforderungen und deren Auswirkungen auf die audio/video Qualität finden Sie unter [Qualität, Bandbreite und Konnektivität](https://aws.github.io/amazon-chime-sdk-js/modules/qualitybandwidth_connectivity.html) auf *GitHub*. In diesem Artikel werden verschiedene Ereignisse und Metriken beschrieben, die überwacht werden können, um Bandbreitenprobleme und mögliche Abhilfemaßnahmen zu erkennen.

Sie können eine Medienregion wählen, die näher an der Zielgruppe der Zielsitzung liegt. Informationen zur Auswahl einer optimalen Medienregion finden Sie unter Verwenden von Meeting-Regionen (https://docs.aws.amazon.com/chime-sdk/latest/dg/chimesdk-meetings-regions-.html).

Abhängig von der Bandbreite, die einem Besprechungsteilnehmer zur Verfügung steht, passt das Amazon Chime SDK die Videoqualität des Videos an, da es sich um Richtlinien handelt. 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 

**Überlegungen zur Videoauflösung**
+ Die Standardauflösung für das Hochladen von Videos beträgt 540p und 15 Bilder pro Sekunde bei 1400 kBit/s. Je nach Bandbreite können Sie diese Auflösung und Bildrate reduzieren.
+ Ermitteln Sie anhand der verfügbaren Empfängerbandbreite, wie viele Videokacheln angezeigt werden sollen. Überschreiten Sie nicht die Geschwindigkeit von 6 Mbit/s bei allen Videokacheln und beim Teilen von Inhalten. Endbenutzer sehen schwarze Videokacheln, wenn sie nicht über genügend Bandbreite verfügen.

**Verwenden von Bandbreitenrichtlinien für Video-Uplink und Downlink**  
Das Amazon Chime SDK bietet die folgenden Bandbreitenrichtlinien.
+ NScaleVideoUplinkBandwidthPolicy — Implementiert Erfassungs- und Kodierungsparameter, die fast denen entsprechen, die von Desktop-, Web- und mobilen Clients verwendet werden.
+ AllHighestVideoBandwidthPolicy — Abonniert immer den Videostream von höchster Qualität.
+ NoVideoDownlinkBandwidthPolicy — Deaktiviert Video, wenn die Bandbreite unter einen bestimmten Schwellenwert fällt.
+ VideoPriorityBasedPolicy — Priorisiert Audio vor Video bei geringer Bandbreite.
+ VideoAdaptiveProbePolicy

# Überprüfung der SDK-Kontingente und API-Drosselung für Amazon Chime SDK-Meetings
<a name="quotas-throttling"></a>

Auf der Seite [Endpunkte und Kontingente des Amazon Chime SDK](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) sind die Servicekontingente und API-Tarife aufgeführt und es wird angegeben, ob Sie sie anpassen können. Verwenden Sie die Seite [AWS Console Service Quota, um Kontingentanpassungen](https://console.aws.amazon.com/servicequotas/home/services/chime/quotas) anzufordern.

**Optimieren Sie Ihre API-Tarife**  
Anwendungen, die ihre API-Raten überschreiten, erhalten den HTTP-Statuscode 429 und `ThrottledClientException` Nachrichten. Sie können Ihre API-Raten anpassen, aber bevor Sie dies tun, sollten Sie Ihre Anwendung auf Fehler überprüfen, die diese Raten möglicherweise übersteigen. Sie können beispielsweise Besprechungen in einer Schleife erstellen oder Besprechungen erstellen und nicht aufräumen.

Je nachdem, wie Sie Besprechungen erstellen, müssen Sie möglicherweise Ihren Code ändern. Beispielsweise können Sie `CreateMeeting` und durch Folgendes `CreateAttendee` ersetzen: 
+ [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)— Erzeugt bis zu 10 Teilnehmer pro Meeting.
+ [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)— Erzeugt bis zu 100 Teilnehmer pro Meeting.

Sie können erstellte Teilnehmer in einer Datenbank speichern, Teilnehmerinformationen abrufen, wenn eingeladene Personen an der Besprechung teilnehmen, und sie dann den zuvor erstellten Teilnehmern zuordnen.

# Eröffnung von Supportfällen für Amazon Chime SDK-Besprechungen
<a name="open-support-cases"></a>

Wenn Sie weitere Fragen haben oder Unterstützung für Ihr Unternehmen benötigen, können Sie sich an den [AWS-Kundensupport](https://pages.awscloud.com/GLOBAL-aware-GC-Amazon-Chime-SDK-2020-reg.html) wenden. Weitere Informationen zu unseren Support-Plänen finden Sie auf der Seite [Supportpläne vergleichen](https://aws.amazon.com/premiumsupport/plans/?nc=sn). Wenn Sie einen Support-Fall erstellen, öffnen Sie ihn immer unter dem Konto, bei dem das Problem aufgetreten ist. Fügen Sie die Browserprotokolle der Konsole, die Besprechung und die Teilnehmer IDs sowie alle damit verbundenen Supportfälle oder GitHub Probleme hinzu.