Nabaztag Api

Übernehmen Sie die vollständige Kontrolle über Ihren Nabaztag

Inhaltsübersicht

  • API-Übersicht
  • Wie versende ich ein Ereignis?
  • Den Empfang von Ereignissen auf einem Nabaztag aktivieren
  • Choreografie-Sprache
  • 1. Tempo-Befehl
  • 2. Ohren-Befehle
  • 3. LED-Befehle
  • 4. Kombinationen aus Ohren- und LED-Befehlen:
  • 5. Die Stimme für Text-zu-Sprache (TTS) auswählen
  • 6. Senden Sie eine URL an einen Nabaztag/tag und erhalten Sie Streaming Audio

API-Übersicht

Wenn Sie unsere API verwenden, können Sie aus einer externen Anwendung heraus ein Ereignis auf Ihrem Nabaztag aktivieren. Zum Beispiel: Steuern Sie die Bewegungen der Ohren, schalten Sie die LEDs ein und aus, versenden Sie Nachrichten mithilfe von Text-zu-Sprache (TTS) oder mit einem Nabcast.

Für Updates schau Dir auch folgende Seite an: http://api.nabaztag.com (English)

Zögern Sie nicht, sich mit uns in Verbindung zu setzen, wenn Sie zusätzliche Funktionen integrieren möchten (idee@nabaztag.com).

Wie versende ich ein Ereignis?

Sie müssen einfach nur die URL http://api.nabaztag.com/vl/FR/api.jsp mit folgenden Parametern aufrufen:

sn Die Seriennummer des Nabaztags, der die Ereignisse erhält.
idmessage Die Nummer der zu versendenden Nachricht. Diese Nummer kann sich auf eine Nachricht in der Bibliothek oder auf eine persönliche, von Ihnen heruntergeladene MP3-Datei beziehen. Sie finden diese Identifikationsnummer unter dem Titel des Stücks, das Sie sich anhören.
posright Die Position des rechten Ohres in einem Wertebereich von 0 bis 16 (0 = Ohr horizontal).
posleft Die Position des linken Ohres.
token Das Token ist eine Reihe von Zahlen, die Sie erhalten, wenn Sie den Nabaztag-Empfänger aktivieren. Diese zusätzliche Identifikation begrenzt das Spam-Risiko, denn um eine Nachricht zu senden, müssen Sie sowohl die Seriennummer als auch das Token kennen.
idapp Dies ist die Identifikationsnummer Ihrer Anwendung. Sie ermöglicht Ihnen, den Sender des Ereignisses zu identifizieren. Dieser Parameter wird zurzeit noch nicht verwendet.
tts Ermöglicht Ihnen, einen für die Sprachsynthese konfigurierten Text zu senden.
chor [NICHT VERFÜGBAR] Senden Sie eine Choreografie an Ihren Nabaztag.
chortitle [NICHT VERFÜGBAR] Der Name der Choreografie.
ears=ok Sendet die Position der Ohren an Ihren Nabaztag.
nabcast [NICHT VERFÜGBAR] Ermöglicht Ihnen, eine Nachricht als Nabcast zu versenden.
ttlive Ermöglicht Ihnen zu bestimmen, wie lange (in Sekunden) die Nachricht auf der Site erhalten bleiben soll. Standardmäßig wird die Nachricht zwei Monate lang aufgehoben.
voice Ermöglicht Ihnen, die Stimme auszuwählen, mit der die Nachricht vorgelesen wird.

Zum Beispiel:

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

Wie versende ich eine Text-zu-Sprache-Nachricht (TTS) in einem Nabcast, der die ID 52 und den Titel “myttsinmynabcast” hat? http://api.nabaztag.com/vl/FR/api.jsp?…….nabcast=52&nabcasttitle=myttsinmynabcast&tts=the+nabcast

Wie versende ich die Nachricht 10333 in einem Nabcast, der die ID 52 und den Titel “mymp3inmynabcast” hat?http://api.nabaztag.com/vl/FR/api.jsp? ….nabcast=52&nabcasttitle=mymp3inmynabcast&idmessage=10333

