View a markdown version of this page

Referensi parameter elemen GStreamer - Amazon Kinesis Video Streams
Berikan kredensi ke kvssinkBerikan wilayah ke kvssinkparameter opsional kvssink

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

Referensi parameter elemen GStreamer

Untuk mengirim video ke C++ SDK produsen Amazon Kinesis Video Streams, Anda tentukan kvssink 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 Streaming Video Kinesis - kvssink.

Topik

Berikan kredensi ke kvssink

Untuk mengiz kvssink inkan elemen GStreamer membuat permintaan ke AWS, berikan AWS kredenSIAL untuk digunakan saat memanggil layanan Amazon Kinesis Video Streams. RanTAI penyedia kredenSIAL mencari kredenSIAL dalam urutan sebagai berikut:

Untuk mengatur AWS IoT kredenSIAL, lihatMengontrol akses ke sumber daya Kinesis Video Streams menggunakan AWS IoT.

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

Key Diperlukan Deskripsi
ca-path Ya

Jalur file ke sertifikat CA digunakan untuk membangun kepercayaan dengan layanan backend melalui TLS.

contoh

Contoh: /file/path/to/certificate.pem
cert-path Ya

Jalur file ke X.509 sertifikat.

contoh

Contoh: /file/path/to/certificateID-certificate.pem.crt
endpoint Ya

Titik akhir penyedia titik akhir AWS IoT Core kredensi untuk AWS akun Anda. Lihat Panduan Peng AWS IoT embang.

contoh

Contoh: credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com
key-path Ya

Jalur file ke kunci pribadi yang digunakan dalam pasangan public/private kunci.

contoh

Contoh: /file/path/to/certificateID-private.pem.key
role-aliases Ya

Nama alias peran yang menunjuk ke peran AWS IAM untuk digunakan saat menghubungkan ke AWS IoT Core.

contoh

Contoh: KvsCameraIoTRoleAlias
iot-thing-name Tidak

Itu iot-thing-name opsional. Jika iot-thing-name tidak disediakan, nilai stream-name parameter digunakan.

contoh

Contoh: kvs_example_camera
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 kredenSIAL kvssink penggunaan dari lingkungan, atur variabel lingkungan berikut:

Nama Variabel Lingkungan Diperlukan Deskripsi
AWS_ACCESS_KEY_ID Ya K AWS unci akses yang digunakan untuk mengakses Amazon Kinesis Video Streams.
AWS_SECRET_ACCESS_KEY Ya K AWS unci rahasia yang terkait dengan kunci akses.
AWS_SESSION_TOKEN Tidak Menentukan nilai token sesi yang diperlukan jika Anda menggunakan kredentif keamanan sementara langsung dari AWS STS operasi.

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

Untuk menentukan kredenSIAL secara langsung sebagai kvssink parameter, atur parameter berikut:

kvssinkNama Parameter Diperlukan Deskripsi
access-key Ya K AWS unci akses yang digunakan untuk mengakses Amazon Kinesis Video Streams.
secret-key Ya K AWS unci rahasia yang terkait dengan kunci akses.
session-token Tidak Menentukan nilai token sesi yang diperlukan jika Anda menggunakan kredentif keamanan sementara langsung dari AWS STS operasi.
contoh

Menggunakan kredenSIAL statis: 

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

Menggunakan kredenSIAL 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-path kvssink parameter.

kvssinkNama Parameter Diperlukan Deskripsi
credential-path Ya Jalur ke file teks yang berisi kredenSIAL dalam format tertentu.

File teks harus berisi kredenSIAL dalam salah satu format berikut:

  • KREDENSIAL YourAccessKey YourSecretKey

  • KREDENSIAL YourAccessKey Expiration YourSecretKey SessionToken

contoh

