La nostra API ti consente di attivare un evento sul tuo Nabaztag da un'applicazione esterna. Ad esempio: controllare il movimento delle orecchie e i LED, nonché inviare messaggi in TTS (text to speech) o con un Nabcast.

Check the updated documentation at : http://api.nabaztag.com

Non esitare a contattarci se desideri implementare ulteriori funzionalità (idee@nabaztag.com).

Devi semplicemente digitare l'URL http://api.nabaztag.com/vl/FR/api.jsp con i seguenti parametri:

Ad esempio:

http://api.nabaztag.com/vl/FR/api.jsp?sn=00039D4022DE&token=112231049046144&posleft=0&posright=0&idmessage=10333&idapp=10

Come posso inviare un messaggio in TTS (text to speech) all'interno di un Nabcast con ID 52 e titolo myttsinmynabcast? http://api.nabaztag.com/vl/FR/api.jsp?.......nabcast=52&nabcasttitle=myttsinmynabcast&tts=the+nabcast

Come posso inviare il messaggio 10333 all'interno del Nabcast con ID 52 e il seguente titolo sonoro: mymp3inmynabcast?
http://api.nabaztag.com/vl/FR/api.jsp? ....nabcast=52&nabcasttitle=mymp3inmynabcast&idmessage=10333

1. Accedi alla sezione 'Strumenti' del tuo account, quindi seleziona la scheda API.

2. Seleziona l'opzione "Autorizza eventi esterni", quindi fai clic su OK.

3. Verrà visualizzato il token.
Prendi nota del token e salvalo, poiché ti servirà per inviare i messaggi dalla tua applicazione.

Nota: se disattivi gli eventi e successivamente li riattivi, ti verrà inviato un nuovo token.

Per coreografia si intendono una serie di azioni eseguite dai LED e dalle orecchie.
Il parametro principale di tali coreografie è una cadenza che può essere regolata.
Una volta impostata tale cadenza, le azioni verranno eseguite in sequenza sulla base di quel ritmo. Ogni azione viene eseguita in un momento preciso, detto "l'heure" (ora) dell'azione, che viene calcolato in base al numero di battiti che sono trascorsi dall'inizio della coreografia fino all'evento desiderato.

Ad esempio, se la cadenza è impostata su un decimo di secondo, l'azione associata a "l'heure" (ora) '10' verrà eseguita un secondo dopo l'inizio della coreografia. L'azione associata con "l'heure" '25' verrà eseguita 2,5 secondi dopo l'inizio della coreografia...

La sintassi della coreografia è costituita da una serie di parole o numeri, separati da virgole.
I numeri sono sempre interi positivi compresi tra 0 e 10. Per quanto riguarda le parole, è possibile scegliere tra una delle seguenti parole chiave: "motor" o "led".

La serie inizia con un valore relativo alla cadenza, quindi prosegue con una serie di azioni di tipo "motor" o "led".

Ciascuna azione (motor o led) inizia con il valore "l'heure" (ora) espresso dal numero di battiti trascorsi dall'inizio della coreografia fino all'evento desiderato, seguito dal comando (motor o led) e da una serie di variabili che descrivono l'azione.

Se due comandi vengono impartiti nello stesso momento, verranno eseguiti contemporaneamente.

La cadenza è espressa in Hz. "10" rappresenta una cadenza di un decimo di secondo.

Si tratta di una serie di valori separati da virgole.
Il comando viene espresso nel seguente modo:

1. Primo valore: ora dell'azione (l'heure)
"0" se si tratta del primo comando

2. Secondo valore: 'motor', per muovere un orecchio

3. Terzo valore: comando delle orecchie
1 per controllare l'orecchio sinistro
0 per controllare l'orecchio destro

4. Quarto valore: angolazione dell'orecchio
Valore possibile da 0 a 180

5. Quinto valore: inutilizzato, impostato su "0"    

6. Sesto valore: direzione della rotazione delle orecchie
1: in alto->indietro->in basso->in avanti->in alto...
0: in alto->in avanti->in basso->indietro->in alto...

Esempio di comando che consente di far ruotare l'orecchio sinistro in senso antiorario con un'angolazione di 20° all'ora (l'heure) "0" = 0,motor,1,20,0,0

Si tratta di una serie di valori separati da virgole.

1. Primo valore: ora dell'azione (l'heure)
"0" se si tratta del primo comando

2. Secondo valore: 'led', per impostare un colore per il LED

3. Terzo valore: per definire quale LED illuminare
0: LED inferiore
1: LED sinistro del coniglio
2: LED centrale
3: LED destro del coniglio
4: LED superiore

4. Quarto, quinto e sesto valore: colore in RGB
Valore da 0 a 255

Esempio: per fare in modo che il LED centrale diventi verde, quindi quello sinistro diventi rosso, quindi quello centrale si spenga = 0,led,2,0,238,0,2,led,1,250,0,0,3,led,2,0,0,0

Per combinare le tre azioni con i parametri di cadenza iniziali:
10,0,motor,1,20,0,0, 0,led,2,0,238,0,2,led,1,250,0,0,3,led,2,0,0,0

Puoi scegliere il tipo di voce che leggerà i tuoi messaggi.

Voci francesi:

• julie22k
• claire22s
• caroline22k
• bruno22k

Voci inglesi:

• graham22s
• lucy22s
• heather22k
• ryan22k
• aaron22s
• laura22s

Per impostazione predefinita, verranno utilizzate le voci claire22s per il francese e heather22k per l'inglese.