翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
GStreamer 要素パラメータリファレンス
Amazon Kinesis Video Streams プロデューサー C++ SDK に動画を送信するには、シンク として、またはパイプラインの最終送信先kvssink
として を指定します。このリファレンスでは、kvssink
の必須およびオプションのパラメータに関する情報を提供します。詳細については、「例: Kinesis Video Streams プロデューサー SDK GStreamer プラグイン - kvssink」を参照してください。
トピック
認証情報を に提供する kvssink
kvssink
GStreamer 要素が にリクエストを実行できるようにするには AWS、Amazon Kinesis Video Streams サービスを呼び出すときに使用する AWS 認証情報を指定します。認証情報プロバイダーチェーンは、次の順序で認証情報を検索します。
AWS IoT 認証情報を設定するには、「」を参照してくださいを使用した Kinesis Video Streams リソースへのアクセスの制御 AWS IoT。
iot-credentials
パラメータ値は で始まり、次のキー
iot-certificate,
と値の
ペアのカンマ区切りリストが続く必要があります。
キー | 必要 | 説明 |
---|---|---|
ca-path |
あり | TLS 経由でバックエンドサービスとの信頼を確立するために使用される CA 証明書へのファイルパス。 例: |
cert-path |
あり | X.509 証明書へのファイルパス。 例: |
endpoint |
あり | AWS アカウントの AWS IoT Core 認証情報エンドポイントプロバイダーエンドポイント。「 AWS IoT デベロッパーガイド」を参照してください。 例: |
key-path |
あり | パブリック/プライベートキーペアで使用されるプライベートキーへのファイルパス。 例: |
role-aliases |
あり | への接続時に使用する AWS IAM ロールを指すロールエイリアスの名前 AWS IoT Core。 例: |
iot-thing-name |
なし |
例: |
例:
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
"
環境の認証情報kvssink
を使用するには、次の環境変数を設定します。
環境変数名 | 必要 | 説明 |
---|---|---|
AWS_ACCESS_KEY_ID |
あり | Amazon Kinesis Video Streams へのアクセスに使用されるアクセス AWS キー。 |
AWS_SECRET_ACCESS_KEY |
あり | アクセスキーに関連付けられた AWS シークレットキー。 |
AWS_SESSION_TOKEN |
なし | オペレーションから直接 AWS STS 一時的なセキュリティ認証情報を使用する場合に必要なセッショントークン値を指定します。 |
環境変数を設定すると使用する値が変更され、その値はシェルセッションが終了するか、または変数に別の値が設定されるまで有効です。以降のセッションで変数を永続化するには、シェルのスタートアップスクリプトで変数を設定します。
認証情報をkvssink
パラメータとして直接指定するには、次のパラメータを設定します。
kvssink パラメータ名 |
必要 | 説明 |
---|---|---|
access-key |
あり | Amazon Kinesis Video Streams へのアクセスに使用されるアクセス AWS キー。 |
secret-key |
あり | アクセスキーに関連付けられた AWS シークレットキー。 |
session-token |
なし | オペレーションから直接 AWS STS 一時的なセキュリティ認証情報を使用する場合に必要なセッショントークン値を指定します。 |
静的認証情報の使用:
gst-launch-1.0 -v ... ! kvssink stream-name="
YourStream
" aws-region="YourRegion
" access-key="AKIDEXAMPLE
" secret-key="SKEXAMPLE
"
一時的な認証情報の使用:
gst-launch-1.0 -v ... ! kvssink stream-name="
YourStream
" aws-region="YourRegion
" access-key="AKIDEXAMPLE
" secret-key="SKEXAMPLE
" session-token="STEXAMPLE
"
重要
前述の方法のいずれかを選択した場合、 credential-file
kvssink
パラメータは使用できません。
kvssink パラメータ名 |
必要 | 説明 |
---|---|---|
credential-file |
あり | 特定の形式の認証情報を含むテキストファイルへのパス。 |
テキストファイルには、次のいずれかの形式の認証情報が含まれている必要があります。
-
認証情報
YourAccessKey
YourSecretKey
-
認証情報
YourAccessKey
の有効期限
YourSecretKey
SessionToken
例:
ファイルは にありcredentials
.txt/home/ubuntu
、以下が含まれています。
CREDENTIALS
AKIDEXAMPLE 2023-08-10T22:43:00Z
SKEXAMPLE STEXAMPLE
で使用するにはkvssink
、次のように入力します。
gst-launch-1.0 -v ... ! kvssink stream-name="
YourStream
" aws-region="YourRegion
" credential-file="/home/ubuntu/credentials
.txt"
注記
有効期限は、少なくとも 5 + 30 + 3 = 38 秒先である必要があります。猶予期間は、 のIOT_CREDENTIAL_FETCH_GRACE_PERIOD
変数として定義されますIotCredentialProvider.h
kvssink
、エラーコード が表示されます0x52000049 - STATUS_INVALID_TOKEN_EXPIRATION
。
重要
kvssink
は認証情報ファイルを変更しません。一時的な認証情報を使用している場合は、有効期限から猶予期間を引いた時間より前に、外部ソースによって認証情報ファイルを更新する必要があります。
にリージョンを指定する kvssink
リージョンのルックアップ順序は次のとおりです。
-
AWS_DEFAULT_REGION
環境変数が最初にレビューされます。設定されている場合、そのリージョンを使用してクライアントを設定します。 -
aws-region
次に、 パラメータを確認します。設定されている場合、そのリージョンを使用してクライアントを設定します。 前述のいずれの方法も使用されなかった場合、 は
kvssink
デフォルトで になりますus-west-2
。
kvssink
オプションパラメータ
kvssink
エレメントには以下のオプションパラメータがあります。これらのパラメータの詳細については、「Kinesis ビデオストリーム構造」を参照してください。
パラメータ | 説明 | 単位/タイプ | デフォルト値 |
---|---|---|---|
stream-name |
送信先の Amazon Kinesis ビデオストリームの名前。重要stream-name を指定しない場合、デフォルトのストリーム名「DEFAULT_STREAM」が使用されます。そのデフォルト名のストリームがまだ存在しない場合は、ストリームが作成されます。 |
|
|
absolute-fragment-times |
絶対フラグメントタイムを使用するかどうか。 | ブール値 | true |
access-key |
Kinesis Video Streams へのアクセスに使用されるアクセス AWS キー。 AWS 認証情報が設定されているか、このパラメータを指定する必要があります。この情報を指定するには、次のように入力します。
|
||
avg-bandwidth-bps |
ストリームの予想される平均帯域幅。 | 毎秒ビット | 4194304 |
aws-region |
AWS リージョン 使用する 。 注記
重要特に指定 |
文字列 | "us-west-2" |
buffer-duration |
ストリームのバッファ期間。 | [秒] | 120 |
codec-id |
ストリームのコーデック ID。 | 文字列 | "V_MPEG4/ISO/AVC" |
connection-staleness |
ストリームの古いコールバックが呼び出されるまでの時間。 | [秒] | 60 |
content-type |
ストリームのコンテンツタイプ。 | 文字列 | "video/h264" |
fragment-acks |
ACK フラグメントを使用するかどうか。 | ブール値 | true |
fragment-duration |
フラグメントの有効期間。 | ミリ秒 | 2000 |
framerate |
予想されるフレームレート。 | 1 秒あたりのフレーム | 25 |
frame-timecodes |
フレームのタイムコードを使用するか、現在時刻のコールバックを使用してタイムスタンプを生成するかどうかを指定します。 | ブール値 | true |
key-frame-fragmentation |
キーフレームでフラグメントを生成するかどうかを指定します。 | ブール値 | true |
log-config |
ログ設定のパス。 | 文字列 | "../kvs_log_configuration" |
max-latency |
ストリームの最大レイテンシー。 | [秒] | 60 |
recalculate-metrics |
メトリクスを再計算するかどうかを指定します。 | ブール値 | true |
replay-duration |
再開が有効になっている場合、エラー発生時の再生まで現在のリーダーをロールバックする期間。 | [秒] | 40 |
restart-on-error |
エラーが発生したときに再起動するかどうか。 | ブール値 | true |
retention-period |
ストリームが保持される期間。 | 時間 | 2 |
rotation-period |
キーの更新間隔。詳細については、「キーのローテーション AWS KMS」を参照してください。 | [秒] | 3600 |
secret-key |
Kinesis Video Streams へのアクセスに使用されるシー AWS クレットキー。 AWS 認証情報が設定されているか、このパラメータを指定する必要があります。
|
||
session-token |
一時的なセキュリティ認証情報を オペレーションから直接 AWS STS 使用する場合に必要なセッショントークン値を指定します。 | ||
storage-size |
メビバイト (MiB) 単位のデバイスストレージサイズ。デバイスストレージの構成の詳細については、「StorageInfo」を参照してください。 | メビバイト (MiB) | 128 |
streaming-type |
ストリーミングタイプ。有効な値を次に示します。
|
列挙型 GstKvsSinkStreamingType |
0: リアルタイム |
timecode-scale |
MKV のタイムコードスケール。 | ミリ秒 | 1 |
track-name |
MKV トラック名。 | 文字列 | "kinesis_video" |
iot-certificate |
AWS IoT
注記
|
文字列 | なし |