Den Empfang von Ereignissen auf einem Nabaztag aktivieren

1. Wechseln Sie im Abschnitt “Extras” Ihres Accounts auf den Reiter “API”.

2. Markieren Sie die Option “Externe Ereignisse autorisieren” und klicken Sie dann auf “OK”.

3. Das Token wird angezeigt.

Bitte schreiben Sie Ihr Token auf und speichern Sie es ab oder verwahren Sie es sicher, da Sie es verwenden müssen, um Nachrichten aus Ihrer Anwendung zu versenden.

Hinweis: Wenn Sie die Ereignisse deaktivieren und erneut aktivieren, wird Ihnen ein neues Token zugesendet.

Choreografie-Sprache

Eine Choreografie ist eine Reihe von Aktionen, mit denen Sie die LEDs und die Bewegungen der Ohren steuern.

Der Hauptparameter der Choreografie ist das einstellbare Tempo.

Nachdem das Tempo eingestellt wurde, werden die Aktionen in diesem Rhythmus abgespielt. Jede Aktion wird zu einem genau definierten Moment ausgeführt, was als “l’heure” (die Zeit) der Aktion bezeichnet wird. Die Zeit wird anhand der Schläge angegeben, die seit dem Beginn der Choreografie bis zum gewünschten Ereignis vergangen sind.

Wenn das Tempo zum Beispiel eine Zehntelsekunde beträgt, beginnt die Aktion, die der “l’heure” (Zeit) ‘10′ zugeordnet ist, eine Sekunde nach dem Beginn der Choreografie. Die Aktion, die der “l’heure” (Zeit) ‘25′ zugeordnet ist, beginnt 2,5 Sekunden nach dem Beginn der Choreografie.

Die Syntax der Choreografie ist eine Reihe von Wörtern oder Zahlen, die durch Kommas getrennt sind.

Die Zahlen sind immer positive ganzzahlige Werte, die auf der Basis von 1 bis 10 angegeben werden. Wörter sind eines von diesen beiden Schlüsselwörtern: “motor” oder “led”.

Diese Serie beginn mit einem Tempo-Wert und wird dann mit einer Reihe von Motor- oder LED-Aktionen fortgesetzt.

Jede Aktion (”motor” oder “led”) beginnt mit dem Wert für “l’heure” (Zeit) (der die Anzahl der Schläge angibt, die seit dem Beginn der Choreografie bis zum gewünschten Ereignis vergangen sind), gefolgt von einem Befehl (”motor” oder “led”) und einer Reihe von Variablen, die die Aktion beschreiben.

Wenn der Befehl für zwei Aktionen zur selben Zeit erteilt wird, werden sie auch gleichzeitig ausgeführt.

1. Tempo-Befehl

Das Tempo wird in Hz ausgedrückt. “10″ steht für ein Tempo von einer Zehntelsekunde.

nach Oben

2. Ohren-Befehle

Hierbei handelt es sich um eine Reihe von Werten, die durch Kommas getrennt sind.

Ein Befehl funktioniert wie folgt:

1. Erster Wert: Aktionszeit (l’heure)

(”0″, wenn es der erste Befehl ist.)

2. Zweiter Wert: “motor”, um ein Ohr zu bewegen.

3. Dritter Wert: Ohren-Befehl

1, um das linke Ohr zu steuern.

0, um das rechte Ohr zu steuern.

4. Vierter Wert: Winkel des Ohrs

Der Wertebereich geht von 0 bis 180.

5. Fünfter Wert: Nicht verwendet, auf “0″ setzen.

6. Sechster Wert: Drehrichtung der Ohren

1 : Oben->hinten->unten->vorn->oben …

0 : Oben->vorn->unten->hinten->oben …

Ein Beispiel für einen Befehl, der das linke Ohr gegen den Uhrzeigersinn um 20° zum Zeitpunkt “l’heure” (Zeit) “0″ dreht: 0,motor,1,20,0,0

 

