Enjox Oyuncak HTTP SDK Dokümantasyonu

Genel Bakış

Üçüncü taraf uygulamalar, oyuncaklar üzerinde kontrol yetenekleri kazanmak için Enjox HTTP SDK'sını kullanabilir.

HTTP SDK işlevselliği EnjoxRemote Uygulaması tarafından sağlanır. Bu durumda, EnjoxRemote Uygulaması bir Bluetooth ↔ HTTP proxy'si olarak çalışır ve aynı telefondaki (veya Wi-Fi ağındaki) tüm oyuncakları standart HTTP protokolü aracılığıyla kolayca kontrol etmene olanak tanır. Kullanıcılar, HTTP SDK'sını kullanmak için kendi uygulamalarını başlatmadan önce EnjoxRemote Uygulamasını başlatmalıdır.

Mimari: Uygulaman HTTP SDK aracılığıyla EnjoxRemote Uygulamasıyla iletişim kurar ve EnjoxRemote Uygulaması Bluetooth aracılığıyla Enjox Oyuncaklarıyla iletişim kurar.

Test Sayfası >>

Not: Wi-Fi ağı üzerinden erişirken, 127.0.0.1 yerine EnjoxRemote Uygulamasını çalıştıran cihazın IP adresini yaz. Varsayılan port 8089'dur.

Çağırma Yöntemi

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

İstek Yöntemi

GET, POST

İstek Parametreleri

Yanıt Formatı

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

Basit API

Oyuncağı Titreştir

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

İşlev

Oyuncağı msec milisaniye boyunca titreştir

İstek Yöntemi

GET

İstek Parametreleri

Örnek

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

Sınırlama

İki komut arasındaki minimum aralık 100ms'dir

Oyuncağı Döndür

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

İşlev

Oyuncağı msec milisaniye boyunca döndür

İstek Yöntemi

GET

İstek Parametreleri

Örnek

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

Oyuncağı Durdur

http://127.0.0.1:8089/stop

İşlev

Tüm oyuncak hareketlerini durdur

İstek Yöntemi

GET

İstek Parametreleri

Yok

Desen API'si

Hazır Desenler

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

İşlev

Önceden tanımlanmış desenleri kullanarak oyuncağı titreştir

İstek Yöntemi

GET

İstek Parametreleri

Örnek

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

Notlar

Oyuncak, Basit API kullanılarak istediğin zaman durdurulabilir. Durdurulmazsa, oyuncak pil bitene kadar deseni süresiz olarak tekrarlamaya devam eder.

Desen Akışı

http://127.0.0.1:8089/pattern

İşlev

Oyuncağa bir dizi komut gönder

İstek Yöntemi

POST

İstek Parametreleri

Örnek

http://127.0.0.1:8089/pattern

İstek Gövdesi

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;

Notlar

Desen akışları özel olarak yazılabilir veya parmağını kaydırarak EnjoxRemote Uygulamasında kaydedilebilir.

Desen Akışı Formatı

Bir desen akışı, # ile ayrılmış bir desen başlığı ve desen verisinden oluşur. Desen başlığı açıklaması aşağıdaki tabloda gösterilmiştir. Desen verisi, noktalı virgülle ayrılmış virgülle ayrılmış sayı çiftlerinden oluşan bir dizedir ve her çift, desen başlığındaki eylem türlerine karşılık gelir (örneğin, F=v,r için her çift, vibrate ve rotate için değerler içerir).