Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
GStreamerreferensi parameter elemen
Untuk mengirim video ke SDK produsen Amazon Kinesis Video Streams C++, 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 produsen Kinesis Video SDK GStreamer Streams - kvssink.
Topik
Memberikan kredensi untuk kvssink
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:
Untuk mengatur AWS IoT kredensyal, lihat. Mengontrol akses ke sumber daya Kinesis Video Streams menggunakan AWS IoT
Nilai iot-credentials
parameter harus dimulai dengan iot-certificate,
dan diikuti oleh daftar dipisahkan koma berikut key
=value
pasangan.
Kunci | Wajib | Deskripsi |
---|---|---|
ca-path |
Ya | Jalur file ke sertifikat CA yang digunakan untuk membangun kepercayaan dengan layanan backend melalui. TLS Contoh: |
cert-path |
Ya | Jalur file ke sertifikat X.509. Contoh: |
endpoint |
Ya | Titik akhir penyedia titik akhir AWS IoT Core kredensi untuk akun Anda. AWS Lihat Panduan AWS IoT Pengembang. Contoh: |
key-path |
Ya | File path ke kunci pribadi yang digunakan dalam public/private key pair. Contoh: |
role-aliases |
Ya | Nama alias peran yang menunjuk ke AWS IAM peran yang akan digunakan saat menghubungkan ke. AWS IoT Core Contoh: |
iot-thing-name |
Tidak |
Contoh: |
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
"
Untuk memiliki kredensi kvssink
penggunaan dari lingkungan, atur variabel lingkungan berikut:
Nama Variabel Lingkungan | Wajib | Deskripsi |
---|---|---|
AWS_ACCESS_KEY_ID |
Ya | Kunci AWS akses yang digunakan untuk mengakses Amazon Kinesis Video Streams. |
AWS_SECRET_ACCESS_KEY |
Ya | Kunci AWS rahasia yang terkait dengan kunci akses. |
AWS_SESSION_TOKEN |
Tidak | Menentukan nilai token sesi yang diperlukan jika Anda menggunakan kredensil 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.
Untuk menentukan kredensil secara langsung sebagai kvssink
parameter, atur parameter berikut:
kvssink Nama Parameter |
Wajib | 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 kredensil keamanan sementara langsung dari operasi. AWS STS |
Menggunakan kredensyal statis:
gst-launch-1.0 -v ... ! kvssink stream-name="
YourStream
" aws-region="YourRegion
" access-key="AKIDEXAMPLE
" secret-key="SKEXAMPLE
"
Menggunakan kredensyal sementara:
gst-launch-1.0 -v ... ! kvssink stream-name="
YourStream
" aws-region="YourRegion
" access-key="AKIDEXAMPLE
" secret-key="SKEXAMPLE
" session-token="STEXAMPLE
"
penting
Jika Anda telah memilih salah satu metode sebelumnya, Anda tidak dapat menggunakan credential-file
kvssink
parameter.
kvssink Nama Parameter |
Wajib | Deskripsi |
---|---|---|
credential-file |
Ya | Path ke file teks yang berisi kredensyal dalam format tertentu. |
File teks harus berisi kredensyal dalam salah satu format berikut:
-
CREDENTIALS
YourAccessKey
YourSecretKey
-
CREDENTIALS
YourAccessKey
Expiration
YourSecretKey
SessionToken
Contoh:
File Anda terletak di credentials
.txt/home/ubuntu
dan berisi yang berikut:
CREDENTIALS
AKIDEXAMPLE 2023-08-10T22:43:00Z
SKEXAMPLE STEXAMPLE
Untuk menggunakannyakvssink
, ketik:
gst-launch-1.0 -v ... ! kvssink stream-name="
YourStream
" aws-region="YourRegion
" credential-file="/home/ubuntu/credentials
.txt"
catatan
Waktu kedaluwarsa harus setidaknya 5 + 30 + 3 = 38 detik di masa depan. Masa tenggang didefinisikan sebagai IOT_CREDENTIAL_FETCH_GRACE_PERIOD
variabel dalam IotCredentialProvider.h
kvssink
, Anda menerima kode kesalahan. 0x52000049 -
STATUS_INVALID_TOKEN_EXPIRATION
penting
kvssink
tidak memodifikasi file kredensyal. Jika Anda menggunakan kredensi sementara, file kredensil harus diperbarui oleh sumber luar sebelum waktu kedaluwarsa dikurangi masa tenggang.
Menyediakan wilayah untuk kvssink
Berikut ini adalah urutan pencarian wilayah:
-
AWS_DEFAULT_REGION
variabel lingkungan ditinjau terlebih dahulu. Jika diatur, wilayah itu digunakan untuk mengkonfigurasi klien. -
aws-region
parameter ditinjau selanjutnya. Jika diatur, wilayah itu digunakan untuk mengkonfigurasi klien. Jika tidak satu pun dari metode sebelumnya yang digunakan,
kvssink
defaultnya.us-west-2
kvssink
parameter opsional
kvssink
Elemen memiliki parameter opsional berikut. Untuk informasi selengkapnya tentang parameter ini, lihat Struktur aliran video Kinesis.
Parameter | Deskripsi | Unit/Jenis | Default |
---|---|---|---|
stream-name |
Nama streaming video Amazon Kinesis tujuan. pentingJika tidak ada nama aliran yang ditentukan, nama aliran default akan digunakan: “DEFAULT_STREAM”. 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, ketikkan berikut ini:
|
||
avg-bandwidth-bps |
Bandwidth rata-rata yang diharapkan untuk aliran. | Bit per detik | 4194304 |
aws-region |
Wilayah AWS Untuk digunakan. catatanAnda juga dapat menyediakan wilayah dengan variabel pentingWilayah akan default |
String | "us-west-2" |
buffer-duration |
Durasi buffer aliran. | Detik | 120 |
codec-id |
ID codec dari aliran. | String | "V_MPEG4/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_log_configuration" |
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. | 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.
|
||
session-token |
Menentukan nilai token sesi yang diperlukan jika Anda menggunakan kredensil keamanan sementara langsung dari operasi. AWS STS | ||
storage-size |
Ukuran penyimpanan perangkat dalam mebibyte (MiB). Untuk informasi tentang mengonfigurasi penyimpanan perangkat, lihatStorageInfo. | Megabyte (MiB) | 128 |
streaming-type |
Jenis streaming. Nilai yang valid meliputi:
|
Enum GstKvsSinkStreamingType |
0: waktu nyata |
timecode-scale |
MKVSkala kode waktu. | Milidetik | 1 |
track-name |
Nama MKV trek. | String | "kinesis_video" |
iot-certificate |
AWS IoT kredensyal yang akan digunakan dalam elemen.
catatan
|
String | Tidak ada |