Запрос конфигурации

GET

http://www.examplehost.com/config.properties?version=4.7.8.0&login=XXX&password=YYY

Параметры:

• version – обязательное поле. Версия клиента (на случай смены протокола). Сейчас нужно посылать значение "4.7.8.0".
• login – необязательное поле. Логин.
• password – необязательное поле. Используется, если установлен доступ по паролю.

Особенности использования

В начале работы неизвестно, установлены ли пароль, логин и т.п. Поэтому в первый раз необходимо послать следующий запрос:

GET

http://www.examplehost.com/config.properties?version=4.7.8.0

В ответ сервер отправит текстовый файл config.properties следующего формата:

password.enabled=true

login.enabled=true

password.invalid=true#

После получения файла такого вида можно понять, что пароль установлен и пароль неправильный. Неправильный он потому, что данном случае был послан пустой пароль и пустой логин.

Необходимо запросить у пользователя логин и пароль и снова отослать серверу запрос на конфигурацию:

GET

http://www.examplehost.com/config.properties?version=4.7.8.0&login=XXX&password=YYY

Если пароль правильный или доступ разрешен без пароля, то сервер в ответ вышлет конфигурацию в следующем виде:

password.enabled=true

login.enabled=true

password.invalid=false

cam.0.id=2

cam.0.name=Face

cam.0.rights=11

cam.1.id=3

cam.1.name=Camera 3

cam.1.rights=11

cam.2.id=5

cam.2.name=Camera 5

cam.2.rights=11

cam.2.telemetry_id=1.1

cam.count=3#

password.invalid=false означает, что введён верный пароль.

cam.count=3 – общее количество камер в присланной конфигурации (id начинается с нуля).

Для каждой из трёх камер необходимо получить данные из конфигурации.

cam.N.id – id камеры.

cam.N.name – название камеры.

cam.N.rights – права.

cam.N.telemetry_id – id телеметрии (может отсутствовать, если телеметрии нет, тогда необходимо скрывать элементы управления телеметрией).

cam.N.rights – определяет права (они проверяются на сервере, но чтобы не показывать пользователю лишних опций, доступны и на клиенте). Параметр представляет собой флаги. Если флаг проставлен, то элемент интерфейса следует показывать, если нет, то скрывать.

    static final int RIGHT_VIEW = 0x1;  // доступен просмотр живого видео (этот всегда проставлен в 1)

    static final int RIGHT_CONTROL = 0x2; // управление (телеметрия, постановка и снятие с охраны)

    static final int RIGHT_CONFIG = 0x4;  // reserved

    static final int RIGHT_HISTORY = 0x8; // доступ к архиву