본문으로 건너뛰기

비디오 프레임 저장

정보

초기에 envision qr 카메라 정보를 구독하는 기능이 기본적으로 세팅되어 있습니다. 저장 구독 카메라를 추가하거나, 기존 카메라 설정을 변경하려면 아래 가이드를 참고하세요.

CoBiz는 로봇의 비디오 프레임을 실시간으로 수집하고 저장할 수 있는 기능을 제공합니다. 해당 기능을 이용하여 로봇의 작업을 트래킹하고, AI학습용 데이터셋으로 활용이 가능합니다.

비디오 프레임 저장은 receiver 컨테이너에서 이루어집니다. receiver 컨테이너는 로봇의 비디오 프레임을 수집하고 저장하는 역할을 수행합니다. 비디오 프레임 저장을 위해서는 receiver 컨테이너의 설정 파일을 수정해야 합니다.

설정 - config.yaml​

다음 명령을 통해 설정 파일을 수정할 수 있습니다.


$ sudo nano receiver/config/config.json

config 파일의 형식은 아래와 같습니다.

port: 5050

worker:
  enabled: true
  max-fps: 1

storage:
  type: fs
  get-url: https://lg.moth:3000/storage
  bucket: receiver_data

moth:
  server: moth
  port: 8286
  channel-type: static
  channel: envision
  track: colink

worker​

worker 항목에서는 비디오 프레임을 저장하는 작업 전략을 설정할 수 있습니다. 아래와 같은 옵션들이 제공됩니다.

  • enabled: 비디오 프레임 저장을 활성화할지 여부를 설정합니다. true로 설정하면 비디오 프레임 저장이 활성화됩니다.
  • max-fps: 비디오 프레임 저장의 최대 FPS를 설정합니다. 예를 들어 1로 설정하면 1초에 최대 1프레임씩 저장됩니다.
    • 미디어 서버로부터 수신되는 비디오 프레임의 FPS가 높은 경우, 이 값을 낮추어 저장할 프레임 수를 조절할 수 있습니다.
    • 반대로 미디어 서버로부터 수신되는 비디오 프레임의 FPS가 낮은 경우, 이 값을 높여도 저장할 프레임 수가 증가하지 않습니다.

moth​

CoBiz는 비디오 전송을 위해 Moth 서버를 사용합니다. moth 항목에서는 Moth 서버의 주소와 포트를 설정할 수 있습니다.

  • server: Moth 서버의 주소를 설정합니다.
  • port: Moth 서버의 포트를 설정합니다.
  • channel-type: 비디오를 구독할 Moth 서버의 채널 타입을 설정합니다.
  • channel: 비디오를 구독할 Moth 서버의 채널을 설정합니다. channel-type이 static인 경우, 채널 id를, dynamic인 경우 채널 이름을 설정합니다.
  • track: 비디오를 구독할 Moth 서버의 트랙을 설정합니다.

storage​

저장될 이미지들을 담기 위한 저장소 정보를 설정합니다.

  • type : 어떤 타입의 스토리지를 사용할지 결정합니다.
    • fs : 로컬 파일 시스템을 사용합니다. 설정하지 않으면 기본값으로 동작합니다.
    • minio : MinIO 서버를 사용합니다.
  • get-url : 이미지를 다운로드할 수 있는 URL을 설정합니다.
  • bucket : 저장될 이미지들을 담기 위한 최상위 디렉터리 이름을 설정합니다.

(Optional) minio​

CoBiz는 비디오 프레임을 저장하기 위해 MinIO를 사용할 수도 있습니다. minio 항목에서는 MinIO 서버의 주소와 포트, 그리고 인증 정보를 설정할 수 있습니다.

  • endpoint: MinIO 서버의 주소와 포트를 설정합니다. MinIO 서버가 minio 컨테이너로 실행되는 경우, minio:9000으로 설정합니다.
  • access-key: MinIO 서버의 사용자 ID를 설정합니다.
  • secret-key: MinIO 서버의 비밀번호를 설정합니다.
  • get-url: MinIO 서버로부터 비디오 프레임을 다운로드할 수 있는 URL을 설정합니다.
  • bucket: 비디오 프레임을 저장할 MinIO 버킷 이름을 설정합니다.
  • secure: MinIO 서버와의 통신을 암호화할지 여부를 설정합니다. docker 내부에서 통신하는 경우 false로 설정합니다.

실행​

설정 파일을 수정한 후, receiver 컨테이너를 실행합니다.

$ docker-compose up -d receiver

receiver 컨테이너가 정상적으로 실행되면, 비디오 프레임 저장이 시작됩니다. 저장된 비디오 프레임은 MinIO 서버의 버킷에 저장됩니다.

데이터 확인​

영상 프레임 수집 데이터들은 docker compose에서 마운트한 볼륨 폴더에서 이미지들을 확인할 수 있습니다. QR 촬영 이미지들은 로봇 관제 페이지 QR 데이터 확인 메뉴에서 확인할 수 있습니다.