Основные изменения API уровня 2

В этом разделе рассказывается об основных изменениях, которые нужно понимать и учитывать в камерах или приложениях.

Основные изменения

  • Команда sessionId больше не используется, связанные с ней команды больше не используются или изменены. API уровня 2 предназначен для одного клиентского соединения, и производитель камеры должен обеспечить невозможность одновременного подключения нескольких клиентов (например, ограничив количество соединений wifi до одного).
  • Команды getImage / getMetadata больше не используются.
    • Для загрузки напрямую с HTTP-сервера камеры используется абсолютный URL-адрес файла.
  • Добавлены/изменены команды и параметры для записи видео, записи изображений через интервалы и предварительного просмотра в реальном времени.
    • Добавлены команды 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 video XMP.
  • В вывод /osc/info добавлено поле apiLevel.
    • В API уровня 2 добавлено поле apiLevel. При отсутствии этого поля уровень API по умолчанию считается равным 1. Разработчик должен получить эту информацию и использовать в своих целях на основе этого значения.

Обратная совместимость

  • Для производителей камер: если ваши камеры поддерживали API уровня 1, настоятельно рекомендуется обеспечить поддержку API уровня 1 и API уровня 2 в качестве промежуточного решения на ближайшие несколько месяцев до окончательного обновления и выпустить обновление встроенного ПО для камер с API уровня 1. В противном случае клиенты, поддерживающие только API уровня 1, не смогут работать с вашими камерами.
  • Для разработчиков приложений: учтите, что эти изменения влияют на ранее опубликованные приложения, поэтому вы должны внести соответствующие изменения для работы с обеими версиями и напомнить владельцам камер о необходимости обновления встроенного программного обеспечения.