GoCam 카메라 서비스
GoCam은 FLYOS-FAST v1.4.0 베타 버전에 새로 추가된 카메라 서비스로, UVC 프로토콜을 지원하는 드라이버 없는 USB 카메라에 적합합니다. 실시간 비디오 스트림, 단일 프레임 스냅샷 및 카메라 매개변수 관리 페이지를 제공할 수 있습니다.
GoCam은 현재 FLYOS-FAST v1.4.0 베타 버전 이미지에서만 확인되었습니다. v1.3.10 정식 버전 및 GoCam이 포함되지 않은 플랫폼 이미지에서는 계속 Crowsnest를 사용하십시오.
GoCam 활성화
GoCam과 Crowsnest는 둘 중 하나만 선택하여 사용해야 합니다. 두 항목이 모두 1로 설정된 경우 시스템은 Crowsnest를 우선적으로 시작하며 GoCam은 적용되지 않습니다.
FlyOS-Conf/config.txt에서 설정:
crowsnest=0
gocam=1
저장 후 상위 컴퓨터를 재시작합니다. 설정 파일 수정 방법은 FLYOS-FAST 시스템 설정 가이드를 참조하십시오.
카메라를 처음 연결하거나 교체하기 전에 프린터를 완전히 종료하고 전원 공급을 차단하십시오. 전원이 켜진 상태에서 카메라 배선을 삽입/제거하거나 인터페이스를 정리하지 마십시오.
UVC를 지원하는 드라이버 없는 USB 카메라를 상위 컴퓨터의 USB 인터페이스에 연결한 후 다시 전원을 켭니다.
GoCam 관리 페이지 열기
GoCam은 기본적으로 8080 포트를 사용합니다. 상위 컴퓨터와 동일한 로컬 네트워크에서 접속:
http://장치IP:8080
관리 페이지는 다음 기능을 제공합니다:
- 카메라 화면 실시간 보기
- 카메라가 지원하는 형식, 해상도 및 프레임 속도 확인
- 비디오 스트림 및 스냅샷 주소 복사
- 카메라가 실제로 지원하는 UVC 매개변수 조정
카메라마다 노출되는 매개변수는 다르며, 페이지에는 현재 카메라가 지원하고 수정 가능한 항목만 표시됩니다. 예: 밝기, 전원 주파수, 초점 또는 노출. 매개변수를 조정하면 즉시 카메라에 적용됩니다. 효과를 확인한 후 Save to config를 클릭해야 서비스 재시작 후에도 해당 설정이 유지됩니다.
비디오 스트림 및 스냅샷 주소
| 용도 | 권장 주소 |
|---|---|
| 실시간 비디오 스트림 | http://장치IP:8080/?action=stream |
| 단일 프레임 스냅샷 | http://장치IP:8080/snapshot |
| 상위 컴퓨터 로컬 스냅샷 | http://localhost:8080/snapshot |
GoCam은 /stream, /?action=snapshot 및 /webcam/?action=... 주소도 호환합니다. 새 설정은 위 표의 주소를 우선적으로 사용하여 다른 카메라 서비스의 경로를 그대로 사용함으로써 발생하는 플러그인 호환성 문제를 피하십시오.
지연 촬영 설정
GoCam 모드에서 moonraker.conf의 지연 촬영 스냅샷 주소는 다음과 같이 설정해야 합니다:
[timelapse]
output_path: /usr/share/printer_data/timelapse/
snapshoturl: http://localhost:8080/snapshot
frame_path: /tmp/timelapse
수정 후 Moonraker를 재시작합니다. 전체 작업은 지연 촬영 기능을 참조하십시오.
지연 촬영에서 프레임 이미지가 생성되지 않는 경우 먼저 snapshoturl을 확인하십시오. GoCam은 /snapshot을 직접 사용하는 것을 권장합니다. 검증 없이 Crowsnest의 이전 스냅샷 주소를 그대로 유지하지 마십시오.
설정 파일
GoCam의 서비스 설정은 다음 위치에 있습니다:
/usr/share/printer_data/config/gocam.conf
기본 참조 설정은 다음과 같습니다:
[cam 1]
port: 8080
device: /dev/video1
resolution: 1920x1080
max_fps: 30
quality: 5
# v4l2ctl: focus_automatic_continuous=0,focus_absolute=70
# ffmpeg_flags: -fflags nobuffer -flags low_delay
| 매개변수 | v1.4.0 이미지 기본값 | 설명 |
|---|---|---|
port | 8080 | 현재 카메라 서비스 포트 |
device | /dev/video1 | 카메라 장치 노드; /dev/v4l/by-id/... 아래의 고정 경로를 우선 사용 |
resolution | 1920x1080 | 카메라가 실제로 지원하는 해상도 |
max_fps | 30 | 최대 프레임 속도 |
quality | 5 | MJPEG 품질, 값 범위는 1 ~ 31 |
v4l2ctl | 미설정 | 선택적 UVC 매개변수; 관리 페이지에서 저장한 매개변수가 이 항목에 기록됩니다 |
ffmpeg_flags | 미설정 | 선택적 FFmpeg 매개변수 |
상태 확인 및 문제 해결
SSH로 다음을 실행:
systemctl status gocam --no-pager
최근 서비스 로그 확인:
tail -n 100 /usr/share/printer_data/logs/gocam.log
자주 발생하는 문제:
- 페이지에 접근할 수 없음:
gocam=1,crowsnest=0을 확인하고8080포트가 다른 서비스에 점유되었는지 확인하십시오. - 페이지에 신호 없음 표시:
device가 현재 카메라를 가리키는지 확인하고 해상도와 프레임 속도가 카메라에서 지원되는지 확인하십시오. - 재시작 후 매개변수 손실: 실시간 조정 후에는 Save to config를 클릭해야 합니다.
- 지연 촬영에 이미지 없음:
snapshoturl을http://localhost:8080/snapshot으로 변경한 후 Moonraker를 재시작하십시오.