기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # GStreamer 요소 파라미터 참조 Amazon Kinesis Video Streams 생산자 C\$1\$1 SDK로 비디오를 보내려면 파이프라인의 *싱크* 또는 최종 대상으로 `kvssink`를 지정합니다. 이 참조는 `kvssink` 필수 및 선택적 파라미터에 대한 정보를 제공합니다. 자세한 내용은 [예: Kinesis Video Streams 생산자 SDK GStreamer 플러그인 - kvssink](examples-gstreamer-plugin.md) 단원을 참조하십시오. **주제** + [에 자격 증명 제공 `kvssink`](#credentials-to-kvssink) + [에 리전 제공 `kvssink`](#kvssink-region) + [`kvssink` 선택적 파라미터](#kvssink-optional-parameters) ## 에 자격 증명 제공 `kvssink` `kvssink` GStreamer 요소가 요청을 하도록 허용하려면 Amazon Kinesis Video Streams 서비스를 호출할 때 사용할 자격 AWS 증명을 AWS제공합니다. 자격 증명 공급자 체인은 다음 순서로 자격 증명을 찾습니다. ### 1. AWS IoT 자격 증명 AWS IoT 자격 증명을 설정하려면 섹션을 참조하세요[를 사용하여 Kinesis Video Streams 리소스에 대한 액세스 제어 AWS IoT](how-iot.md). `iot-credentials` 파라미터 값은 로 시작하고 다음 *키*=*값* 페어의 쉼표로 구분된 목록 뒤에 `iot-certificate,` 와야 합니다. **** | Key(키) | 필수 | 설명 | | --- | --- | --- | | ca-path | 예 | TLS를 통해 백엔드 서비스와 신뢰를 구축하는 데 사용되는 CA 인증서의 파일 경로입니다. **Example** **예**: ` /file/path/to/certificate.pem` | | cert-path | 예 | X.509 인증서의 파일 경로입니다. **Example** **예**: `/file/path/to/certificateID-certificate.pem.crt` | | endpoint | 예 | AWS 계정의 AWS IoT Core 자격 증명 엔드포인트 공급자 엔드포인트입니다. [AWS IoT 개발자 안내서](https://docs.aws.amazon.com//iot/latest/developerguide/authorizing-direct-aws.html)를 참조하세요. **Example** **예**: `credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com` | | key-path | 예 | 퍼블릭/프라이빗 키 페어에 사용되는 프라이빗 키의 파일 경로입니다. **Example** **예**: `/file/path/to/certificateID-private.pem.key` | | role-aliases | 예 | 에 연결할 때 사용할 AWS IAM 역할을 가리키는 역할 별칭의 이름입니다 AWS IoT Core. **Example** **예**: `KvsCameraIoTRoleAlias` | | iot-thing-name | 아니요 | `iot-thing-name`은 선택 사항입니다. `iot-thing-name`이 제공되지 않으면 `stream-name` 파라미터 값이 사용됩니다. **Example** **예**: `kvs_example_camera` | **Example** **예:** ``` 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. 환경 변수 환경에서 자격 증명을 `kvssink` 사용하도록 하려면 다음 환경 변수를 설정합니다. **** | 환경 변수 이름 | 필수 | 설명 | | --- | --- | --- | | AWS\$1ACCESS\$1KEY\$1ID | 예 | Amazon Kinesis Video Streams에 AWS 액세스하는 데 사용되는 액세스 키입니다. | | AWS\$1SECRET\$1ACCESS\$1KEY | 예 | 액세스 키와 연결된 AWS 보안 키입니다. | | AWS\$1SESSION\$1TOKEN | 아니요 | 작업에서 AWS STS 직접 임시 보안 자격 증명을 사용하는 경우 필요한 세션 토큰 값을 지정합니다. | 환경 변수를 설정하면 사용되는 값이 변경되어 쉘 세션이 종료될 때까지 또는 변수를 다른 값으로 설정할 때까지 유지됩니다. 향후 세션에서 변수를 영구화하려면 셸의 시작 스크립트에서 변수를 설정합니다. ### 3. `access-key`, `secret-key` 파라미터 자격 증명을 `kvssink` 파라미터로 직접 지정하려면 다음 파라미터를 설정합니다. **** | `kvssink` 파라미터 이름 | 필수 | 설명 | | --- | --- | --- | | access-key | 예 | Amazon Kinesis Video Streams에 AWS 액세스하는 데 사용되는 액세스 키입니다. | | secret-key | 예 | 액세스 키와 연결된 AWS 보안 키입니다. | | session-token | 아니요 | 작업에서 AWS STS 직접 임시 보안 자격 증명을 사용하는 경우 필요한 세션 토큰 값을 지정합니다. | **Example** **정적 자격 증명 사용:** ``` gst-launch-1.0 -v ... ! kvssink stream-name="YourStream" aws-region="YourRegion" access-key="AKIDEXAMPLE" secret-key="SKEXAMPLE" ``` **Example** **임시 자격 증명 사용:** ``` gst-launch-1.0 -v ... ! kvssink stream-name="YourStream" aws-region="YourRegion" access-key="AKIDEXAMPLE" secret-key="SKEXAMPLE" session-token="STEXAMPLE" ``` ### 4. 자격 증명 파일 **중요** 이전 방법 중 하나를 선택한 경우 `credential-path` `kvssink` 파라미터를 사용할 수 없습니다. **** | `kvssink` 파라미터 이름 | 필수 | 설명 | | --- | --- | --- | | credential-path | 예 | 특정 형식의 자격 증명이 포함된 텍스트 파일의 경로입니다. | 텍스트 파일에는 다음 형식 중 하나의 자격 증명이 포함되어야 합니다. + CREDENTIALS *YourAccessKey* *YourSecretKey* + CREDENTIALS *YourAccessKey* *만료* *YourSecretKey* *SessionToken* **Example** **예:** `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-path="/home/ubuntu/credentials.txt" ``` 만료 시간은 향후 최소 5 \$1 30 \$1 3 = **38**초여야 합니다. 유예 기간은에서 `IOT_CREDENTIAL_FETCH_GRACE_PERIOD` 변수로 정의됩니다[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). 를 시작할 때 자격 증명이 만료에 너무 가까우면 오류 코드가 `kvssink`표시됩니다`0x52000049 - STATUS_INVALID_TOKEN_EXPIRATION`. `kvssink`는 자격 증명 파일을 수정하지 않습니다. 임시 자격 증명을 사용하는 경우 만료 시간에서 유예 기간을 빼기 전에 외부 소스에서 자격 증명 파일을 업데이트해야 합니다. ## 에 리전 제공 `kvssink` 다음은 리전 조회 순서입니다. 1. `AWS_DEFAULT_REGION` 환경 변수를 먼저 검토합니다. 설정된 경우 해당 리전을 사용하여 클라이언트를 구성합니다. 1. `aws-region` 파라미터는 다음에 검토됩니다. 설정된 경우 해당 리전을 사용하여 클라이언트를 구성합니다. 1. 이전 메서드를 모두 사용하지 않은 경우 `kvssink` 기본값은 입니다`us-west-2`. ## `kvssink` 선택적 파라미터 `kvssink` 요소에는 다음과 같은 선택적 파라미터가 있습니다. 이런 파라미터에 대한 자세한 내용은 [Kinesis 비디오 스트림 구조](producer-reference-structures-stream.md) 섹션을 참조하세요. **** | 파라미터 | 설명 | 단위/유형 | 기본값 | | --- | --- | --- | --- | | stream-name | 대상 Amazon Kinesis 비디오 스트림의 이름입니다. stream-name을 지정하지 않으면 기본 스트림 이름인 “DEFAULT\$1STREAM”이 사용됩니다. 해당 기본 이름의 스트림이 아직 없는 경우 스트림이 생성됩니다. | | | | absolute-fragment-times | 절대 조각 시간을 사용할지 여부입니다. | 부울 | true | | access-key | Kinesis Video Streams에 AWS 액세스하는 데 사용되는 액세스 키입니다. AWS 자격 증명이 설정되어 있거나이 파라미터를 제공해야 합니다. 이 정보를 제공하려면 다음을 입력합니다. 
export AWS_ACCESS_KEY_ID=
| | | | avg-bandwidth-bps | 스트림용 예상 평균 대역폭. | 초당 비트 수 | 4194304 | | aws-region | 사용할 AWS 리전 입니다. 리전에 `AWS_DEFAULT_REGION` 환경 변수를 제공할 수도 있습니다. 환경 변수와 kvssink 파라미터가 모두 설정된 경우 환경 변수가 우선합니다. 달리 지정`us-west-2`하지 않으면 리전은 기본적으로 로 설정됩니다. | 문자열 | "us-west-2" | | buffer-duration | 스트림 버퍼 지속 시간입니다. | 초 | 120 | | codec-id | 스트림의 코덱 ID입니다. | 문자열 | "V\$1MPEG4/ISO/AVC" | | connection-staleness | 스트림 기한 경과 콜백이 호출되는 시간입니다. | 초 | 60 | | content-type | 스트림의 콘텐츠 유형입니다. | 문자열 | "video/h264" | | fragment-acks | 조각 ACK를 사용할지 여부입니다. | 부울 | true | | fragment-duration | 원하는 조각 지속 시간입니다. | 밀리초 | 2000 | | framerate | 예상 프레임 속도입니다. | 초당 프레임 | 25 | | frame-timecodes | 현재 시간 콜백을 사용하여 프레임 타임코드를 사용할지 타임스탬프를 생성할지 여부. | 부울 | true | | key-frame-fragmentation | 키 프레임에서 조각을 생성할지 여부입니다. | 부울 | true | | log-config | 로그 구성 경로입니다. | 문자열 | "../kvs\$1log\$1configuration" | | max-latency | 스트림의 최대 지연 시간입니다. | 초 | 60 | | recalculate-metrics | 지표를 다시 계산할지 여부입니다. | 부울 | true | | replay-duration | 다시 시작이 활성화된 경우 오류가 발생한 동안 현재 리더를 뒤로 롤하여 다시 재생하는 기간입니다. | 초 | 40 | | restart-on-error | 오류 발생 시 다시 시작할지 여부입니다. | 부울 | true | | retention-period | 스트림이 보존되는 시간의 길이입니다. | 시간 | 2 | | rotation-period | 키 교체 기간입니다. 자세한 내용은 [키 교체 AWS KMS 를 참조하세요](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html). | 초 | 3600 | | secret-key | Kinesis Video Streams에 액세스하는 데 사용되는 AWS 보안 키입니다. AWS 자격 증명이 설정되어 있거나이 파라미터를 제공해야 합니다. 
export AWS_SECRET_ACCESS_KEY=
| | | | session-token | 작업에서 AWS STS 직접 임시 보안 자격 증명을 사용하는 경우 필요한 세션 토큰 값을 지정합니다. | | | | storage-size | 메비바이트(MiB) 단위의 디바이스 스토리지 크기입니다. 디바이스 스토리지 구성에 대한 자세한 내용은 [StorageInfo](producer-reference-structures-producer.md#producer-reference-structures-producer-storageinfo) 단원을 참조하십시오. | 메비바이트(MiB) | 128 | | streaming-type | 스트리밍 유형입니다. 유효한 값으로는 다음이 포함됩니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | 열거형 GstKvsSinkStreamingType | 0: 실시간 | | timecode-scale | MKV 타임코드 척도입니다. | 밀리초 | 1 | | track-name | MKV 트랙 이름 | 문자열 | "kinesis\$1video" | | iot-certificate | AWS IoT `kvssink` 요소에 사용할 자격 증명입니다. `iot-certificate`는 다음 키와 값을 허용합니다. 는 **선택 사항**`iot-thing-name`입니다. `iot-thing-name`이 제공되지 않으면 `stream-name` 파라미터 값이 사용됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | 문자열 | 없음 |