▼ナバズタグメモ▼
Nabaztag APIサンプルプログラム


Nabaztag API
Nabaztag APIを使うことでアプリケーションからナバズタグを制御できるようになる。
http://api.nabaztag.com/vl/FR/api.jspを以下のパラメータを付加して呼び出す。

パラメータ 接続
sn シリアル番号
token トークン番号
idmessage メッセージID
nabcast nabcastID
nabcasttitle nabcastタイトル
posright 右耳の位置(0〜16)
posleft 左耳の位置を(0〜16)
ears=ok 耳の位置の送信
idapp アプリケーションID
voice 声種別
tts 会話テキスト
chor choreographyの送信
chortitle choreographyのタイトル
ttlive メッセージのサイトでの保持期間(秒)
action アクション


シリアル番号とトークン番号
ナバズタグを制御するには識別するためのシリアル番号とトークンが必要。
my.violet.netにログインし「My Things」の「Settings」の「Ecosystem」を選択。



以降のサンプルを実行するには、次のテキストボックスにシリアル番号とトークン番号を入力。
シリアル番号(sn)
トークン番号(token)


ナバズタグの制御


起こす

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=14

寝かす

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=13

トーク
メッセージ
【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&voice=JP-Tamura&tts=%E3%81%BB%E3%81%92
※ttsはエンコードした文字列(JavaScriptではencodeURI())。

トークのプレビュー
メッセージ
【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&voice=JP-Tamura&tts=%E3%81%BB%E3%81%92&action=1

耳の位置の指定

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&posleft=3&posright=3
※耳の位置は0〜16で指定。



MP3の再生

【例】http://api.nabaztag.com/vl/FR/api_stream.jsp?token=XXXX&sn=XXXX&urlList=http://onosendai.jp/csc/CyberSpace271-DT-1.mp3
※複数のmp3を繋げる時は「|」で区切る。


Choregraphy言語


Choregraphy言語
「chor=」の後にパラメータを「,」区切りで並べることにより、連続した命令を送信することが可能。
1つめのパラメータはテンポで基本10を指定。


耳コマンド

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&chor=10,0,motor,0,90,0,0,0,motor,1,90,0,0
項目 説明
第1引数 アクション時間(1=100ms) 0
第2引数 motor固定 motor
第3引数 耳の指定
0:左耳
1:右耳
0
第4引数 回転角度(0〜180) 90
第5引数 0固定(未使用) 0
第6引数 回転方向
0:上→後→下→前→上
1:上→前→下→後ろ上
0


LEDコマンド

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&chor=10,0,led,1,255,0,0,5,led,2,0,255,0,10,led,3,0,0,255
項目 説明
第1引数 アクション時間(1=100ms) 0
第2引数 led固定 led
第3引数 LEDの指定
0:下端ライト
1:左LED
2:中央LED
3:右LED
4:口LED
0
第4引数 赤(0〜255) 255
第5引数 緑(0〜255) 0
第6引数 緑(0〜255) 0


情報の取得


取得する情報はXMLなので、ブラウザでは「表示→ページのソース」で閲覧。

ナバズタグの名前の取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=10

ナバズタグのバージョンの取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=8

ナバズタグが寝ているかどうかの取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=7

ナバズタグの署名の取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=5

タイムゾーンの取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=4

TTSボイスのリストの取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=9

フレンドリストの取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=2

フレンドリストの取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=2

メッセージリストの取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=3

ブラックリストの取得

【例】http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXX&token=XXXX&action=6