Dokumentacja HTTP SDK zabawek Enjox

Przegląd

Aplikacje innych firm mogą korzystać z Enjox HTTP SDK, aby uzyskać możliwość sterowania zabawkami.

Funkcjonalność HTTP SDK jest udostępniana przez aplikację EnjoxRemote. W tym układzie aplikacja EnjoxRemote działa jako pośrednik Bluetooth ↔ HTTP, pozwalając łatwo sterować wszystkimi zabawkami w tym samym telefonie (lub sieci Wi-Fi) za pomocą standardowego protokołu HTTP. Użytkownicy muszą najpierw uruchomić aplikację EnjoxRemote, zanim uruchomią Twoją aplikację korzystającą z HTTP SDK.

Architektura: Twoja aplikacja komunikuje się z aplikacją EnjoxRemote przez HTTP SDK, a aplikacja EnjoxRemote komunikuje się z zabawkami Enjox przez Bluetooth.

Strona testowa >>

Uwaga: Przy dostępie przez sieć Wi-Fi zastąp 127.0.0.1 adresem IP urządzenia, na którym działa aplikacja EnjoxRemote. Domyślny port to 8089.

Metoda wywołania

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

Metoda żądania

GET, POST

Parametry żądania

Format odpowiedzi

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

Proste API

Wibracja zabawki

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

Funkcja

Wibruje zabawką przez msec milisekund

Metoda żądania

GET

Parametry żądania

Przykład

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

Ograniczenie

Minimalny odstęp między dwoma poleceniami to 100 ms

Obrót zabawki

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

Funkcja

Obraca zabawką przez msec milisekund

Metoda żądania

GET

Parametry żądania

Przykład

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

Zatrzymanie zabawki

http://127.0.0.1:8089/stop

Funkcja

Zatrzymuje wszystkie działania zabawki

Metoda żądania

GET

Parametry żądania

Brak

API wzorów

Gotowe wzory

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

Funkcja

Wibruje zabawką według predefiniowanych wzorów

Metoda żądania

GET

Parametry żądania

Przykład

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

Uwagi

Zabawkę można w każdej chwili zatrzymać za pomocą prostego API. Jeśli nie zostanie zatrzymana, będzie powtarzać wzór w nieskończoność, aż do wyczerpania baterii.

Strumień wzoru

http://127.0.0.1:8089/pattern

Funkcja

Wysyła serię poleceń do zabawki

Metoda żądania

POST

Parametry żądania

Przykład

http://127.0.0.1:8089/pattern

Treść żądania

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;

Uwagi

Strumienie wzorów można pisać samodzielnie lub nagrać w aplikacji EnjoxRemote, przesuwając palcem.

Format strumienia wzoru

Strumień wzoru składa się z nagłówka wzoru i danych wzoru, oddzielonych znakiem #. Opis nagłówka wzoru przedstawiono w tabeli poniżej. Dane wzoru to ciąg par liczb rozdzielonych przecinkami, oddzielonych średnikami, przy czym każda para odpowiada typom działań z nagłówka wzoru (np. dla F=v,r każda para zawiera wartości dla wibracji i obrotu).