Enjox játék HTTP SDK dokumentáció
Áttekintés
A harmadik féltől származó alkalmazások az Enjox HTTP SDK segítségével vezérlési képességeket szerezhetnek a játékok felett.
A HTTP SDK funkcionalitását az EnjoxRemote alkalmazás biztosítja. Ebben az esetben az EnjoxRemote alkalmazás Bluetooth ↔ HTTP proxyként működik, lehetővé téve, hogy a szabványos HTTP protokollon keresztül egyszerűen vezéreld az ugyanazon a telefonon (vagy Wi-Fi hálózaton) lévő összes játékot. A felhasználóknak először az EnjoxRemote alkalmazást kell elindítaniuk, mielőtt elindítanák a saját alkalmazásukat a HTTP SDK használatához.

Architektúra: A te alkalmazásod a HTTP SDK-n keresztül kommunikál az EnjoxRemote alkalmazással, az EnjoxRemote alkalmazás pedig Bluetooth-on keresztül kommunikál az Enjox játékokkal.
Megjegyzés: Wi-Fi hálózaton keresztüli hozzáférés esetén cseréld le a 127.0.0.1 címet az EnjoxRemote alkalmazást futtató eszköz IP-címére. Az alapértelmezett port a 8089.
Hívási mód
http://127.0.0.1:8089/{command}?param=value[&token=xxx]
Kérési mód
GET, POST
Kérési paraméterek
| Paraméter | Leírás | Értékek |
|---|---|---|
| command | Parancs | vibrate, rotate, preset, pattern |
| param | Paraméterek | A parancstól függően változik |
| token | Token | Rögzített érték: 6b9a21fb055343f8b10113a1b78b7229 (jelenleg rögzített, a jövőbeli verziókban szükséges lehet) |
Válasz formátuma
{"ret": 0, "data": 0}
| ret | data | Leírás |
|---|---|---|
| 0 | - | Sikeres |
| 1 | 10 | Ismeretlen hiba |
| 1 | 11 | A játék nincs csatlakoztatva |
| 1 | 12 | A játék akkumulátora gyenge |
Egyszerű API
Játék rezegtetése
http://127.0.0.1:8089/vibrate?speed=num&time=msec
Funkció
A játék rezegtetése msec ezredmásodpercig
Kérési mód
GET
Kérési paraméterek
| Paraméter | Leírás | Értékek |
|---|---|---|
| speed | Sebesség | 0–100, 0 a leállításhoz, 100 a maximális intenzitáshoz |
| time | Idő | Ezredmásodperc |
Példa
http://127.0.0.1:8089/vibrate?speed=20&time=1000
Korlátozás
Két parancs között a minimális időköz 100 ms
Játék forgatása
http://127.0.0.1:8089/rotate?speed=num&time=msec
Funkció
A játék forgatása msec ezredmásodpercig
Kérési mód
GET
Kérési paraméterek
| Paraméter | Leírás | Értékek |
|---|---|---|
| speed | Sebesség | 0–100, 0 a leállításhoz, 100 a maximális intenzitáshoz |
| time | Idő | Ezredmásodperc |
Példa
http://127.0.0.1:8089/rotate?speed=20&time=1000
Játék leállítása
http://127.0.0.1:8089/stop
Funkció
A játék összes műveletének leállítása
Kérési mód
GET
Kérési paraméterek
Nincs
Minta API
Előre beállított minták
http://127.0.0.1:8089/preset?id=num
Funkció
A játék rezegtetése előre meghatározott minták segítségével
Kérési mód
GET
Kérési paraméterek
| Paraméter | Leírás | Értékek |
|---|---|---|
| id | Minta azonosítója | 1 Pulzus, 2 Hullám, 3 Tűzijáték, 4 Földrengés |
Példa
http://127.0.0.1:8089/preset?id=1
Megjegyzések
A játék az Egyszerű API segítségével bármikor leállítható. Ha nem állítod le, a játék határozatlan ideig ismétli a mintát, amíg az akkumulátor le nem merül.
Mintafolyam
http://127.0.0.1:8089/pattern
Funkció
Parancsok sorozatának küldése a játéknak
Kérési mód
POST
Kérési paraméterek
| Paraméter | Leírás | Értékek |
|---|---|---|
| data | Mintafolyam | Mintafolyam-karakterlánc (a kérés törzsében) |
Példa
http://127.0.0.1:8089/pattern
Kérés törzse
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;
Megjegyzések
A mintafolyamok egyedileg megírhatók, vagy az EnjoxRemote alkalmazásban az ujjad csúsztatásával rögzíthetők.
Mintafolyam formátuma
A mintafolyam egy mintafejlécből és mintaadatokból áll, amelyeket # választ el. A mintafejléc leírása az alábbi táblázatban látható. A mintaadatok pontosvesszővel elválasztott, vesszővel tagolt számpárok karakterlánca, ahol minden pár a mintafejlécben szereplő művelettípusoknak felel meg (pl. F=v,r esetén minden pár tartalmaz egy-egy értéket a rezgéshez és a forgatáshoz).
| Kulcsszó | Tartalom | Leírás |
|---|---|---|
| V | 1 | Verziószám |
| F | v,r | Művelettípusok: v = rezgés, r = forgatás, p = összehúzódás |
| S | 100 | Időköz ezredmásodpercben |