3. LED-Befehle

Hierbei handelt es sich um eine Reihe von Werten, die durch Kommas getrennt sind.

1. Erster Wert: Aktionszeit (l’heure)

(”0″, wenn es der erste Befehl ist.)

2. Zweiter Wert: “led” , wodurch der LED eine Farbe zugewiesen wird.

3. Dritter Wert: Definiert die LED, die Sie zum Leuchten bringen möchten.

0: untere LED

1: linke LED des Hasens

2: mittlere LED

3: rechte LED des Hasens

4: obere LED

4. Vierter, fünfter und sechster Wert: die Farbe im RGB-Format.

Der Wertebereich geht von 0 bis 255.

Beispiel: Benutzen Sie folgenden Befehl, um die mittlere LED auf Grün zu schalten, dann die linke auf Rot und zuletzt die mittlere wieder abzuschalten: 0,led,2,0,238,0,2,led,1,250,0,0,3,led,2,0,0,0

4. Kombinationen aus Ohren- und LED-Befehlen:

So kombinieren Sie die drei Aktionen mit einem anfänglichen Tempo-Parameter: 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

nach Oben

5. Die Stimme für Text-zu-Sprache (TTS) auswählen

Sie können die Stimme auswählen, mit der Ihre Nachricht vorgelesen wird.

Deutsche Stimmen:

  • Sarah
  • Helga
  • Gerhard

Französische Stimmen:

  • julie22k
  • claire22s
  • caroline22k
  • bruno22k

Englische Stimmen:

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

Italienische Stimmen:

  • Chiara
  • Roberto

Standardmäßig verwenden wir die Stimme “claire22s” für Französisch und “heather22k” für Englisch.

6. Senden Sie eine URL an einen Nabaztag/tag und erhalten Sie Streaming Audio

Die API hat eine Vielzahl neuer Funktionen und kann jetzt URLs oder News-Feeds an einen tag/tag senden.
Mit diesem neuen Feature können Sie MP3-, Podcast - und Internetradio-Content in Ihre Anwendungen einbauen. Jetzt können Sie für Ihren hochbegabten Hasen Anwendungen mit Streaming-Audio gestalten!

Wie funktioniert das?

Besitzen Sie einen tag/tag, können Sie die API zum Versenden von MP3-Hyperlinks an Ihren Hasen benutzen, damit er Podcasts und Internetradios spielt.

Sie müssen nur die URL

http://api.nabaztag.com/vl/FR/api_stream.jsp mit den folgenden Einstellungen in Ihre Anwendung einbinden :

token : Das token ist eine Ziffernfolge, die Sie erhalten, wenn Sie den Empfang von Ereignissen bei Ihrem Nabaztag aktivieren. Diese Identifizierung verringert das Spam-Risiko, da die Kenntnis der Seriennummer und des Tokens Vorraussetzung für das Senden einer Nachricht ist.

sn : Seriennummer des Nabaztag/tag, der die URLs empfängt.

urlList : URL-Adresse der MP3-Datei, die Ihr Nabaztag/tag lesen soll.

Wenn Sie mehrere MP3-Dateien hintereinander abspielen wollen, trennen Sie sie mit dem Zeichen « | ».

Beispiel - Eine Internetradiostation abspielen:

http://api.nabaztag.com/vl/FR/api_stream.jsp?token=1267440739&sn=
0013D380FD3C&urlList=http://213.205.96.91:9915

Ist der MP3-Feed verfügbar, spielt Ihr tag/tag ihn sofort.
Wenn Sie mehrere MP3-Streams abspielen wollen, trennen Sie jede URL mit dem Zeichen « | ».

http://api.nabaztag.com/vl/FR/api_stream.jsp?token=1267440739&sn=
0013D380FD3C&urlList=http://monServer.org/archive/MP3/Creative.mp3|
http://myServer.mp3.net/myFav_mp3.mp3