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.
# Amazon Chime SDK-Medien-Pipelines erstellen
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
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
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
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
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
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
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
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
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
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
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
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
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
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::;:role/"
...
},
...
```
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:::role/"
},
"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": ""
},
"ArnLike": {
"aws:SourceArn": "arn:aws:chime:*::*"
}
}
}
```
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:::key/",
"Condition": {
"StringEquals": {
"aws:SourceAccount": ""
},
"ArnLike": {
"aws:SourceArn": "arn:aws:chime:*::*"
}
}
},
{
"Effect": "Allow",
"Action": ["s3:PutObject", "s3:PutObjectAcl"],
"Resource": "arn:aws:s3:::/*",
"Condition": {
"StringEquals": {
"aws:SourceAccount": ""
},
"ArnLike": {
"aws:SourceArn": "arn:aws:chime:*::*"
}
}
}
```
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": "",
"Condition": {
"ArnLike": {
"iam:AssociatedResourceArn": "arn:aws:chime:*::media-pipeline/*"
},
"StringEquals": {
"iam:PassedToService": "mediapipelines.chime.amazonaws.com"
}
}
}
```
## Implementierung der Medienverkettung
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:::key/",
...
}
...
{
"Action": [ "s3:PutObject", "s3:PutObjectAcl", "s3:GetObject", "s3:ListBucket"],
"Resource": "arn:aws:s3:::/*",
}
...
}
...
```
# Erstellung der Amazon Chime SDK-Medienerfassungspipeline
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
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
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
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 >- Zeitstempel mit einer Teilnehmer-ID. 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
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
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
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
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
**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
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
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
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
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
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
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
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
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
```
'''
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
```
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
```
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
```
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
```
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
```
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
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
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
```
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
```
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
```
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
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
Medienstream-Pipelines senden die folgenden Ereignisse. Erweitern Sie jeden Abschnitt, um mehr zu erfahren.
## Amazon Chime Media Stream-Pipeline Kinesis Video Stream starten
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
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
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
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
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
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
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
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
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
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
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
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
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
`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
`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
`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
`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
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
*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
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
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
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
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
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
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
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
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
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
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
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
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
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.