FAQ

Что такое параметр состояния и как его сконфигурировать?
Как использовать интеграцию с навигатором?
Как использовать удаленное управление?
Каков принцип работы тревожной кнопки и как ее настроить?
Как загрузить файл конфигурации?

Что такое параметр состояния и как его сконфигурировать?

Параметр состояния используется для передачи на сервер какого-либо статуса объекта. Чаще всего его применяют для слежения за рабочим статусом. То есть, например, для сигнализации о состояниях “Занят”, “Свободен”, “Пауза” и т.д.

Wiatrack Pro позволяет максимально гибко настроить этот параметр и его значения. На данный момент (в версии 0.5.17) существуют следующие настройки:

Использовать параметр состояния

Если вы хотите использовать параметр состояния, поставьте галочку напротив “Использовать параметр состояния”. В этом случае на экране трекинга появится поле отображающее текущий статус и его другие возможные значения.

Имя параметра

В это поле вносится имя параметра состояния. По умолчанию это “STATUS”. Имя параметра необходимо для формирования строки параметров передаваемой на сервер.

Тип параметра

Так же для строки параметров передаваемой на сервер необходимо указать информацию о типе параметра. Возможные значения типа: целое число (значение по умолчанию), число с плавающей запятой и строка.

Возможные значения

Эта настройка позволяет определить разрешенные значения параметра состояния. Каждое из таких значений описывается одной строкой вида:

[Имя];[Значение];[Цвет];[Является ли значением по умолчанию]

Где:

Имя – текст используемый для представления значения на экране трекера

Значение – значение параметра передаваемое на сервер

Цвет – цвет значения на экране трекера. Цвет определяется как #AARRGGBB. AA – прозрачность (от 00 до FF), RR – красная компонента цвета (00-FF), GG – зеленая компонента (00-FF), BB – синяя компонента (00-FF).

Является ли значением по умолчанию – возможные значения “true” или “false”.

Пример:

Занят;0;#FFFF0000;false

Свободен;1;#FF00FF00;true

