Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# GStreamer riferimento al parametro dell'elemento
Per inviare video all'SDK C\+\+ del produttore di Amazon Kinesis Video Streams, `kvssink` devi specificare *come sink o destinazione finale* della pipeline. La documentazione di riferimento fornisce informazioni sui parametri `kvssink` obbligatori e facoltativi. Per ulteriori informazioni, consulta [Esempio: plugin SDK per GStreamer produttori di Kinesis Video Streams - kvssink](examples-gstreamer-plugin.md).
**Argomenti**
+ [Fornisci le credenziali a `kvssink`](#credentials-to-kvssink)
+ [Fornisci una regione a `kvssink`](#kvssink-region)
+ [`kvssink`parametri opzionali](#kvssink-optional-parameters)
## Fornisci le credenziali a `kvssink`
Per consentire all'`kvssink` GStreamer elemento di effettuare richieste AWS, fornisci AWS le credenziali da utilizzare quando chiama il servizio Amazon Kinesis Video Streams. La catena di fornitori di credenziali cerca le credenziali nel seguente ordine:
### 1. AWS IoT credenziali
Per impostare AWS IoT le credenziali, vedere. [Controllo dell'accesso alle risorse Kinesis Video Streams tramite AWS IoT](how-iot.md)
Il valore del `iot-credentials` parametro deve iniziare con `iot-certificate,` ed essere seguito da un elenco separato da virgole delle seguenti coppie =. {{key}} {{value}}
****
| Chiave | Richiesto | Descrizione |
| --- | --- | --- |
| ca-path | Sì | Percorso del file del certificato CA utilizzato per stabilire la fiducia con il servizio di backend tramite TLS.
**Example**
**Esempio**: ` /{{file}}/{{path}}/{{to}}/certificate.pem` |
| cert-path | Sì | Percorso del file del certificato X.509.
**Example**
**Esempio**: `/{{file}}/{{path}}/{{to}}/{{certificateID}}-certificate.pem.crt` |
| endpoint | Sì | L'endpoint del provider di AWS IoT Core credenziali per il tuo account. AWS [Consulta la Guida per gli sviluppatori.AWS IoT](https://docs.aws.amazon.com//iot/latest/developerguide/authorizing-direct-aws.html)
**Example**
**Esempio**: `{{credential-account-specific-prefix}}.credentials.iot.{{aws-region}}.amazonaws.com` |
| key-path | Sì | Percorso del file della chiave privata utilizzata nella coppia di public/private chiavi.
**Example**
**Esempio**: `/{{file}}/{{path}}/{{to}}/{{certificateID}}-private.pem.key` |
| role-aliases | Sì | Il nome dell'alias del ruolo che punta al ruolo AWS IAM da utilizzare durante la connessione a. AWS IoT Core
**Example**
**Esempio**: `{{KvsCameraIoTRoleAlias}}` |
| iot-thing-name | No | Il `iot-thing-name` è facoltativo. Se non `iot-thing-name` viene fornito, viene `stream-name` utilizzato il valore del parametro.
**Example**
**Esempio**: `{{kvs_example_camera}}` |
**Example**
**Esempio**:
```
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. Variabili di ambiente
Per `kvssink` utilizzare le credenziali dell'ambiente, impostate le seguenti variabili di ambiente:
****
| Nome della variabile di ambiente | Richiesto | Descrizione |
| --- | --- | --- |
| AWS\_ACCESS\_KEY\_ID | Sì | La chiave di AWS accesso utilizzata per accedere ad Amazon Kinesis Video Streams. |
| AWS\_SECRET\_ACCESS\_KEY | Sì | La chiave AWS segreta associata alla chiave di accesso. |
| AWS\_SESSION\_TOKEN | No | Specifica il valore del token di sessione richiesto se si utilizzano credenziali di sicurezza temporanee direttamente dalle AWS STS operazioni. |
L'impostazione della variabile di ambiente modifica il valore utilizzato fino al termine della sessione della shell o finché non imposti la variabile su un valore diverso. Per rendere le variabili persistenti nelle sessioni future, impostale nello script di avvio della shell.
### 3. `access-key`, `secret-key` parametri
Per specificare le credenziali direttamente come `kvssink` parametro, impostate i seguenti parametri:
****
| `kvssink`Nome del parametro | Richiesto | Descrizione |
| --- | --- | --- |
| access-key | Sì | La chiave di AWS accesso utilizzata per accedere ad Amazon Kinesis Video Streams. |
| secret-key | Sì | La chiave AWS segreta associata alla chiave di accesso. |
| session-token | No | Specifica il valore del token di sessione richiesto se si utilizzano credenziali di sicurezza temporanee direttamente dalle AWS STS operazioni. |
**Example**
**Utilizzo di credenziali statiche:**
```
gst-launch-1.0 -v ... ! kvssink stream-name="{{YourStream}}" aws-region="{{YourRegion}}" access-key="{{AKIDEXAMPLE}}" secret-key="{{SKEXAMPLE}}"
```
**Example**
**Utilizzo di credenziali temporanee:**
```
gst-launch-1.0 -v ... ! kvssink stream-name="{{YourStream}}" aws-region="{{YourRegion}}" access-key="{{AKIDEXAMPLE}}" secret-key="{{SKEXAMPLE}}" session-token="{{STEXAMPLE}}"
```
### 4. File di credenziali
**Importante**
Se hai selezionato uno dei metodi precedenti, non puoi utilizzare il `credential-path` `kvssink` parametro.
****
| `kvssink`Nome del parametro | Richiesto | Descrizione |
| --- | --- | --- |
| credential-path | Sì | Percorso del file di testo contenente le credenziali in un formato specifico. |
Il file di testo deve contenere credenziali in uno dei seguenti formati:
+ CREDENZIALI {{YourAccessKey}} {{YourSecretKey}}
+ CREDENZIALI {{YourAccessKey}} {{Expiration}} {{YourSecretKey}} {{SessionToken}}
**Example**
**Esempio:** il `{{credentials}}.txt` file si trova in `/home/ubuntu` e contiene quanto segue:
`CREDENTIALS {{AKIDEXAMPLE 2023-08-10T22:43:00Z SKEXAMPLE STEXAMPLE}}`
Per utilizzarlo in`kvssink`, digita:
```
gst-launch-1.0 -v ... ! kvssink stream-name="{{YourStream}}" aws-region="{{YourRegion}}" credential-path="/home/ubuntu/{{credentials}}.txt"
```
Il tempo di scadenza dovrebbe essere di almeno 5 \+ 30 \+ 3 = **38** secondi nelle future. Il periodo di grazia è definito come la `IOT_CREDENTIAL_FETCH_GRACE_PERIOD` variabile 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). Se all'avvio le credenziali sono troppo vicine alla scadenza`kvssink`, viene visualizzato il codice di errore. `0x52000049 - STATUS_INVALID_TOKEN_EXPIRATION`
`kvssink`non modifica il file delle credenziali. Se utilizzi credenziali temporanee, il file delle credenziali deve essere aggiornato da una fonte esterna prima della scadenza, escluso il periodo di prova.
## Fornisci una regione a `kvssink`
Di seguito è riportato l'ordine di ricerca della regione:
1. `AWS_DEFAULT_REGION`la variabile di ambiente viene esaminata per prima. Se è impostata, quella regione viene utilizzata per configurare il client.
1. `aws-region`il parametro viene esaminato successivamente. Se è impostato, quella regione viene utilizzata per configurare il client.
1. Se non è stato utilizzato nessuno dei metodi precedenti, il `kvssink` valore predefinito è. `us-west-2`
## `kvssink`parametri opzionali
L'elemento `kvssink` ha i seguenti parametri opzionali. Per ulteriori informazioni su questi parametri, consultare [Strutture dei flussi video Kinesis](producer-reference-structures-stream.md).
****
| Parametro | Description | Unità/Tipo | Predefinita |
| --- | --- | --- | --- |
| stream-name | Il nome dello stream video Amazon Kinesis di destinazione. Se non viene specificato alcun nome di stream, verrà utilizzato il nome di stream predefinito: «DEFAULT\_STREAM». Se non esiste già uno stream con quel nome predefinito, verrà creato. | | |
| absolute-fragment-times | Per scegliere se usare i tempi assoluti del frammento. | Booleano | true |
| access-key | La chiave di AWS accesso utilizzata per accedere a Kinesis Video Streams.
È necessario impostare le AWS credenziali o fornire questo parametro. Per fornire queste informazioni, digitare quanto segue:export AWS_ACCESS_KEY_ID=
| | |
| avg-bandwidth-bps | La larghezza di banda media prevista del flusso. | Bit al secondo | 4194304 |
| aws-region | Il Regione AWS da usare. È inoltre possibile fornire alla regione la variabile di `AWS_DEFAULT_REGION` ambiente. Le variabili di ambiente hanno la precedenza se sono impostati sia la variabile di ambiente che i parametri kvssink. La regione verrà impostata di default `us-west-2` se non diversamente specificato. | Stringa | "us-west-2" |
| buffer-duration | Durata del buffer del flusso. | Secondi | 120 |
| codec-id | L'ID del codec del flusso. | Stringa | "V\_MPEG4/ISO/AVC" |
| connection-staleness | L'ora dopo la quale viene chiamato lo stream staleness callback. | Secondi | 60 |
| content-type | Il tipo di contenuto del flusso. | Stringa | "video/h264" |
| fragment-acks | Se usare il frammento. ACKs | Booleano | true |
| fragment-duration | La durata del frammento desiderata. | Millisecondi | 2000 |
| framerate | La frequenza fotogrammi prevista. | Fotogrammi al secondo | 25 |
| frame-timecodes | Per scegliere se utilizzare i timecode del fotogramma o generare timestamp tramite il callback dell'ora corrente. | Booleano | true |
| key-frame-fragmentation | Per scegliere se creare frammenti su un fotogramma chiave. | Booleano | true |
| log-config | Percorso di configurazione del log. | Stringa | "../kvs\_log\_configuration" |
| max-latency | La latenza massima del flusso. | Secondi | 60 |
| recalculate-metrics | Per scegliere se calcolare nuovamente i parametri. | Booleano | true |
| replay-duration | La durata per spostare all'indietro il lettore corrente per la riproduzione quando si verifica un errore se il riavvio è abilitato. | Secondi | 40 |
| restart-on-error | Per scegliere se riavviare quando si verifica un errore. | Booleano | true |
| retention-period | Il periodo di tempo in cui il flusso viene conservato. | Ore | 2 |
| rotation-period | Il periodo di rotazione delle chiavi. Per ulteriori informazioni, vedete [Rotating Keys. AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html) | Secondi | 3600 |
| secret-key | La chiave AWS segreta utilizzata per accedere a Kinesis Video Streams.
Devi avere AWS le credenziali impostate o fornire questo parametro.export AWS_SECRET_ACCESS_KEY=
| | |
| session-token | Specifica il valore del token di sessione richiesto se si utilizzano credenziali di sicurezza temporanee direttamente dalle operazioni. AWS STS | | |
| storage-size | La dimensione di archiviazione del dispositivo in mebibyte (MiB). Per informazioni sulla configurazione dello storage del dispositivo, consulta [StorageInfo](producer-reference-structures-producer.md#producer-reference-structures-producer-storageinfo). | Mebibyte (MiB) | 128 |
| streaming-type | Tipo di streaming. I valori validi includono: [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | Enum GstKvsSinkStreamingType | 0: tempo reale |
| timecode-scale | La dimensione del timecode MKV. | Millisecondi | 1 |
| track-name | Il nome della traccia MKV. | Stringa | "kinesis\_video" |
| iot-certificate | AWS IoT credenziali da utilizzare nell'`kvssink`elemento.
`iot-certificate`accetta le seguenti chiavi e valori: `iot-thing-name`è **facoltativo**. Se non `iot-thing-name` viene fornito, viene utilizzato il valore del `stream-name` parametro. [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | Stringa | Nessuno |