<< Перейти к оглавлению

Управление трекером через сторонние программы.

Трекером можно управлять через такие программы как Tasker, Automagic и многие другие.
Управление производится путем отправки команд (action) через Broadcast intents.

В настройках сторонних приложений требуется указывать пакет нашего приложения (Package) и компонент, отвечающий за выполнение команд (Class).
Package – com.app.realtimetracker
Class - com.app.realtimetracker.ExControl

Параметры для команд задаются в формате ключ-значение и, как правило, в программах вводятся в виде:
putString(“key”,”value”);
или putExtra(“key”, “value”);
или просто key:value
Формат зависит от программы. В том случае, если явно указывается тип, то значения обязательно должны быть текстовыми.

Список доступных интентов

Список доступных интентов можно найти в этом документе

<< Перейти к оглавлению

<< Перейти к оглавлению

Пример управления через программу Tasker

Нажав на плюс, добавить новое событие. Для примера, возьмем событие «Экран разблокирован».
Нажав кнопку «назад», выбрать пункт «Новая задача» и в поле ввести произвольное имя задачи. Например, «Start Tracker».
В следующем окне нажмите плюс и выберите категорию действий «Разное» и в ней «Send Intent»



В поле «Действие» нужно вводить команду, например, rtt_start



В поле «Package» нужно вводить com.app.realtimetracker
А в поле «Class» - com.app.realtimetracker.ExControl



Если у команды нет параметров, то настройка на этом заканчивается. Сохраните изменения.

Если требуется ввести параметры, то в поле «Extra» нужно ввести key:value. Например, для переключения режимов поле Extra будет выглядеть так: mode:standart



<< Перейти к оглавлению

<< Перейти к оглавлению

Пример управления через программу Automagic

Создать новый поток, выбрать по какому событию будет отправляться команда.
Для примера взят ярлык на рабочем столе, но может быть абсолютно любое событие.
Добавляем действие (нажатие на плюс) и выбираем тип Action.



В появившемся окне нужно нажать на кнопку «New» и из списка выбрать «Send Broadcast»

В появившемся диалоге:
В поле «Name» лучше снять галку «Default Name» и ввести в поле свое имя для будущего события.
В поле "Action" нужно вводить имя команды. Например, rtt_start



Ниже есть пункт "Explicit Component", нужно активировать.
На экране появятся 2 пункта:
"Package Name" - либо из списка программ можно выбрать RealTimeTracker, либо ввести вручную com.app.realtimetracker
В поле "Class Name" ввести com.app.realtimetracker.ExControl

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



Если у команды есть параметры, например, команда задания режима работы «rtt_mode», то последним пунктом в настройках идет пункт «Extras».
По умолчанию имеет значение PutString(“command”,”next”), где «command» - это Key, а «next» – Value.

Нужно заменить их на соответствующие значения из выбранной команды. Так для команды rtt_mode нужно вписать значения putString(“mode”,”econom”); для переключения в экономичный режим или putString(“mode”,”standart”); для переключения в постоянный режим.



<< Перейти к оглавлению

<< Перейти к оглавлению

Собственные параметры и события

В версии приложения 2.6.3 появилась возможность на основе интентов внешнего управления отправлять на сервис мониторинга собственные параметры и события, полученные с помощью сторонних программ.

Параметр - это числовое значение какого-либо показателя, присылаемое трекером. Например, скорость, высота, количество спутников, координаты - это все параметры.
О том, что такое "Событие" подробно описано в этой статье нашей инструкции.

Как и в случае других интентов, в настройках сторонних приложений требуется указывать пакет нашего приложения (Package) и компонент, отвечающий за выполнение команд (Class).
Package – com.app.realtimetracker
Class - com.app.realtimetracker.ExControl

Action: rtt_custom_param
Параметр интента (Extras) в формате название#тип:значение, где
key: название#тип
value: значение вашего параметра или события

Формат key:value обязателен. Нельзя задать только key: без value или наоборот.

Расшифровка key:

• Название - любое понятное вам текстовое представление вашего параметра или события. Ограничение по длине - 10 символов.
  Для событий допускается ввод текста по-русски.
  Для параметров - строго в латинице.
• Тип - задается текстовым кодом, который определяет отправляется параметр или событие.
  Для параметров так же задает целое или дробное значение будет отправлено.
  Коды:
  
  • int - целое число. Признак того, что это параметр
  • double - дробное число. Признак того, что это параметр
  • event - Признак того, что это событие

Название и тип разделяются символом #.
Если явно не указан тип (название:значение или putString("название", "значение") ), то по умолчанию тип=event

Расшифровка value "Значение":

• Для параметров - числовое значение целое или дробное в зависимости от выбранного кода (int/double)
• Для событий - произвольный текст. Ограничение по длине - 140 символов. Если у события должно быть только название и нет текста, нужно в качестве значения установить "0".

Примеры Extras для популярных приложений Tasker и Automagic:

Параметр, понятное текстовое название "battery", тип значения - целое число, значение параметра - 30

• Tasker: battery#int:30
• Automagic: putString("battery#int", "30");

Параметр, понятное текстовое название "speed", тип значения - дробное число, значение параметра - 90.5

• Tasker: speed#double:90.5
• Automagic: putString ("speed#double", "90.5");

Параметр, понятное значение уровень звука, тип значения - дробное число, значение параметра - переменная, создаваемая средствами стороннего приложения

• Tasker: sound#double:soundlevel
• Automagic: putString("sound#double",soundlevel);

Событие. Название "удар", так как нужно зафиксировать только факт удара, значение отсутствует, поэтому 0.

• Tasker: удар#event:0
• Automagic: putString ("удар#event","0");

Cобытие с названием "звонок", текстовое сообщение с какого номера поступил звонок

• Tasker: звонок#event:поступил звонок с номера 70001234567
• Automagic: putString("звонок#event","поступил звонок с номера 70001234567");

Cобытие с названием "alarm", текстовое сообщение "сработала сигнализация"

• Tasker: alarm:сработала сигнализация
• Automagic: putString("alarm", "сработала сигнализация");

Пример создания события

Ниже приведен пример отправки произвольного текста на сервер через Real Time Tracker с помощью специального виджета, созданного приложением AutoMagic.

По нажатию на виджет открывается окно для ввода текста.
По кнопке "ОК" создается событие для Real Time Tracker и отправляется на сервер мониторинга.
Увидеть введенные текст можно любым из доступных для событий способом
Если текст не введен или нажата кнопка "Cancel", действие отменяется.

Ниже вы можете скачать скрипт для программы AutoMagic.



<< Перейти к оглавлению