기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GStreamer 요소 파라미터 레퍼런스
Amazon Kinesis Video Streams 프로듀서 C++ SDK로 비디오를 전송하려면 파이프라인의 싱크 또는 최종 목적지로 kvssink 지정합니다. 이 참조는 kvssink 필수 및 선택적 파라미터에 대한 정보를 제공합니다. 자세한 정보는 예: Kinesis Video Streams 프로듀서 SDK GStreamer 플러그인 - kvssink을 참조하세요.
주제
에 자격 증명을 제공하십시오. kvssink
kvssinkGStreamer 요소가 요청을 할 수 있도록 하려면 Amazon Kinesis Video Streams 서비스를 호출할 때 사용할 AWS 자격 증명을 제공하십시오. AWS자격 증명 공급자 체인은 다음과 같은 순서로 자격 증명을 찾습니다.
AWS IoT 자격 증명을 설정하려면 을 참조하십시오를 사용하여 Kinesis Video Streams 리소스에 대한 액세스 제어 AWS IoT.
iot-credentials매개변수 값은 다음 키 = 값 쌍의 쉼표로 구분된 목록으로 iot-certificate, 시작하고 뒤에 와야 합니다.
| 키 | 필수 | 설명 |
|---|---|---|
ca-path |
예 | TLS를 통해 백엔드 서비스와의 신뢰를 구축하는 데 사용되는 CA 인증서의 파일 경로입니다. 예: |
cert-path |
예 | X.509 인증서의 파일 경로. 예: |
endpoint |
예 | 계정의 AWS IoT Core 자격 증명 엔드포인트 공급자 엔드포인트. AWS 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 |
예 | 특정 형식의 자격 증명이 들어 있는 텍스트 파일의 경로입니다. |
텍스트 파일에는 다음 형식 중 하나의 자격 증명이 포함되어야 합니다.
-
자격 증명
YourAccessKeyYourSecretKey -
자격 증명
YourAccessKey만료YourSecretKeySessionToken
예: 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.hkvssink 때 자격 증명이 만료일에 너무 가까워지면 오류 코드가 나타납니다0x52000049 -
STATUS_INVALID_TOKEN_EXPIRATION.
중요
kvssink자격 증명 파일을 수정하지 않습니다. 임시 자격 증명을 사용하는 경우 만료 시간에서 유예 기간을 뺀 시간 전에 외부 소스에서 자격 증명 파일을 업데이트해야 합니다.
지역을 제공하십시오. kvssink
지역 조회 순서는 다음과 같습니다.
-
AWS_DEFAULT_REGION환경 변수를 먼저 검토합니다. 설정된 경우 해당 지역을 사용하여 클라이언트를 구성합니다. -
aws-region다음에서 매개변수를 검토합니다. 설정된 경우 해당 지역을 사용하여 클라이언트를 구성합니다. 이전 방법 중 어느 것도 사용하지 않은 경우
kvssink기본값은 입니다.us-west-2
kvssink선택적 파라미터
kvssink 요소에는 다음과 같은 선택적 파라미터가 있습니다. 이런 파라미터에 대한 자세한 내용은 Kinesis 비디오 스트림 구조 섹션을 참조하세요.
| 파라미터 | 설명 | 단위/유형 | 기본값 |
|---|---|---|---|
stream-name |
대상 아마존 Kinesis 비디오 스트림의 이름.중요스트림 이름을 지정하지 않은 경우 기본 스트림 이름인 “DEFAULT_STREAM”이 사용됩니다. 해당 기본 이름을 가진 스트림이 아직 없는 경우 스트림이 생성됩니다. |
|
|
absolute-fragment-times |
절대 조각 시간을 사용할지 여부입니다. | 불 | true |
access-key |
Kinesis Video Streams에 액세스하는 데 사용되는 액세스 키입니다. AWS AWS 자격 증명을 설정하거나 이 파라미터를 제공해야 합니다. 이 정보를 제공하려면 다음을 입력합니다.
|
||
avg-bandwidth-bps |
스트림용 예상 평균 대역폭. | 초당 비트 수 | 4194304 |
aws-region |
사용 AWS 리전 방법. 참고지역에 중요달리 지정하지 않을 |
String | "us-west-2" |
buffer-duration |
스트림 버퍼 지속 시간입니다. | 초 | 120 |
codec-id |
스트림의 코덱 ID입니다. | String | "V_MPEG4/ISO/AVC" |
connection-staleness |
스트림 비활성 콜백이 호출되는 시점 이후 시간입니다. | 초 | 60 |
content-type |
스트림의 콘텐츠 유형입니다. | String | "video/h264" |
fragment-acks |
조각 ACK를 사용할지 여부입니다. | 불 | true |
fragment-duration |
원하는 조각 지속 시간입니다. | 밀리초 | 2000 |
framerate |
예상 프레임 속도입니다. | 초당 프레임 | 25 |
frame-timecodes |
현재 시간 콜백을 사용하여 프레임 타임코드를 사용할지 타임스탬프를 생성할지 여부. | 불 | true |
key-frame-fragmentation |
키 프레임에서 조각을 생성할지 여부입니다. | 불 | true |
log-config |
로그 구성 경로입니다. | String | "../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 트랙 이름 | String | "kinesis_video" |
iot-certificate |
AWS IoT
참고
|
String | None |
