기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# GStreamer 플러그인을 사용한 스트리밍
**참고**
Amazon Rekognition 스트리밍 비디오 분석은 2026년 4월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. 스트리밍 비디오 분석을 사용하려면 해당 날짜 이전에 가입하세요. 지난 12개월 동안이 기능을 사용한 계정의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. 자세한 내용은 [Rekognition Streaming Video Analysis 가용성 변경을](https://docs.aws.amazon.com/rekognition/latest/dg/rekognition-streaming-video-analysis-availability-change.html) 참조하세요.
Amazon Rekognition Video는 디바이스 카메라의 라이브 스트리밍 비디오를 분석할 수 있습니다. 디바이스 소스에서의 미디어 입력에 액세스하려면 GStreamer를 설치해야 합니다. GStreamer는 워크플로 파이프라인에서 미디어 소스와 처리 도구를 함께 연결하는 서드 파티 멀티미디어 프레임워크 소프트웨어입니다. Gstreamer용 [Amazon Kinesis Video Streams Producer 플러그인](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/)도 설치해야 합니다. 이 프로세스에서는 Amazon Rekognition Video 및 Amazon Kinesis 리소스를 성공적으로 설정했다고 가정합니다. 자세한 내용은 [Amazon Rekognition Video 및 Amazon Kinesis 리소스 설정](setting-up-your-amazon-rekognition-streaming-video-resources.md) 단원을 참조하십시오.
## 1단계: Gstreamer 설치
서드 파티 멀티미디어 플랫폼 소프트웨어인 Gstreamer를 다운로드하여 설치합니다. Homebrew([Gstreamer on Homebrew](https://formulae.brew.sh/formula/gstreamer))와 같은 패키지 관리 소프트웨어를 사용하거나 [Freedesktop 웹사이트](https://gstreamer.freedesktop.org/download/)에서 직접 다운로드할 수 있습니다.
명령줄 터미널의 테스트 소스로 비디오 피드를 실행하여 Gstreamer가 성공적으로 설치되었는지 확인하세요.
```
$ gst-launch-1.0 videotestsrc ! autovideosink
```
## 2단계: Kinesis Video Streams Producer 플러그인 설치
이 섹션에서는 [Amazon Kinesis Video Streams Producer 라이브러리](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/)를 다운로드하고 Kinesis Video Streams Gstreamer 플러그인을 설치합니다.
디렉터리를 생성하고 GitHub 리포지토리에서 소스 코드를 복제합니다. `--recursive` 파라미터가 반드시 포함되어야 합니다.
```
$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
```
[라이브러리에서 제공하는 지침](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/README.md)에 따라 프로젝트를 구성하고 빌드하세요. 운영 체제에 맞는 플랫폼별 명령을 사용해야 합니다. Kinesis Video Streams Gstreamer 플러그인 설치를 위해 `cmake`를 실행할 때 `-DBUILD_GSTREAMER_PLUGIN=ON` 파라미터를 사용하세요. 이 프로젝트에는 설치에 포함된 GCC 또는 Clang, Curl, Openssl 및 Log4cplus와 같은 추가 패키지가 필요합니다. 패키지 누락으로 인해 빌드가 실패하는 경우 해당 패키지가 설치되어 있고 PATH에 위치해 있는지 확인하세요. 빌드 중 "can't run C compiled program" 오류가 발생한 경우, 빌드 명령을 다시 실행하세요. 올바른 C 컴파일러를 찾을 수 없는 경우가 있습니다.
다음 명령을 실행하여 Kinesis Video Streams 플러그인의 설치를 확인하세요.
```
$ gst-inspect-1.0 kvssink
```
팩토리 및 플러그인 세부 정보와 같은 다음 정보가 표시되어야 합니다.
```
Factory Details:
Rank primary + 10 (266)
Long-name KVS Sink
Klass Sink/Video/Network
Description GStreamer AWS KVS plugin
Author AWS KVS
Plugin Details:
Name kvssink
Description GStreamer AWS KVS plugin
Filename /Users/YOUR_USER/amazon-kinesis-video-streams-producer-sdk-cpp/build/libgstkvssink.so
Version 1.0
License Proprietary
Source module kvssinkpackage
Binary package GStreamer
Origin URL http://gstreamer.net/
...
```
## 3단계: Kinesis Video Streams 플러그인을 사용하여 Gstreamer 실행
디바이스 카메라에서 Kinesis Video Streams로 스트리밍을 시작하기 전에 미디어 소스를 Kinesis Video Streams에 적합한 코덱으로 변환해야 할 수 있습니다. 현재 컴퓨터에 연결된 디바이스의 사양과 포맷 기능을 확인하려면 다음 명령을 실행하세요.
```
$ gst-device-monitor-1.0
```
스트리밍을 시작하려면 다음 샘플 명령을 사용하여 Gstreamer를 실행하고 보안 인증 정보 및 Amazon Kinesis Video Streams 정보를 추가합니다. [Amazon Rekognition에 Kinesis 스트림에 대한 액세스 부여](https://docs.aws.amazon.com/rekognition/latest/dg/api-streaming-video-roles.html#api-streaming-video-roles-all-stream) 중에 생성한 IAM 서비스 역할에 맞는 액세스 키와 리전을 사용해야 합니다. 액세스 키에 대한 자세한 내용은 *IAM 사용 설명서*의 [IAM 사용자의 액세스 키 관리](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)를 참조하세요. 또한 비디오 형식 인수 파라미터를 디바이스에서 사용 가능하다면 사용량에 따라 필요한 대로 조정할 수 있습니다.
```
$ gst-launch-1.0 autovideosrc device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 !
x264enc bframes=0 key-int-max=45 bitrate=500 ! video/x-h264,stream-format=avc,alignment=au,profile=baseline !
kvssink stream-name="YOUR_STREAM_NAME" storage-size=512 access-key="YOUR_ACCESS_KEY" secret-key="YOUR_SECRET_ACCESS_KEY" aws-region="YOUR_AWS_REGION"
```
시작 명령에 대한 자세한 내용은 [GStreamer 시작 명령 예제](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-gstreamer-plugin.html#examples-gstreamer-plugin-launch)를 참조하세요.
**참고**
시작 명령이 비협상 오류로 종료되는 경우 디바이스 모니터의 출력값을 확인하고 `videoconvert` 파라미터 값이 디바이스의 설정에 유효한지 확인하세요.
몇 초 후에 Kinesis 비디오 스트림에서 디바이스 카메라의 비디오 피드를 볼 수 있습니다. Amazon Rekognition으로 얼굴 감지 및 일치를 시작하려면 Amazon Rekognition Video 스트림 프로세서를 시작하세요. 자세한 내용은 [Amazon Rekognition Video 스트림 프로세서 작업 개요](streaming-video.md#using-rekognition-video-stream-processor) 단원을 참조하십시오.