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.

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

Um Video an das C\+\+-SDK von Amazon Kinesis Video Streams Producer zu senden, geben Sie es `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: GStreamer SDK-Plug-In für Kinesis Video Streams Producer — kvssink](examples-gstreamer-plugin.md).

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

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

Damit das `kvssink` GStreamer Element Anfragen stellen kann AWS, müssen Sie AWS Anmeldeinformationen angeben, die es beim Aufrufen des Amazon Kinesis Video Streams Streams-Service verwenden soll. Die Anbieterkette für Anmeldeinformationen sucht in der folgenden Reihenfolge nach Anmeldeinformationen:

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

Informationen zum Einrichten von AWS IoT Anmeldeinformationen finden Sie unter[Steuern des Zugriffs auf Kinesis Video Streams Streams-Ressourcen mithilfe von 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 über TLS eine Vertrauensstellung mit dem Back-End-Dienst herzustellen.

**Example**  
**Beispiel**: ` /{{file}}/{{path}}/{{to}}/certificate.pem` | 
| cert-path | Ja | Dateipfad zum X.509-Zertifikat. 

**Example**  
**Beispiel**: `/{{file}}/{{path}}/{{to}}/{{certificateID}}-certificate.pem.crt` | 
| endpoint | Ja | Der Endpoint Provider-Endpunkt 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).

**Example**  
**Beispiel**: `{{credential-account-specific-prefix}}.credentials.iot.{{aws-region}}.amazonaws.com` | 
| key-path | Ja | Dateipfad zu dem privaten Schlüssel, der im public/private key pair verwendet wird. 

**Example**  
**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. 

**Example**  
**Beispiel**: `{{KvsCameraIoTRoleAlias}}` | 
| iot-thing-name | Nein | Die `iot-thing-name` ist optional. Wenn nicht angegeben, `iot-thing-name` wird der `stream-name` Parameterwert verwendet.

**Example**  
**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 Wert für das Sitzungstoken an, wenn Sie temporäre Sicherheitsanmeldeinformationen direkt aus AWS STS Vorgängen 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 future Sitzungen persistent zu machen, legen Sie sie im Startskript Ihrer Shell fest.

### 3. `access-key`, `secret-key` Parameter
<a name="collapsible-section-3"></a>

Um Anmeldeinformationen direkt als `kvssink` Parameter anzugeben, legen Sie die 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 Wert für das Sitzungstoken an, wenn Sie temporäre Sicherheitsanmeldeinformationen direkt aus AWS STS Vorgängen verwenden. | 

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

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

**Example**  
**Temporäre Anmeldeinformationen verwenden:**  

```
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 sie 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 future mindestens 5 \+ 30 \+ 3 = **38** Sekunden betragen. Die Kulanzzeit ist definiert als die `IOT_CREDENTIAL_FETCH_GRACE_PERIOD` Variable in [https://github.com/awslabs/amazon-kinesis-video-streams-producer-c/blob/master/src/source/Common/IotCredentialProvider.h](https://github.com/awslabs/amazon-kinesis-video-streams-producer-c/blob/master/src/source/Common/IotCredentialProvider.h). Wenn die Anmeldeinformationen beim Start zu kurz vor dem Ablauf liegen`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 Anmeldeinformationsdatei vor Ablauf der Ablaufzeit abzüglich der Kulanzzeit von einer externen Quelle aktualisiert werden. 

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

Die Reihenfolge der Suche nach Regionen ist wie folgt:

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 Kinesis-Ziel-Videostreams.  Wenn kein Streamname angegeben ist, wird der Standard-Streamname verwendet: „DEFAULT\_STREAM“. Falls 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 der Region auch die `AWS_DEFAULT_REGION` Umgebungsvariable zur Verfügung stellen. Die Umgebungsvariablen haben Vorrang, wenn sowohl die Umgebungsvariable als auch die Parameter kvssink gesetzt sind.  Die Region wird standardmäßig verwendet, `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 | Ob Fragment verwendet werden soll. ACKs | 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 Wert für das Sitzungstoken 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: [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | 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. [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | Zeichenfolge | Keine |