Contoh: credentials.txt File Anda terletak di /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-path="/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 di IotCredentialProvider.h. Jika kredenSIAL terlalu dekat dengan kedaluwarsa saat Anda memulaikvssink, Anda menerima kode kesalahan0x52000049 - STATUS_INVALID_TOKEN_EXPIRATION.

penting

kvssinktidak mengubah file kredenSIAL. Jika Anda menggunakan kredenSIAL sementara, file kredenSIAL harus diperbarui oleh sumber luar sebelum waktu kedaluwarsa dikurangi masa tenggang.

Berikan wilayah ke kvssink

Berikut ini adalah urutan pencarian wilayah:

  1. AWS_DEFAULT_REGIONvariabel lingkungan ditinjau terlebih dahulu. Jika disetel, wilayah itu digunakan untuk mengkonfigurasi klien.

  2. aws-regionparameter ditinjau selanjutnya. Jika disetel, wilayah itu digunakan untuk mengkonfigurasi klien.

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

parameter opsional kvssink

kvssinkElemen memiliki parameter opsional berikut. Untuk informasi selengkapnya tentang parameter ini, lihat Struktur aliran video Kinesis.

Parameter Deskripsi Unit/Jenis Default
stream-name Nama tujuan streaming video Amazon Kinesis.
penting

Jika 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

K AWS unci akses yang digunakan untuk mengakses Kinesis Video Streams.

Anda harus memiliki AWS kredenSIAL yang ditetapkan atau memberikan parameter ini. Untuk memberikan informasi ini, ketik berikut ini:

export AWS_ACCESS_KEY_ID=
avg-bandwidth-bps Bandwidth rata-rata yang diharapkan untuk streaming. Bit per detik 4194304
aws-region

Wilayah AWS Untuk digunakan.

catatan

Anda juga dapat menyediakan wilayah dengan variabel AWS_DEFAULT_REGION lingkungan. Variabel lingkungan diutamakan jika variabel lingkungan dan parameter kvssink diatur.

penting

Wilayah akan default ke 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_MPEG4/ISO/AVC"
connection-staleness Waktu setelahnya, yang disebut panggilan balik arus staleness. Detik 60
content-type Jenis konten streaming. String "video/h264"
fragment-acks Apakah akan menggunakan ACK fragmen. 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 menghasilkan stempel waktu menggunakan panggilan balik 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 Mem utar AWS KMS Tombol. Detik 3600
secret-key

K AWS unci rahasia yang digunakan untuk mengakses Streams Video Kinesis.

Anda harus memiliki AWS kredenSIAL yang ditetapkan atau memberikan parameter ini.

export AWS_SECRET_ACCESS_KEY=
session-token Menentukan nilai token sesi yang diperlukan jika Anda menggunakan kredentif keamanan sementara langsung dari AWS STS operasi.
storage-size Ukuran penyimpanan perangkat dalam mebibyte (MiB). Untuk informasi tentang mengkonfigurasi penyimpanan perangkat, lihatStorageInfo. Mebibyte (MiB) 128
streaming-type Jenis streaming. Nilai yang valid meliputi:

  • 0: waktu nyata

  • 1: hampir waktu nyata (saat ini tidak didukung)

  • 2: offline

 Enum GstKvsSinkStreamingType 0: waktu nyata
timecode-scale Skala kode waktu MKV. Milidetik 1
track-name Nama trek MKV. String "kinesis_video"
iot-certificate

AWS IoT kredenSIAL yang akan digunakan dalam kvssink elemen.

iot-certificatemenerima kunci dan nilai berikut:

catatan

Itu iot-thing-name op sional. Jika iot-thing-name tidak disediakan, nilai stream-name parameter digunakan.

  • endpoint=iotcredentialsproviderendpoint

  • cert-path=/localdirectorypath /to/certificate

  • key-path=/localdirectorypath /to/private/key

  • ca-path=/localdirectorypath/to/ca-cert

  • role-aliases=role-aliases

  • iot-thing-name=YourIotThingName

 String Tidak ada