Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# GStreamer referensi parameter elemen
<a name="examples-gstreamer-plugin-parameters"></a>

Untuk mengirim video ke produsen Amazon Kinesis Video Streams C\$1\$1 SDK, `kvssink` Anda tentukan *sebagai* wastafel, atau tujuan akhir pipeline. Referensi ini memberikan informasi tentang parameter `kvssink` yang diperlukan dan opsional. Untuk informasi selengkapnya, lihat [Contoh: Plugin SDK GStreamer produsen Kinesis Video Streams - kvssink](examples-gstreamer-plugin.md).

**Topik**
+ [Memberikan kredensi untuk `kvssink`](#credentials-to-kvssink)
+ [Menyediakan wilayah untuk `kvssink`](#kvssink-region)
+ [`kvssink`parameter opsional](#kvssink-optional-parameters)

## Memberikan kredensi untuk `kvssink`
<a name="credentials-to-kvssink"></a>

Untuk mengizinkan `kvssink` GStreamer elemen membuat permintaan AWS, berikan AWS kredensialnya untuk digunakan saat memanggil layanan Amazon Kinesis Video Streams. Rantai penyedia kredensyal mencari kredensyal dengan urutan sebagai berikut:

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

Untuk mengatur AWS IoT kredensyal, lihat. [Mengontrol akses ke sumber daya Kinesis Video Streams menggunakan AWS IoT](how-iot.md)

Nilai `iot-credentials` parameter harus dimulai dengan `iot-certificate,` dan diikuti oleh daftar dipisahkan koma berikut *key* = *value* pasangan.


****  

| Key | Diperlukan | Deskripsi | 
| --- | --- | --- | 
| ca-path | Ya | Jalur file ke sertifikat CA yang digunakan untuk membangun kepercayaan dengan layanan backend melalui TLS. 

**Example**  
**Contoh:** ` /file/path/to/certificate.pem` | 
| cert-path | Ya | Jalur file ke sertifikat X.509.  

**Example**  
**Contoh:** `/file/path/to/certificateID-certificate.pem.crt` | 
| endpoint | Ya | Titik akhir penyedia titik akhir AWS IoT Core kredensyal untuk akun Anda. AWS Lihat [Panduan AWS IoT Pengembang](https://docs.aws.amazon.com//iot/latest/developerguide/authorizing-direct-aws.html). 

**Example**  
**Contoh:** `credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com` | 
| key-path | Ya | File path ke kunci pribadi yang digunakan dalam public/private key pair.  

**Example**  
**Contoh:** `/file/path/to/certificateID-private.pem.key` | 
| role-aliases | Ya | Nama alias peran yang menunjuk ke peran AWS IAM yang akan digunakan saat menghubungkan ke. AWS IoT Core 

**Example**  
**Contoh:** `KvsCameraIoTRoleAlias` | 
| iot-thing-name | Tidak | `iot-thing-name`Itu opsional. Jika `iot-thing-name` tidak disediakan, nilai `stream-name` parameter digunakan. 

**Example**  
**Contoh:** `kvs_example_camera` | 

**Example**  
**Contoh:**  

```
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. Variabel-variabel lingkungan
<a name="collapsible-section-2"></a>

Untuk memiliki kredensyal `kvssink` penggunaan dari lingkungan, atur variabel lingkungan berikut:


****  

| Nama Variabel Lingkungan | Diperlukan | Deskripsi | 
| --- | --- | --- | 
| AWS\$1ACCESS\$1KEY\$1ID | Ya | Kunci AWS akses yang digunakan untuk mengakses Amazon Kinesis Video Streams. | 
| AWS\$1SECRET\$1ACCESS\$1KEY | Ya | Kunci AWS rahasia yang terkait dengan kunci akses. | 
| AWS\$1SESSION\$1TOKEN | Tidak | Menentukan nilai token sesi yang diperlukan jika Anda menggunakan kredensyal keamanan sementara langsung dari operasi. AWS STS  | 

Menyetel variabel lingkungan mengubah nilai yang digunakan hingga akhir sesi shell Anda, atau sampai Anda menyetel variabel ke nilai yang berbeda. Untuk membuat variabel persisten di seluruh sesi future, atur di skrip startup shell Anda.

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

Untuk menentukan kredensyal secara langsung sebagai `kvssink` parameter, atur parameter berikut:


****  

| `kvssink`Nama Parameter | Diperlukan | Deskripsi | 
| --- | --- | --- | 
| access-key | Ya | Kunci AWS akses yang digunakan untuk mengakses Amazon Kinesis Video Streams. | 
| secret-key | Ya | Kunci AWS rahasia yang terkait dengan kunci akses. | 
| session-token | Tidak | Menentukan nilai token sesi yang diperlukan jika Anda menggunakan kredensyal keamanan sementara langsung dari operasi. AWS STS  | 

**Example**  
**Menggunakan kredensyal statis:**  

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

**Example**  
**Menggunakan kredensyal sementara:**  

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

### 4. File kredensi
<a name="collapsible-section-4"></a>

**penting**  
Jika Anda telah memilih salah satu metode sebelumnya, Anda tidak dapat menggunakan `credential-path` `kvssink` parameter.


****  

| `kvssink`Nama Parameter | Diperlukan | Deskripsi | 
| --- | --- | --- | 
| credential-path | Ya | Path ke file teks yang berisi kredensyal dalam format tertentu. | 

File teks harus berisi kredensyal dalam salah satu format berikut:
+ KREDENSIAL *YourAccessKey* *YourSecretKey*
+ KREDENSIAL *YourAccessKey* *Expiration* *YourSecretKey* *SessionToken*

**Example**  
**Contoh:** `credentials.txt` File Anda terletak di `/home/ubuntu` dan berisi yang berikut:   
`CREDENTIALS AKIDEXAMPLE 2023-08-10T22:43:00Z SKEXAMPLE STEXAMPLE`  
Untuk menggunakannya`kvssink`, ketik:   

```
gst-launch-1.0 -v ... ! kvssink stream-name="YourStream" aws-region="YourRegion" credential-path="/home/ubuntu/credentials.txt" 
```
Waktu kedaluwarsa harus setidaknya 5 \$1 30 \$1 3 = **38** detik di masa depan. Masa tenggang didefinisikan sebagai `IOT_CREDENTIAL_FETCH_GRACE_PERIOD` variabel dalam [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). Jika kredensyal terlalu dekat dengan kedaluwarsa saat Anda mulai`kvssink`, Anda menerima kode kesalahan. `0x52000049 - STATUS_INVALID_TOKEN_EXPIRATION`
`kvssink`tidak memodifikasi file kredensyal. Jika Anda menggunakan kredensi sementara, file kredensional harus diperbarui oleh sumber luar sebelum waktu kedaluwarsa dikurangi masa tenggang. 

## Menyediakan wilayah untuk `kvssink`
<a name="kvssink-region"></a>

Berikut ini adalah urutan pencarian wilayah:

1. `AWS_DEFAULT_REGION`variabel lingkungan ditinjau terlebih dahulu. Jika diatur, wilayah itu digunakan untuk mengkonfigurasi klien.

1. `aws-region`parameter ditinjau selanjutnya. Jika diatur, wilayah itu digunakan untuk mengkonfigurasi klien.

1. Jika tidak satu pun dari metode sebelumnya yang digunakan, `kvssink` defaultnya. `us-west-2` 

## `kvssink`parameter opsional
<a name="kvssink-optional-parameters"></a>

`kvssink`Elemen memiliki parameter opsional berikut. Untuk informasi selengkapnya tentang parameter ini, lihat [Struktur aliran video Kinesis](producer-reference-structures-stream.md).


****  

| Parameter | Deskripsi | Unit/Jenis | Default | 
| --- | --- | --- | --- | 
| stream-name  | Nama streaming video Amazon Kinesis tujuan.  Jika tidak ada nama aliran yang ditentukan, nama aliran default akan digunakan: “DEFAULT\$1STREAM”. Jika aliran dengan nama default itu belum ada, itu akan dibuat.  |  |  | 
| absolute-fragment-times | Apakah akan menggunakan waktu fragmen absolut. | Boolean | true | 
| access-key | Kunci AWS akses yang digunakan untuk mengakses Kinesis Video Streams.  Anda harus memiliki AWS kredensyal yang ditetapkan atau memberikan parameter ini. Untuk memberikan informasi ini, ketik yang berikut ini: <pre>export AWS_ACCESS_KEY_ID=</pre> |  |  | 
| avg-bandwidth-bps | Bandwidth rata-rata yang diharapkan untuk aliran.  | Bit per detik | 4194304 | 
| aws-region |  Wilayah AWS Untuk digunakan.  Anda juga dapat menyediakan wilayah dengan variabel `AWS_DEFAULT_REGION` lingkungan. Variabel lingkungan diutamakan jika variabel lingkungan dan parameter kvssink disetel.   Wilayah akan default `us-west-2` jika tidak ditentukan lain.   | String | "us-west-2" | 
| buffer-duration | Durasi buffer aliran.  | Detik | 120 | 
| codec-id | ID codec dari aliran. | String | "V\$1MPEG4/ISO/AVC" | 
| connection-staleness | Waktu setelahnya, di mana panggilan balik staleness aliran dipanggil. | Detik | 60 | 
| content-type | Jenis konten aliran. | String | "video/h264" | 
| fragment-acks | Apakah akan menggunakan fragmen. ACKs | Boolean | true | 
| fragment-duration | Durasi fragmen yang Anda inginkan. | Milidetik | 2000 | 
| framerate | Frame rate yang diharapkan. | Bingkai per detik | 25 | 
| frame-timecodes | Apakah akan menggunakan kode waktu bingkai atau membuat stempel waktu menggunakan callback waktu saat ini.  | Boolean | true | 
| key-frame-fragmentation | Apakah akan menghasilkan fragmen pada bingkai kunci. | Boolean | true | 
| log-config | Jalur konfigurasi log. | String | "../kvs\$1log\$1configuration" | 
| max-latency | Latensi maksimum untuk streaming. | Detik | 60 | 
| recalculate-metrics | Apakah akan menghitung ulang metrik. | Boolean | true | 
| replay-duration | Durasi untuk memutar pembaca saat ini ke belakang untuk memutar ulang selama kesalahan jika restart diaktifkan. | Detik | 40 | 
| restart-on-error | Apakah akan memulai ulang ketika terjadi kesalahan. | Boolean | true | 
| retention-period | Lamanya waktu aliran dipertahankan. | Jam | 2 | 
| rotation-period | Periode rotasi kunci. Untuk informasi selengkapnya, lihat [Rotating AWS KMS Keys](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html). | Detik | 3600 | 
| secret-key |  Kunci AWS rahasia yang digunakan untuk mengakses Kinesis Video Streams. Anda harus memiliki AWS kredensyal yang ditetapkan atau memberikan parameter ini. <pre>export AWS_SECRET_ACCESS_KEY=</pre>  |  |  | 
| session-token | Menentukan nilai token sesi yang diperlukan jika Anda menggunakan kredensyal keamanan sementara langsung dari operasi. AWS STS  |  |  | 
| storage-size | Ukuran penyimpanan perangkat dalam mebibyte (MiB). Untuk informasi tentang mengonfigurasi penyimpanan perangkat, lihat[StorageInfo](producer-reference-structures-producer.md#producer-reference-structures-producer-storageinfo). | Megabyte (MiB) | 128 | 
| streaming-type | Jenis streaming. Nilai yang valid meliputi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | Enum GstKvsSinkStreamingType | 0: waktu nyata | 
| timecode-scale | Skala kode waktu MKV. | Milidetik | 1 | 
| track-name | Nama trek MKV. | String | "kinesis\$1video" | 
| iot-certificate | AWS IoT kredensyal yang akan digunakan dalam elemen. `kvssink`  `iot-certificate`menerima kunci dan nilai berikut:   `iot-thing-name`Itu **opsional**. Jika `iot-thing-name` tidak disediakan, nilai `stream-name` parameter digunakan.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | String | Tidak ada |