メインコンテンツまでスキップ
バージョン: 2.0.0

読み取りセンサー

トイオ・コレクションに付属するマットやカードには特殊なパターンが印刷されています。これを toio ID と呼びます。キューブは底面にある「読み取りセンサー」でそのパターンから固有の情報を読み取り、印刷物上での位置の特定（絶対位置検出）を行います。

読み取りセンサーが toio ID から読み取る情報は以下の特性（characteristic）を使うことで取得できます。

プロパティ値
Characteristic UUID10B20101-5B3B-4571-9508-CF3EFCD7BBAE
PropertiesRead, Notify
DescriptorID Information

toio ID の種類​

toio ID には Position ID と Standard ID の 2 種類があり、それぞれ以下のように取得できる情報が異なります。

toio ID の種類印刷されているモノの例取得できる情報
Position IDマット マットキューブの位置と角度
Standard IDカードやステッカー カードやステッカーユニークな値とキューブの角度

読み出し操作​

Position ID​

キューブがマットに印刷された Position ID から受け取った情報を、以下に示す構成のデータで取得できます。

データ位置タイプ内容例
0UInt8情報の種類0x01（Position ID）
1UInt16キューブの中心の X 座標値0x02c5（709）
3UInt16キューブの中心の Y 座標値0x017f（383）
5UInt16キューブの角度0x0132（306 度）
7UInt16読み取りセンサーの X 座標値0x02bc（700）
9UInt16読み取りセンサーの Y 座標値0x0182（386）
11UInt16読み取りセンサーの角度0x0132（306 度）

座標（X 座標、Y 座標）​

X 座標および Y 座標は Position ID が印刷されたマットの上での位置を示す座標です。 toio ID 独自に定義されているもので、単位はミリメートルではありません。 トイオ・コレクションのマットには以下のような座標が割り振られています。

ID detection coordinate system

角度​

角度はマット上での向きです。以下の図において X 軸方向が 0 度で時計回りが正となる値です。 値の範囲は 0 度から 360 度です。

ID detection angle

Standard ID​

キューブがカードやステッカーなどに印刷された Standard ID から受け取った情報を、以下に示す構成のデータで取得できます。

データ位置タイプ内容例
0UInt8情報の種類0x02（Standard ID）
1UInt32Standard ID の値0x00380000
（3670016: タイフーン）
5UInt16キューブの角度0x0015（21 度）

Standard ID の値​

トイオ・コレクションに含まれる Standard ID が印刷されたアイテムと取得できる値の一覧は以下のとおりです。 この値を取得することでキューブがどのアイテムの上に置かれているかを判断できます。

名前カード・ステッカー値
タイフーンタイフーンタイフーン・裏3670016
ラッシュラッシュラッシュ・裏3670054
オートタックルオートタックルオートタックル・裏3670018
ランダムランダムランダム・裏3670056
ツキパワーアップツキパワーアップツキパワーアップ・裏3670020
ハリテパワーアップハリテパワーアップハリテパワーアップ・裏3670058
サイドアタックサイドアタックサイドアタック・裏3670022
イージーモードイージーモードイージーモード3670060
ひだりひだり3670024
みぎみぎ3670062
まえまえ3670026
うしろうしろ3670064
GOGO3670028
スカンク（青色）スカンク（青色）3670078
スカンク（緑色）スカンク（緑色）3670042
スカンク（黄色）スカンク（黄色）3670080
スカンク（オレンジ色）スカンク（橙色）3670044
スカンク（赤色）スカンク（赤色）3670082
スカンク（茶色）スカンク（茶色）3670046
スピードアップスピードアップ3670066
スピードダウンスピードダウン3670030
ふらつきふらつき3670068
パニックパニック3670032
スピンスピン3670070
ショックショック3670034
クラフトファイタークラフトファイター3670048
リズム＆ゴーリズム＆ゴー3670052
スカンクチェイサースカンクチェイサー3670086
フィンガーストライクフィンガーストライク3670050
フィンガーストライク 1 人プレイフィンガーストライク１人プレイ3670088
フリームーブフリームーブ3670084

キューブの角度​

キューブの角度は Standard ID が印刷されたアイテム上でのキューブの向きです。 値の範囲は 0 度から 360 度です。

Position ID missed​

キューブが Position ID の印刷されたマットの上から取り除かれたという情報を、以下に示す構成のデータで取得できます。

データ位置タイプ内容例
0UInt8情報の種類0x03（Position ID missed）

Standard ID missed​

キューブが Standard ID の印刷されたカードやシールの上から取り除かれたという情報を、以下に示す構成のデータで取得できます。

データ位置タイプ内容例
0UInt8情報の種類0x04（Standard ID missed）

通知​

読み取りセンサーの読み取る情報が変化すると、この特性は BLE セントラルに情報を通知します。 通知される情報の内容とデータの構造は読み出し操作で得られるものと同じです。