Документація HTTP SDK для іграшок Enjox

Огляд

Сторонні застосунки можуть використовувати Enjox HTTP SDK, щоб отримати можливості керування іграшками.

Функціональність HTTP SDK забезпечується застосунком EnjoxRemote. У цьому випадку застосунок EnjoxRemote виступає проксі Bluetooth ↔ HTTP, що дозволяє тобі легко керувати всіма іграшками на тому самому телефоні (або в мережі Wi-Fi) за стандартним протоколом HTTP. Спершу користувачі мають запустити застосунок EnjoxRemote, а вже потім — твій застосунок, щоб скористатися HTTP SDK.

Архітектура: твій застосунок взаємодіє із застосунком EnjoxRemote через HTTP SDK, а застосунок EnjoxRemote взаємодіє з іграшками Enjox через Bluetooth.

Тестова сторінка >>

Примітка: під час доступу через мережу Wi-Fi заміни 127.0.0.1 на IP-адресу пристрою, на якому запущено застосунок EnjoxRemote. Усталений порт — 8089.

Метод виклику

http://127.0.0.1:8089/{command}?param=value[&token=xxx]

Метод запиту

GET, POST

Параметри запиту

Формат відповіді

{"ret": 0, "data": 0}

Простий API

Вібрація іграшки

http://127.0.0.1:8089/vibrate?speed=num&time=msec

Функція

Викликає вібрацію іграшки протягом msec мілісекунд

Метод запиту

GET

Параметри запиту

Приклад

http://127.0.0.1:8089/vibrate?speed=20&time=1000

Обмеження

Мінімальний інтервал між двома командами — 100 мс

Обертання іграшки

http://127.0.0.1:8089/rotate?speed=num&time=msec

Функція

Викликає обертання іграшки протягом msec мілісекунд

Метод запиту

GET

Параметри запиту

Приклад

http://127.0.0.1:8089/rotate?speed=20&time=1000

Зупинка іграшки

http://127.0.0.1:8089/stop

Функція

Зупиняє всі дії іграшки

Метод запиту

GET

Параметри запиту

Немає

API візерунків

Попередньо задані візерунки

http://127.0.0.1:8089/preset?id=num

Функція

Викликає вібрацію іграшки за попередньо заданими візерунками

Метод запиту

GET

Параметри запиту

Приклад

http://127.0.0.1:8089/preset?id=1

Примітки

Іграшку можна будь-коли зупинити за допомогою простого API. Якщо її не зупинити, іграшка нескінченно повторюватиме візерунок, доки не розрядиться батарея.

Потік візерунків

http://127.0.0.1:8089/pattern

Функція

Надсилає іграшці серію команд

Метод запиту

POST

Параметри запиту

Приклад

http://127.0.0.1:8089/pattern

Тіло запиту

Content-Type: application/x-www-form-urlencoded

data=V:1;F:v,r;S:100;#0,0;2,0;4,3;5,5;6,6;

Примітки

Потоки візерунків можна писати власноруч або записувати в застосунку EnjoxRemote, ковзаючи пальцем.

Формат потоку візерунків

Потік візерунків складається із заголовка візерунка та даних візерунка, розділених символом #. Опис заголовка візерунка наведено в таблиці нижче. Дані візерунка — це рядок із пар чисел, розділених комами, що відокремлюються крапкою з комою, де кожна пара відповідає типам дій із заголовка візерунка (наприклад, для F=v,r кожна пара містить значення для вібрації та обертання).