Dokumentation för Enjox Toy HTTP SDK

Översikt

Tredjepartsappar kan använda Enjox HTTP SDK för att få kontroll över leksakerna.

HTTP SDK-funktionaliteten tillhandahålls av EnjoxRemote-appen. I detta fall fungerar EnjoxRemote-appen som en Bluetooth ↔ HTTP-proxy, vilket gör att du enkelt kan styra alla leksaker på samma telefon (eller Wi-Fi-nätverk) via det vanliga HTTP-protokollet. Användarna måste först starta EnjoxRemote-appen innan de startar din app för att använda HTTP SDK.

Arkitektur: Din app kommunicerar med EnjoxRemote-appen via HTTP SDK, och EnjoxRemote-appen kommunicerar med Enjox-leksaker via Bluetooth.

Testsida >>

Obs: Vid åtkomst via Wi-Fi-nätverk, ersätt 127.0.0.1 med IP-adressen till den enhet som kör EnjoxRemote-appen. Standardporten är 8089.

Anropsmetod

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

Förfrågningsmetod

GET, POST

Förfrågningsparametrar

Svarsformat

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

Enkelt API

Få leksaken att vibrera

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

Funktion

Få leksaken att vibrera i msec millisekunder

Förfrågningsmetod

GET

Förfrågningsparametrar

Exempel

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

Begränsning

Minsta intervall mellan två kommandon är 100 ms

Få leksaken att rotera

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

Funktion

Få leksaken att rotera i msec millisekunder

Förfrågningsmetod

GET

Förfrågningsparametrar

Exempel

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

Stoppa leksaken

http://127.0.0.1:8089/stop

Funktion

Stoppa alla leksakens funktioner

Förfrågningsmetod

GET

Förfrågningsparametrar

Inga

Mönster-API

Förinställda mönster

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

Funktion

Få leksaken att vibrera med fördefinierade mönster

Förfrågningsmetod

GET

Förfrågningsparametrar

Exempel

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

Anmärkningar

Leksaken kan stoppas när som helst med det enkla API:et. Om den inte stoppas fortsätter leksaken att upprepa mönstret i all oändlighet tills batteriet är slut.

Mönsterström

http://127.0.0.1:8089/pattern

Funktion

Skicka en serie kommandon till leksaken

Förfrågningsmetod

POST

Förfrågningsparametrar

Exempel

http://127.0.0.1:8089/pattern

Förfrågningskropp

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;

Anmärkningar

Mönsterströmmar kan skrivas anpassat eller spelas in i EnjoxRemote-appen genom att dra med fingret.

Mönsterströmsformat

En mönsterström består av ett mönsterhuvud och mönsterdata, åtskilda av #. Beskrivningen av mönsterhuvudet visas i tabellen nedan. Mönsterdata är en sträng med kommaseparerade talpar åtskilda av semikolon, där varje par motsvarar åtgärdstyperna i mönsterhuvudet (t.ex. för F=v,r innehåller varje par värden för vibrate och rotate).