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.

# Referenz zu den GStreamer-Elementparametern
<a name="examples-gstreamer-plugin-parameters"></a>

Um Videos an das C\+\+-SDK des Amazon Kinesis Video Streams-Herstellers zu senden, geben Sie `kvssink` als * Senke * oder Endziel der Pipeline an. Diese Referenz enthält Informationen zu den erforderlichen und optionalen `kvssink`-Parametern. Weitere Informationen finden Sie unter [Beispiel: Das SDK, das GStreamer-Plugin des Herstellers von Kinesis Video Streams — kvssink](examples-gstreamer-plugin.md).

**Topics**
+ [Geben Sie Anmeldeinformationen für kvssink ein ``](#credentials-to-kvssink)
+ [Geben Sie eine Region für `kvssink an`](#kvssink-region)
+ [`kvssink`, optionale Parameter](#kvssink-optional-parameters)

## Geben Sie Anmeldeinformationen für kvssink ein ``
<a name="credentials-to-kvssink"></a>

Damit das `kvssink` GStreamer-Element Anfragen an folgende Adresse richten kann AWS, geben Sie AWS Anmeldeinformationen an, die es verwenden kann, wenn es den Amazon Kinesis Video Streams-Dienst aufruft. Die Kette der Anmeldeinformationsanbieter sucht in der folgenden Reihenfolge nach Anmeldeinformationen:

### 1. AWS IoT Anmeldedaten
<a name="collapsible-section-1"></a>

Informationen zum Einrichten von AWS IoT Anmeldeinformationen finden Sie unter[Steuern Sie den Zugriff auf Kinesis Video Streams-Ressourcen mit AWS IoT](how-iot.md).

Der `iot-credentials` Parameterwert muss mit einer kommagetrennten Liste der folgenden {{key}} = {{value}} -Paare beginnen `iot-certificate,` und darauf folgen.



| Key (Schlüssel) | Erforderlich | Beschreibung | 
| --- | --- | --- | 
| ca-path | Ja | Dateipfad zum CA-Zertifikat, das verwendet wird, um das Vertrauen in den Back-End-Dienst über TLS herzustellen.**Beispiel**: ` /{{file}}/{{path}}/{{to}}/certificate.pem` | 
| cert-path | Ja | Dateipfad zum X.509 Zertifikat. **Beispiel**: `/{{file}}/{{path}}/{{to}}/{{certificateID}}-certificate.pem.crt` | 
| endpoint | Ja | Der Endpunkt des Providers für AWS IoT Core Anmeldeinformationen für Ihr AWS Konto. Weitere Informationen finden Sie im [AWS IoT Entwicklerhandbuch](https://docs.aws.amazon.com/iot/latest/developerguide/authorizing-direct-aws.html).**Beispiel**: `{{credential-account-specific-prefix}}.credentials.iot.{{aws-region}}.amazonaws.com` | 
| key-path | Ja | Dateipfad zum privaten Schlüssel, der im public/private Schlüsselpaar verwendet wird. **Beispiel**: `/{{file}}/{{path}}/{{to}}/{{certificateID}}-private.pem.key` | 
| role-aliases | Ja | Der Name des Rollenalias, der auf die AWS IAM-Rolle verweist, mit der eine Verbindung hergestellt werden soll AWS IoT Core. **Beispiel**: `{{KvsCameraIoTRoleAlias}}` | 
| iot-thing-name | Nein | Die `iot-thing-name` ist optional. Wenn nicht angegeben, `iot-thing-name` wird der `stream-name` Parameterwert verwendet.**Beispiel**: `{{kvs_example_camera}}` | 

**Example**  
**Beispiel:**  

```
gst-launch-1.0 -v ... ! kvssink stream-name="{{YourStream}}" aws-region="{{YourRegion}}" iot-certificate="iot-certificate,endpoint={{credential-account-specific-prefix}}.credentials.iot.{{aws-region}}.amazonaws.com,cert-path={{certificateID}}-certificate.pem.crt,key-path={{certificateID}}-private.pem.key,ca-path={{certificate}}.pem,role-aliases={{YourRoleAlias}},iot-thing-name={{YourThingName}}"
```

### 2. Umgebungsvariablen
<a name="collapsible-section-2"></a>

Um Anmeldeinformationen aus der Umgebung `kvssink` verwenden zu können, legen Sie die folgenden Umgebungsvariablen fest:



| Name der Umgebungsvariablen | Erforderlich | Beschreibung | 
| --- | --- | --- | 
| AWS\_ACCESS\_KEY\_ID | Ja | Der AWS Zugriffsschlüssel, der für den Zugriff auf Amazon Kinesis Video Streams verwendet wird. | 
| AWS\_SECRET\_ACCESS\_KEY | Ja | Der AWS geheime Schlüssel, der dem Zugriffsschlüssel zugeordnet ist. | 
| AWS\_SESSION\_TOKEN | Nein | Gibt den erforderlichen Sitzungstoken-Wert an, wenn Sie temporäre Sicherheitsanmeldeinformationen direkt von AWS STS Operations verwenden. | 

Durch die Festlegung der Umgebungsvariablen wird der verwendete Wert bis zum Ende der Shell-Sitzung oder bis zur Festlegung eines anderen Wertes für die Variable geändert. Um die Variablen für zukünftige Sitzungen persistent zu machen, legen Sie sie im Startskript Ihrer Shell fest.

### 3. `Zugriffsschlüssel`, Geheimschlüsselparameter ``
<a name="collapsible-section-3"></a>

Um Anmeldeinformationen direkt als Parameter anzugeben, legen Sie die `kvssink` folgenden Parameter fest:



| `kvssink`Name des Parameters | Erforderlich | Beschreibung | 
| --- | --- | --- | 
| access-key | Ja | Der AWS Zugriffsschlüssel, der für den Zugriff auf Amazon Kinesis Video Streams verwendet wird. | 
| secret-key | Ja | Der AWS geheime Schlüssel, der dem Zugriffsschlüssel zugeordnet ist. | 
| session-token | Nein | Gibt den erforderlichen Sitzungstoken-Wert an, wenn Sie temporäre Sicherheitsanmeldeinformationen direkt von AWS STS Operations verwenden. | 

**Example**  
**Verwenden statischer Anmeldeinformationen: **  

```
gst-launch-1.0 -v ... ! kvssink stream-name="{{YourStream}}" aws-region="{{YourRegion}}" access-key="{{AKIDEXAMPLE}}" secret-key="{{SKEXAMPLE}}"
```

**Example**  
**Verwendung temporärer Anmeldeinformationen: **  

```
gst-launch-1.0 -v ... ! kvssink stream-name="{{YourStream}}" aws-region="{{YourRegion}}" access-key="{{AKIDEXAMPLE}}" secret-key="{{SKEXAMPLE}}" session-token="{{STEXAMPLE}}"
```

### 4. Datei mit Anmeldeinformationen
<a name="collapsible-section-4"></a>

**Wichtig**  
Wenn Sie eine der vorherigen Methoden ausgewählt haben, können Sie den `credential-path` `kvssink` Parameter nicht verwenden.



| `kvssink`Name des Parameters | Erforderlich | Beschreibung | 
| --- | --- | --- | 
| credential-path | Ja | Pfad zur Textdatei, die Anmeldeinformationen in einem bestimmten Format enthält. | 

Die Textdatei muss Anmeldeinformationen in einem der folgenden Formate enthalten:
+ ANMELDEINFORMATIONEN {{YourAccessKey}} {{YourSecretKey}}
+ REFERENZEN {{YourAccessKey}} {{Expiration}} {{YourSecretKey}} {{SessionToken}}

**Example**  
**Beispiel: ** Ihre `{{credentials}}.txt` Datei befindet sich unter `/home/ubuntu` und enthält Folgendes:   
`CREDENTIALS {{AKIDEXAMPLE 2023-08-10T22:43:00Z SKEXAMPLE STEXAMPLE}}`  
Um es in zu verwenden`kvssink`, geben Sie Folgendes ein:   

```
gst-launch-1.0 -v ... ! kvssink stream-name="{{YourStream}}" aws-region="{{YourRegion}}" credential-path="/home/ubuntu/{{credentials}}.txt" 
```
Die Ablaufzeit sollte in Zukunft mindestens 5 \+ 30 \+ 3 = ** 38 ** Sekunden betragen. Die Kulanzfrist ist als die `IOT_CREDENTIAL_FETCH_GRACE_PERIOD` Variable in definiert [`IotCredentialProvider.h`](https://github.com/awslabs/amazon-kinesis-video-streams-producer-c/blob/master/src/source/Common/IotCredentialProvider.h). Wenn die Anmeldeinformationen zu Beginn zu kurz vor dem Ablaufdatum stehen`kvssink`, erhalten Sie den Fehlercode`0x52000049 - STATUS_INVALID_TOKEN_EXPIRATION`.
`kvssink`ändert die Datei mit den Anmeldeinformationen nicht. Wenn Sie temporäre Anmeldeinformationen verwenden, muss die Datei mit den Anmeldeinformationen vor Ablauf der Gültigkeitsdauer abzüglich der Kulanzfrist von einer externen Quelle aktualisiert werden. 

## Geben Sie eine Region für `kvssink an`
<a name="kvssink-region"></a>

Im Folgenden finden Sie die Suchreihenfolge für Regionen:

1. `AWS_DEFAULT_REGION`Die Umgebungsvariable wird zuerst überprüft. Wenn sie gesetzt ist, wird diese Region zur Konfiguration des Clients verwendet.

1. `aws-region`Der Parameter wird als Nächstes überprüft. Wenn er gesetzt ist, wird diese Region zur Konfiguration des Clients verwendet.

1. Wenn keine der vorherigen Methoden verwendet wurde, ist die `kvssink` Standardeinstellung. `us-west-2` 

## `kvssink`, optionale Parameter
<a name="kvssink-optional-parameters"></a>

Das Element `kvssink` hat die folgenden optionalen Parameter. Weitere Informationen zu diesen Parametern finden Sie unter [Kinesis-Videostream-Strukturen](producer-reference-structures-stream.md).



| Parameter | Description | Einheit/Typ | Standard | 
| --- | --- | --- | --- | 
| stream-name  | Der Name des Amazon Kinesis-Zielvideostreams.  Wenn kein Streamname angegeben ist, wird der Standard-Stream-Name verwendet: „DEFAULT\_STREAM“. Wenn ein Stream mit diesem Standardnamen noch nicht existiert, wird er erstellt.  |  |  | 
| absolute-fragment-times | Gibt an, ob absolute Fragmentzeiten verwendet werden. | Boolesch | true | 
| access-key | Der AWS Zugriffsschlüssel, der für den Zugriff auf Kinesis Video Streams verwendet wird. <br />Sie müssen entweder AWS Anmeldeinformationen festgelegt haben oder diesen Parameter angeben. Geben Sie Folgendes ein, um diese Informationen bereitzustellen:<pre>export AWS_ACCESS_KEY_ID=</pre> |  |  | 
| avg-bandwidth-bps | Die erwartete durchschnittliche Bandbreite für den Stream.  | Bits pro Sekunde | 4194304 | 
| aws-region | Die AWS-Region zu verwendenden. Sie können die Region auch mit der `AWS_DEFAULT_REGION` Umgebungsvariablen versehen. Die Umgebungsvariablen haben Vorrang, wenn sowohl die Umgebungsvariable als auch die kvssink-Parameter gesetzt sind.  Die Region wird standardmäßig auf gesetzt, `us-west-2` sofern nicht anders angegeben.  | Zeichenfolge | "us-west-2" | 
| buffer-duration | Laufzeit des Streampuffers  | Sekunden | 120 | 
| codec-id | Die Codec-ID des Streams | Zeichenfolge | "V\_MPEG4/ISO/AVC" | 
| connection-staleness | Die Zeit, nach der der Stream Staleness Callback aufgerufen wird. | Sekunden | 60 | 
| content-type | Der Inhaltstyp des Streams | Zeichenfolge | "video/h264" | 
| fragment-acks | Gibt an, ob Fragment-ACKs verwendet werden. | Boolesch | true | 
| fragment-duration | Die gewünschte Fragmentdauer | Millisekunden | 2000 | 
| framerate | Die erwartete Bildrate. | Frames pro Sekunde | 25 | 
| frame-timecodes | Verwendung von Frame-Timecodes oder Generieren von Zeitstempeln mit dem aktuellen Zeit-Callback:  | Boolesch | true | 
| key-frame-fragmentation | Gibt an, ob Fragmente für einen Keyframe erstellt werden. | Boolesch | true | 
| log-config | Der Protokollkonfigurationspfad | Zeichenfolge | "../kvs\_log\_configuration" | 
| max-latency | Die maximale Latenz für den Stream | Sekunden | 60 | 
| recalculate-metrics | Gibt an, ob die Metriken neu berechnet werden. | Boolesch | true | 
| replay-duration | Die Laufzeit, um die der aktuelle Reader bei Auftreten eines Fehlers "zurückgespult" werden muss, um die Wiedergabe zu wiederholen | Sekunden | 40 | 
| restart-on-error | Gibt an, ob beim Auftreten von Fehlern ein Neustart ausgeführt wird. | Boolesch | true | 
| retention-period | Die Zeitdauer, für die der Stream aufbewahrt wird | Stunden | 2 | 
| rotation-period | Der Schlüsselrotationszeitraum. Weitere Informationen finden Sie unter [ Rotierende AWS KMS Schlüssel. ](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html) | Sekunden | 3600 | 
| secret-key | Der AWS geheime Schlüssel, der für den Zugriff auf Kinesis Video Streams verwendet wird.<br />Sie müssen entweder AWS Anmeldeinformationen festgelegt haben oder diesen Parameter angeben.<pre>export AWS_SECRET_ACCESS_KEY=</pre> |  |  | 
| session-token | Gibt den erforderlichen Sitzungstoken-Wert an, wenn Sie temporäre Sicherheitsanmeldeinformationen direkt aus AWS STS Vorgängen verwenden. |  |  | 
| storage-size | Die Gerätespeichergröße in Mebibyte (MiB). Weitere Informationen zum Konfigurieren von Speichergeräten finden Sie unter [StorageInfo](producer-reference-structures-producer.md#producer-reference-structures-producer-storageinfo). | Mebibyte (MiB) | 128 | 
| streaming-type | Der Streaming-Typ. Gültige Werte sind: +  0: Echtzeit <br />+  1: nahezu in Echtzeit (derzeit nicht unterstützt) <br />+  2: offline  | Enum GstKvsSinkStreamingType | 0: Echtzeit | 
| timecode-scale | Die MKV-Timecode-Skala | Millisekunden | 1 | 
| track-name | Der Name des MKV-Tracks. | Zeichenfolge | "kinesis\_video" | 
| iot-certificate | AWS IoT Anmeldeinformationen, die im `kvssink` Element verwendet werden sollen. <br />`iot-certificate`akzeptiert die folgenden Schlüssel und Werte:  Das `iot-thing-name` ist ** optional**. Wenn nicht angegeben, `iot-thing-name` wird der `stream-name` Parameterwert verwendet. +  `endpoint`=`iotcredentialsproviderendpoint` <br />+  `cert-path`=`/localdirectorypath /to/certificate` <br />+  `key-path`=`/localdirectorypath /to/private/key` <br />+  `ca-path`=`/localdirectorypath/to/ca-cert` <br />+  `role-aliases`=`role-aliases` <br />+  `iot-thing-name`=`YourIotThingName`  | Zeichenfolge | Keine |