# Überblick über IVS Serverseitige Zusammensetzung
<a name="ssc-overview"></a>

Dieses Diagramm veranschaulicht, wie serverseitige Zusammensetzung funktioniert:

![\[Übertragung einer Stufe mithilfe serverseitiger Zusammensetzung.\]](http://docs.aws.amazon.com/de_de/ivs/latest/RealTimeUserGuide/images/ssc_Intro_Composite_Recording.png)


## Vorteile
<a name="ssc-benefits"></a>

Im Vergleich zur clientseitigen Zusammensetzung bietet die serverseitige Zusammensetzung die folgenden Vorteile:
+ **Reduzierte Client-Last** – Bei der serverseitigen Zusammensetzung wird die Last der Verarbeitung und Kombination von Audio- und Videoquellen von einzelnen Client-Geräten auf den Server selbst verlagert. Durch die serverseitige Zusammensetzung entfällt die Anforderung, dass Client-Geräte ihre CPU- und Netzwerkressourcen für die Zusammensetzung der Anzeige und deren Übertragung an IVS verwenden. Dies bedeutet, dass Zuschauer die Übertragung ansehen können, ohne dass ihre Geräte ressourcenintensive Aufgaben erledigen müssen, was zu einer verbesserten Akkulaufzeit und einem flüssigeren Seherlebnis führen kann.
+ **Gleichbleibende Qualität** – Die serverseitige Zusammensetzung ermöglicht eine präzise Kontrolle über die Qualität, Auflösung und Bitrate des endgültigen Streams. Dies gewährleistet ein einheitliches Seherlebnis für alle Zuschauer, unabhängig von den Fähigkeiten ihrer einzelnen Geräte.
+ **Ausfallsicherheit** – Durch die Zentralisierung des Zusammensetzungsprozesses auf dem Server wird die Übertragung stabiler. Selbst wenn ein Publisher-Gerät technischen Einschränkungen oder Schwankungen unterliegt, kann sich der Server anpassen und allen Zuschauermitgliedern einen reibungsloseren Stream bieten.
+ **Bandbreiteneffizienz** – Da der Server die Zusammensetzung übernimmt, müssen Stufen-Publisher keine zusätzliche Bandbreite für die Übertragung des Videos an IVS aufwenden.

Um eine Stufe an einen IVS-Kanal zu übertragen, können Sie alternativ die Zusammensetzung clientseitig durchführen; Weitere Informationen finden Sie unter [Aktivierung mehrerer Hosts auf einem IVS-Stream](https://docs.aws.amazon.com//ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zum IVS-Streaming mit niedriger Latenz*.

## Lebenszyklus einer Zusammensetzung
<a name="ssc-composition-endpoint"></a>

Verwenden Sie das folgende Diagramm, um sich mit den Statusübergänge einer Zusammensetzung vertraut zu machen:

![\[Lebenszyklus einer serverseitigen Zusammensetzungsressource.\]](http://docs.aws.amazon.com/de_de/ivs/latest/RealTimeUserGuide/images/ssc_Composition_Lifecycle.png)


Auf einer hohen Ebene sieht der Lebenszyklus einer Zusammensetzung wie folgt aus:

1. Eine Composition-Ressource wird erstellt, wenn der Benutzer den Vorgang StartComposition aufruft.

1. Sobald IVS die Zusammensetzung erfolgreich startet, wird ein EventBridge-Ereignis „Statusänderung IVS-Zusammensetzung (Sitzungsstart)“ gesendet. Einzelheiten zu Ereignissen finden Sie unter [Verwenden von EventBridge mit IVS-Echtzeit-Streaming](eventbridge.md).

1. Sobald sich eine Zusammensetzung im aktiven Status befindet, kann Folgendes passieren:
   + Benutzer hält die Zusammensetzung an – Wenn der Vorgang StopComposition aufgerufen wird, initiiert IVS ein ordnungsgemäßes Herunterfahren der Zusammensetzung und sendet „Zielende“-Ereignisse, gefolgt von einem „Sitzungsende“-Ereignis.
   + Zusammensetzung wird automatisch heruntergefahren – Wenn die IVS-Stufe gelöscht wird oder 60 Sekunden lang kein Teilnehmer in der IVS-Stufe aktiv veröffentlicht, wird die Zusammensetzung automatisch abgeschlossen und EventBridge-Ereignisse werden gesendet.
   + Zielfehler – Wenn ein Ziel unerwartet ausfällt (z. B. wenn der IVS-Kanal gelöscht wird), wechselt das Ziel in den `RECONNECTING`-Status und es wird ein Ereignis „Wiederverbindung zum Ziel“ gesendet. Wenn eine Wiederherstellung nicht möglich ist, versetzt IVS das Ziel in den `FAILED`-Status und es wird ein „Zielfehler“-Ereignis gesendet. IVS hält die Zusammensetzung aktiv, wenn mindestens eines ihrer Ziele aktiv ist.

1. Sobald sich die Zusammensetzung im `STOPPED`- oder `FAILED`-Status befindet, wird sie nach fünf Minuten automatisch bereinigt. (Dann wird sie nicht mehr von ListCompositions oder GetComposition abgerufen.)

## IVS-API
<a name="ssc-api"></a>

Die serverseitige Zusammensetzung verwendet diese wichtigen API-Elemente:
+ Mit einem *EncoderConfiguration*-Objekt können Sie das Format des zu generierenden Videos anpassen (Höhe, Breite, Bitrate und andere Streaming-Parameter). Sie können eine EncoderConfiguration bei jedem Aufruf des Vorgangs StartComposition wiederverwenden.
+ *Composition*-Vorgänge verfolgen die Video-Zusammensetzung und die Ausgabe über einen IVS-Kanal.
+ *StorageConfiguration* verfolgt den S3-Bucket, in dem Zusammensetzungen aufgezeichnet werden.

Um die serverseitige Zusammensetzung zu verwenden, müssen Sie eine EncoderConfiguration erstellen und diese beim Aufruf des Vorgangs StartComposition anfügen. In diesem Beispiel wird die SquareVideo EncoderConfiguration in zwei Zusammensetzungen verwendet:

![\[Bei der serverseitigen Zusammensetzung werden zwei wichtige API-Elemente verwendet.\]](http://docs.aws.amazon.com/de_de/ivs/latest/RealTimeUserGuide/images/ssc_IVS_API_Composite_Recording.png)


Vollständige Informationen finden Sie unter [API-Referenz zu IVS-Echtzeit-Streaming](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/Welcome.html).

## Layouts
<a name="ssc-api-layouts"></a>

Der Vorgang StartComposition bietet zwei Layoutoptionen: Raster und PiP (Bild-in-Bild).

### Raster-Layout
<a name="ssc-api-layouts-grid"></a>

Das Raster-Layout ordnet Bühnenteilnehmer in einem Raster aus gleichgroßen Slots an. Er bietet mehrere anpassbare Eigenschaften:
+ `videoAspectRatio` legt den Anzeigemodus für Teilnehmer fest, um das Seitenverhältnis von Videokacheln zu steuern.
+ `videoFillMode` legt fest, wie Videoinhalte in die Teilnehmerkachel passen.
+ `gridGap` gibt den Abstand zwischen Teilnehmerkacheln in Pixeln an.
+ `omitStoppedVideo` ermöglicht das Ausschließen gestoppter Videostreams aus der Zusammensetzung.
+ `featuredParticipantAttribute` identifiziert den hervorgehobenen Slot. Wenn diese Option aktiviert ist, wird der hervorgehobene Teilnehmer in einem größeren Slot auf dem Hauptbildschirm angezeigt, andere Teilnehmer werden darunter angezeigt.
+ `participantOrderAttribute` ermöglicht eine benutzerdefinierte Teilnehmeranordnung auf Grundlage der Attributwerte in den Teilnehmer-Token. Wenn diese Option angegeben ist, werden die Teilnehmer numerisch nach ihren Attributwerten angeordnet. Bei Teilnehmern ohne das Attribut erfolgt die Anordnung wieder nach der Ankunftszeit. Das bietet eine optionale deterministische Positionierung und ermöglicht rollenbasierte Layouts.

Einzelheiten zum Raster-Layout (einschließlich gültiger Werte und Standardwerte für alle Felder) finden Sie unter dem Datentyp [GridConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_GridConfiguration.html).

![\[Raster-Layout für serverseitige Zusammensetzung\]](http://docs.aws.amazon.com/de_de/ivs/latest/RealTimeUserGuide/images/ssc_Grid_Layout.png)


### Bild-in-Bild (PiP)-Layout
<a name="ssc-api-layouts-pip"></a>

Das PiP-Layout ermöglicht die Anzeige eines Teilnehmers in einem Overlay-Fenster mit konfigurierbarer Größe, Position und Verhaltensweise. Zu den wichtigsten Eigenschaften gehören:
+ `pipParticipantAttribute` gibt den Teilnehmer für das PiP-Fenster an.
+ `pipPosition` bestimmt die Eckposition des PiP-Fensters.
+ `pipWidth` und `pipHeight` konfigurieren die Breite und Höhe des PiP-Fensters.
+ `pipOffset` legt die Versatzposition des PiP-Fensters in Pixeln von den nächstgelegenen Kanten fest.
+ `pipBehavior` definiert das PiP-Verhalten, wenn alle anderen Teilnehmer gegangen sind.

Wie das Raster-Layout unterstützt auch das PiP-Layout `featuredParticipantAttribute`, `omitStoppedVideo`, `videoFillMode`, `gridGap` und `participantOrderAttribute` zur weiteren Anpassung der Zusammensetzung. Das `participantOrderAttribute` ermöglicht eine benutzerdefinierte Teilnehmeranordnung für die Auswahl der Teilnehmer für das PiP-Fenster und für die Positionierung der Raster-Teilnehmer auf Grundlage der Attributwerte in den Teilnehmer-Token.

Einzelheiten zum PiP-Layout (einschließlich gültiger Werte und Standardwerte für alle Felder) finden Sie unter dem Datentyp [PipConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_PipConfiguration.html).

![\[Bild-in-Bild (PiP)-Layout für serverseitige Zusammensetzung\]](http://docs.aws.amazon.com/de_de/ivs/latest/RealTimeUserGuide/images/ssc_PiP_Layout.png)


**Hinweis**: Die maximale Auflösung, die von einem Stufen-Publisher bei serverseitiger Zusammensetzung unterstützt wird, beträgt 1080 p. Wenn ein Publisher Videos mit einer höheren Auflösung als 1080 p sendet, wird der Publisher als reiner Audio-Teilnehmer gerendert.

**Wichtig**: Stellen Sie sicher, dass Ihre Anwendung nicht von den spezifischen Features des aktuellen Layouts abhängt, z. B. von Größe und Position der Kacheln. *Visuelle Verbesserungen an Layouts können jederzeit vorgenommen werden*.