В данном случае определено два значения: 0 и 1. На экране они будут отображаться как “Свободен” и “Занят”. “Занят” будет отображено на полностью непрозрачном красном фоне (#FFFF0000), а “Свободен” на зеленом(#FF00FF00). Значение 1 (“Свободен”) является значением по умолчанию.

Отсылать статус единожды при переключении

Эта настройка определяет нужно ли отсылать статус единожды при переключении параметра или постоянно вместе с каждым сообщением (т.е. при любом изменении координат). Если вы используете Wialon и хотите визуализировать статус юнита на карте, то рекомендуется отсылать данные о статусе не единожды, а постоянно.

Как использовать интеграцию с навигатором?

Wiatrack Pro интегрирован с некоторыми навигационными программами. Что это значит? Это значит, что при отсылке текстового сообщения, содержащем координаты места назначения и сформированного определенным образом, Wiatrack Pro примет это сообщение и представит его пользователю в определенном виде, позволяющем пользователю стартовать навигатор с принятыми координатами.

Чтобы было понятней что имеется в виду мы рассмотрим небольшой пример. Но перед тем как отправить собственно координаты убедимся, что трекер настроен правильно. Для этого пройдем в настройки Wiatrack Pro, в раздел “Сообщения”.

Под заголовком “Поддержка навигации” найдем настройку “Навигатор” и откроем ее.

В списке содержатся все поддерживаемые на данный момент навигаторы. Выберем “Google Maps”.

Конечно, вы можете выбрать тот навигатор, который вам нравится. Необходимо только, чтобы он был инсталлирован на вашем мобильном устройстве. Если вашего навигатора нет в списке, попробуйте опцию “Универсальный”. Этот интерфейс реализован многими навигаторами, возможно и вашим. (Если же и это не работает, просто напишите нам на info@wialon-consulting.de, мы постараемся найти решение вместе.)

Вернемся назад в главное меню Wiatrack Pro и выберем здесь “Трекинг”.

Нажатием на кнопку запустим службу Wiatrack.

Теперь откроем браузер на нашем ПК и пройдем в Wialon.

В меню мониторинга найдем интересующий нас объект и кликнем на иконке “Выполнить команду”.

Появится соответствующее меню, в котором выберем пункт “Отправить координаты”.

После нажатия на кнопку “Далее” появится диалог с полями “Название”, “Текст”, “Широта” и “Долгота”.

Значения широты и долготы система вносит автоматически исходя из центра карты. Удобно их изменить можно кликнув на кнопку “Показать карту”. Тогда диалог будет сдвинут в сторону и появится курсор. После двойного клика на карте система внесет координаты клика в соответствующие поля. Кроме координат внесем так же значения в поля “Название” и “Текст”. После нажатия кнопки ОК сообщение будет отправлено.

При наличии стабильного соединения с сервером, трекер практически сразу получит это сообщение. Телефон подаст звуковой сигнал и в статусной строке появится новое уведомление.

Если потянуть статусную строку вниз и кликнуть на уведомлении, то можно попасть в список сообщений.

Сообщения с координатами, в отличие от простых текстовых сообщений, содержат кнопку для просчета маршрута. Если кликнуть на ней, то Wiatrack Pro откроет указанный в настройках навигатор и передаст ему координаты цели маршрута. В данном случае в нашей конфигурации указан навигатор Google Maps.

Как использовать удаленное управление?

Функция удаленного управления позволяет осуществлять эксплуатацию трекера по командам непосредственно из диспетчерской: запускать сервис Wiatrack, останавливать его и запрашивать координаты трекера по SMS. Это дает многие преимущества: экономия заряда батареи, возможность автоматизации и привязки трекера к каким-то другим событиям происходящим на мониторинговом сервере, либо на других компьютерах.

На данный момент (в версии 0.5.19) возможны четыре функции:

Запуск службы

SMS предназначенная для запуска службы выглядит следующим образом: WIATRACK START SERVICE. При получении такой SMS будет произведена попытка стартовать службу Wiatrack. Если она уже работает, то SMS будет проигнорирована.

Останов службы

SMS предназначенная для останова службы выглядит так: WIATRACK STOP SERVICE. При получении этой SMS служба Wiatrack будет остановлена.

Запрос координат

Чтобы единоразово запросить координаты нужно отослать SMS следующего вида: WIATRACK GET LOCATION. После такого запроса отправителю будет отослана SMS с координатами трекера. Сперва будет произведена попытка получения актуальных координат через GPS ресивер. Если GPS ресивер отключен или трекер находится вне зоны приема спутников (в здании, в подвале и т.п.), программа попытается получить координаты через GSM сеть. Если и это невозможно, будут использованы последние известные координаты.

Можно запросить координаты и для другого номера. Это делается при помощи такой SMS:WIATRACK GET LOCATION TO abc, где abc – номер, на который должна быть отправлена SMS с текущими координатами.

Запрос фото

Для запроса фото необходимо отослать команду следующего вида:
WIATRACK GET PHOTO
или
WIATRACK GET PHOTO CAMERA=FRONT
или
WIATRACK GET PHOTO CAMERA=BACK
Если камера не будет явно указана, как в первом примере, то Wiatrack Pro использует стандартную, т.е. указанную в настройках приложения.
Важно: Для срабатывания команды не забудьте указать в настройках, что фото по запросу разрешено (Настройки/Камера/Разрешить фото по запросу).

Сигнал тревоги

Wiatrack Pro позволяет отправить на трекер сигнал тревоги:
WIATRACK ALARM
После принятия этой команды приложение включит акустический сигнал и покажет пользователю диалог с соответствующей информацией. Акустический сигнал будет продолжаться, а диалог блокирует интерфейс телефона или планшета до тех пор, пока пользователь не нажмет на кнопку ОК.
В настройках также можно указать, что приложение должно при нажатии этой кнопки отослать на сервер автоматический ответ (Настройки/Сообщения/Подтверждать тревожные сообщения). Таким образом диспетчер будет автоматически проинформирован о том, что пользователь принял сигнал тревоги.

Изменение конфигурационных параметров

Чтобы изменить конфигурационные параметры нужно отослать SMS следующего вида:WIATRACK SET CONFIG key1=value1, key2=value2, key3=value3… Значение параметра МОЖНО заключить в апострофы, a eсли оно содержит пробелы, то его НУЖНО заключить в апострофы. Пример: WIATRACK SET CONFIG key1=’value1′, key2=’value2′, key3=’a very long value with whitespaces’. Кстати, регистр символов имеет значение.

Список конфигурационных параметров и их разрешенные значения описаны в этом файле. Tак же было бы полезно прочесть раздел FAQ Как загрузить файл конфигурации?.

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

Конфигурирование удаленного управления

Для того, чтобы воспользоваться удаленным управлением необходимо его сконфигурировать. Для этого нужно пройти в соответствующий раздел настроек и поставить галочку напротив опции “Удаленное управление”.

После этого будет включена и опция “Разрешенные номера”. В этой опции можно при помощи регулярного выражения Java задать номера, которым разрешено управлять трекером. Стандартное значение этой опции “.*”, что означает удаленное управление разрешено со всех номеров телефонов.

Чтобы сконфигурировать эту опцию необходимо немного знать что такое регулярные выражения, для чего они нужны и как ими пользоваться. Хотя документацию по регулярным выражениям можно легко найти в интернете (и мы рекомендуем поискать хорошее описание – это в любом случае поможет в работе), однако материя все-таки достаточно сложная и самое главное не во всем объеме нужна для наших целей. Поэтому основные положения, которые будут полезны для конфигурации телефонных номеров мы опишем здесь.

Итак, регулярные выражения предназначены для сравнения строк. Строка может быть описана регулярным выражением и после того как процессор регулярных выражений сравнит строку с регулярным выражением, он ответит на вопрос, описана ли данная строка данным регулярным выражением. В нашем случае задание звучит так: “Совпадает ли номер, с которого пытаются произвести операцию удаленного управления, с описанием разрешенных номеров в настройках”. Если ответ будет “да”, то операция будет произведена, если “нет”, то запрос будет проигнорирован.

Итак, для нашего случая полезно знать несколько спецсимволов, используемых в регулярных выражениях. “.” (точка) означает один любой символ. “\d” – означает одну любую цифру. Когда нужно найти в строке несколько символов, используют т.н. квантификаторы “*”, “+”, “{a, b}”. “*” означает любое количество повторений (т.е. в том числе и ноль), “+” – означает один или несколько раз, а “{a, b}” значит “от a до b раз”. Например: “1{2,3}” значит, что символ “1” повторяется от двух до трех раз. Таким образом наше регулярное выражение подойдет как для строки “11”, так и для строки “111”. Для строк же “1” или “1111” оно уже не подойдет.

Т.к. список номеров часто содержит несколько альтернатив, нам пригодится и знак “|”, означающий “ИЛИ”. Например, регулярное выражение “1234|5678” означает, что номера “1234” и “5678” будут валидными.

Для телефонных номеров будет полезна еще одна вещь: так как символ “+” занят для квантификатора, то он описывается символом “\+”. Таким образом, если нужно описать номер “+749512345678”, то регулярное выражение для именно этого номера будет “\+749512345678”.

Теперь рассмотрим несколько примеров:

Регулярное выражение Примеры подходящих номеров Пояснения
.* Абсолютно любой номер или вообще строка (в том числе пустая). “.” означает любой символ, а “*” – любое количество повторений
0071234567890 0071234567890 (и никакой другой!) Наше регулярное выражение не использует ни одного спецсимвола, таким образом подходит только та же самая строка
0071234567890|0079876543210 0071234567890 либо 0079876543210 Два номера объединены знаком ИЛИ. Т.е. подойдет либо тот либо другой.
0071234567890|\+71234567890|1234567890 0071234567890 либо +71234567890 Это, пожалуй, один из распространенных сценариев. Дело в том, что SMS приходящие на телефон могут содержать номер отправителя в различных форматах. Как в международном (+7), так и в локальном (007 – тут взят локальный
формат принятый в Германии). Может быть и так, что кода страны вовсе не будет (1234567890).
.*1234567890 Номер начинающийся на любые цифры и оканчивающийся на 1234567890 Это более удобный вариант написания предыдущего примера. Хотя и не 100% соответствующий ему. В данном случае, например, разрешенным номером будет не только “+71234567890” но и “+491234567890”. Однако
из-за количества цифр, вероятность того, что владелец номера оканчивающегося на 1234567890 знает о возможности удаленного управления трекером и захочет ею воспользоваться ничтожно мала.
.*1234567890|.*987654321|.*2143658709 Номерa оканчивающиeся на 1234567890, 987654321 или 2143658709 Это один из самый реалистичных вариантов. Таким образом разрешаются три варианта номера, а символы “.*” использованы для того, чтобы решить вышеописанную проблематику с международными кодами.

Регулярные выражения – это чрезвычайно мощный инструмент, на практике, однако, можно ограничиться всего двумя шаблонами. Вот они:

Регулярное выражение Пояснения
.* Разрешены все номера
.*1234567890|.*987654321 Разрешены номерa оканчивающиeся на 1234567890 и 987654321. Если например нужно разрешить еще один номер, то к выражению необходимо добавить “|.*” и затем необходимый номер. Как уже говорилось, “.*” в начале стоит для того,
чтобы разрешить все варианты написания номера (с кодом, без кода, с плюсиком и т.д.)

Для первых тестов и ознакомления с функцией удаленного управления мы советуем временно разрешить удаленное управление для всех номеров, т.е. вписать в поле “.*” (без кавычек).

Каков принцип работы тревожной кнопки и как ее настроить?

Чтобы настроить тревожную кнопку нужно пройти в настройки в раздел “Параметры / Тревожная кнопка”.

При помощи опции “Показывать тревожную кнопку” можно включить или выключить отображение тревожной кнопки на основном экране Wiatrack Pro. При нажатии на эту кнопку на сервер отправляются текущие координаты с параметром вида “Имя:Тип:Значение”.

Опция “Имя параметра” определяет имя параметра, опция “тип параметра” – его тип, а опция “Значение параметра” соответственно его значение. В стандартном варианте отравляется строка “SOS:1:1”.

При нажатии на кнопку пользователю сперва показывается диалог с обратным отсчетом позволяющий пользователю отменить отсылку сигнала тревоги при случайном нажатии на кнопку. Когда обратный отсчет доходит до нуля, программа пытается узнать координаты по GPS. Если же это оказывается невозможно (например GPS ресивер выключен) используются координаты сети.

Если в качестве мониторингового сервера используется Wialon, то можно, например, добавить уведомление, которое будет срабатывать при поступлении сигнала SOS на сервер. Подробнее об уведомлениях можно узнать в документации Wialon.

Как загрузить файл конфигурации?

Wiatrack Pro можно конфигурировать не только вручную, изменяя каждую настройку отдельно, но и загружая файл с нужными настройками с сервера. Это дает возможность изменять настройки трекера удобно и быстро, а главное без участия конечного пользователя, проводя все операции на сервере.

Конфигурационный файл и его формат

Все настройки записываются в файл, содержимое которого интерпретируется трекером и импортируется в настройки программы. В качестве формата файла выбран стандартный формат properties. В таких файлах очень часто содержатся настройки Java-приложений.

Формат такого properties-файла очень прост. В основном используется шаблон

[имя ключа]=[значение ключа]

Строки комментариев начинаются с символа #. Вот небольшой пример из рабочего файла конфигурации Wiatrack Pro:

# default speed
DefaultSpeed=50

# delete log on app start (true or false)
DeleteLogOnAppStart=false

# enable daily start (true or false)
EnableDailyStart=false

Хотя формат и разрешает другие разделители и другие маркеры комментариев кроме вышеназванных, но мы ради простоты опишем здесь только эти. Просто потому что для работы больше и не нужно. Конечно, интересующиеся могут воспользоваться любой поисковой машиной и разузнать об этом формате побольше. Источников на эту тему в интернете очень много. Например, неплохая статья о properties есть в русскоязычной Википедии.

Ключи и их значения

Практически все конфигурационные ключи и их разрешенные значения легче всего посмотреть в этом файле. Именно его мы советуем использовать в качестве шаблона для собственных настроек. Все значения в нем настроены так, как они установлены по умолчанию в свежеинсталлированном приложении. Выставьте желаемые значения в соответствующих строках. Кстати, вы можете сэкономить на трафике если удалите строки с ключами, которые вы не хотите настраивать. Учтите, что регистр символов имеет значение. Используйте ключи только в том написании, как указано в примере. В случае установки неправильных или неразрешенных значений программа может реагировать неадекватно. Поэтому действуйте в соответствии с пословицей “Семь раз отмерь – один отрежь”.

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

Процедура загрузки конфигурационного файла на примере Wialon

Прежде чем загружать конфигурационный файл на устройство, нужно убедиться что удаленное управление устройством разрешено. Для этого нужно пройти в соответствующий раздел настроек и посмотреть есть ли галочка напротив опции “Удаленное управление”. Учтите, что из соображений безопасности эта опция по умолчанию выключена. Если вы собираетесь на ваших устройствах изменять настройки удаленно, советуем включить эту опцию сразу при начальной конфигурации устройства внося лицензионный ключ.

Запустите Wiatrack Pro. Необходимо, чтобы программа соединилась с сервером. Теперь пройдите в вебприложение Wialon. На закладке “Мониторинг” выберите нужный объект из списка и кликните на символе “Выполнить команду”.

В появившемся окне выберите “Загрузить конфигурацию” и кликните на “Далее”.

Теперь выберите файл конфигурации и кликните на “Загрузить”. Браузер скопирует файл с диска вашего компьютера на сервер. Когда файл будет перенесен система сообщит вам, что “Файл конфигурации загружен”.

Кликайте на “ОК”. Wialon загрузит файл конфигурации на мобильное устройство. А Wiatrack Pro примет файл и изменит настройки в соответствии с указаниями в файле. О том, что настройки были изменены вы будете оповещены символом в статусной строке на экране вашего мобильного устройства.

Кстати, если вы потянете статусную строку вниз и кликнете на статусном сообщении, то попадете в настройки Wiatrack Pro, где сможете еще раз их проконтролировать.