API 레벨 2 키 변경 사항

이 섹션에서는 개발자가 이해하고 카메라 또는 앱에서 고려해야 하는 키 변경 사항을 중점적으로 설명합니다.

키 변경 사항

  • 지원 중단된 sessionId 및 지원 중단/수정된 관련 명령어. API 레벨 2는 단일 클라이언트 연결용으로 고안되었으며 카메라 제조사는 항상 단일 클라이언트만 연결되도록 해야 합니다(예: 단일 와이파이 연결만 제한).
  • 지원 중단된 명령어 getImage / getMetadata.
    • 파일의 절대 URL을 사용하여 카메라 HTTP 서버에서 직접 다운로드합니다.

  • 비디오 캡처, 간헐적 이미지 캡처, 라이브 미리보기를 위해 추가/수정된 명령어 및 옵션.

    • 추가된 명령어 startCapture / stopCapture / getLivePreview / processPicture / reset.
    • 이미지 유형은 물론 동영상 유형도 처리하도록 listImages를 listFiles로 이름을 변경하고 입력/출력을 수정했습니다.
    • previewFormat, previewFormatSupport, captureInterval, captureIntervalSupport, captureNumber, captureNumberSupport, remainingVideoSeconds, pollingDelay, delayProcessing, delayProcessingSupport, clientVersion 옵션이 추가되었습니다.
    • captureModeSupport, isoSupport, shutterSpeedSupport, fileFormatSupport, hdr, hdrSupport, exposureBracket, exposureBracketSupport 옵션이 수정되었습니다.

  • 360 동영상 XMP 사양이 추가되었습니다.

  • /osc/info 출력에 apiLevel 필드가 추가되었습니다.

    • apiLevel: API 레벨 2에서 추가된 필드입니다. 이 필드가 없으면 기본적으로 API 레벨 1로 간주됩니다. 이 정보를 검색하고 해당 값에 기반하여 달리 구현하는 것은 개발자의 책임입니다.

이전 버전과의 호환성

  • 카메라 제조사: API 레벨 1을 지원했다면 최종 업데이트 몇 개월 전에 중간 솔루션으로 API 레벨 1과 API 레벨 2를 지원하고 API 레벨 1을 실행하는 카메라의 펌웨어 업데이트를 제공하는 것이 좋습니다. 그렇지 않으면 API 레벨 1만 지원하는 클라이언트가 카메라와 호환되지 않습니다.
  • 앱 개발자: 이러한 변경 사항이 기존의 게시된 앱에 영향을 미친다는 것에 유의해야 합니다. 해당 변경 사항에서 두 버전을 처리하게 하고 카메라 소유자에게 펌웨어 업데이트를 알리는 것은 개발자의 책임입니다.