GStreamer 플러그인을 사용한 스트리밍 - Amazon Rekognition
1단계: Gstreamer 설치2단계: Kinesis Video Streams Producer 플러그인 설치 3단계: Kinesis Video Streams 플러그인을 사용하여 Gstreamer 실행

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GStreamer 플러그인을 사용한 스트리밍

Amazon Rekognition Video는 디바이스 카메라의 라이브 스트리밍 비디오를 분석할 수 있습니다. 디바이스 소스에서의 미디어 입력에 액세스하려면 GStreamer를 설치해야 합니다. GStreamer는 워크플로 파이프라인에서 미디어 소스와 처리 도구를 함께 연결하는 서드 파티 멀티미디어 프레임워크 소프트웨어입니다. Gstreamer용 Amazon Kinesis Video Streams Producer 플러그인도 설치해야 합니다. 이 프로세스에서는 Amazon Rekognition Video 및 Amazon Kinesis 리소스를 성공적으로 설정했다고 가정합니다. 자세한 정보는 Amazon Rekognition Video 및 Amazon Kinesis 리소스 설정을 참조하세요.

1단계: Gstreamer 설치

서드 파티 멀티미디어 플랫폼 소프트웨어인 Gstreamer를 다운로드하여 설치합니다. Homebrew(Gstreamer on Homebrew)와 같은 패키지 관리 소프트웨어를 사용하거나 Freedesktop 웹사이트에서 직접 다운로드할 수 있습니다.

명령줄 터미널의 테스트 소스로 비디오 피드를 실행하여 Gstreamer가 성공적으로 설치되었는지 확인하세요.

$ gst-launch-1.0 videotestsrc ! autovideosink

2단계: Kinesis Video Streams Producer 플러그인 설치

이 섹션에서는 Amazon Kinesis Video Streams Producer 라이브러리를 다운로드하고 Kinesis Video Streams Gstreamer 플러그인을 설치합니다.

디렉터리를 생성하고 GitHub 리포지토리에서 소스 코드를 복제합니다. --recursive 파라미터가 반드시 포함되어야 합니다.

$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git

라이브러리에서 제공하는 지침에 따라 프로젝트를 구성하고 빌드하세요. 운영 체제에 맞는 플랫폼별 명령을 사용해야 합니다. 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 <kinesis-video-support@amazon.com>
                
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 스트림에 대한 액세스 부여 중에 생성한 IAM 서비스 역할에 맞는 액세스 키와 리전을 사용해야 합니다. 액세스 키에 대한 자세한 내용은 IAM 사용 설명서의 IAM 사용자의 액세스 키 관리를 참조하세요. 또한 비디오 형식 인수 파라미터를 디바이스에서 사용 가능하다면 사용량에 따라 필요한 대로 조정할 수 있습니다.

$ 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 시작 명령 예제를 참조하세요.

참고

시작 명령이 비협상 오류로 종료되는 경우 디바이스 모니터의 출력값을 확인하고 videoconvert 파라미터 값이 디바이스의 설정에 유효한지 확인하세요.

몇 초 후에 Kinesis 비디오 스트림에서 디바이스 카메라의 비디오 피드를 볼 수 있습니다. Amazon Rekognition으로 얼굴 감지 및 일치를 시작하려면 Amazon Rekognition Video 스트림 프로세서를 시작하세요. 자세한 정보는 Amazon Rekognition Video 스트림 프로세서 작업 개요을 참조하세요.