はじめに

「Node.jsって何？」というレベルのプログラミング初心者がtoioのJavaScriptライブラリで開発を始めるまでに、時間がかかったので、手順を備忘録としてまとめておきます。参考にして頂ければ幸いです。

動作環境

Windows11
Node.js：v20.11.0
npm：10.2.4
yarn：1.22.21

必要なもの

Bluetooth USBアダプタ
Windowsで環境構築する場合、toio.jsが使用している「noble」ライブラリの関係で、内蔵Bluetoothではなく、別途Bluetooth4.0 USBアダプタが必要になります。
今回は、エレコムのアダプタを使用しましたが、問題なく動作しました。
Bluetooth(R) USBアダプター　LBT-UAN05C2

詳細はnobleの前提条件に書かれています。

ただし、後ほどドライバーを書き換える作業をすると、Bluetooth USBアダプタとして使用できなくなるので、注意してください

手順１　Node.jsをインストール

Node.jsの公式から推奨のLTS版をダウンロード
toioのGitHubによると、10以上のバージョンであれば動作するようです。
ダウンロードできたら、インストーラーを起動
「node-v20.11.0-x64.msi」というようなファイル名でダウンロードできているはずです。
基本的にデフォルトのままで大丈夫ですが、この画面では、チェックを入れてインストールしてください
チェックを入れることで、環境構築に必要なツール諸々が自動でインストールされます。

1.「Finish」を押して完了
正常に動くか確認する
インストールできたら、コマンドプロンプトを起動して正常に動いていることを確認します。

Windowsの検索窓から「cmd」と入力して、コマンドプロンプトを起動

以下のコマンドを実行して、

node.jsバージョン確認

node --version

ダウンロードしたバージョンが表示されれば、正常にインストールできています。

node.jsバージョン確認結果

v20.11.0

パッケージ管理システムのnpmについても確認します。

npmバージョン確認.

npm --version

npmバージョン確認結果.

10.2.4

・参考サイト

手順２　yarnをインストール

npmと同じパッケージ管理システムであるyarnがtoio.jsでは使われているため、インストールします。

npmでyarnをインストール.

npm install -g yarn

正常に動くか確認する

yarnバージョン確認.

yarn -v

yarnバージョン確認結果.

1.22.21

・参考サイト

手順３　Zadigをインストール

Zadigを使用してアダプターのドライバーを書き換えます。

Zadingの使い方は以下のYouTubeを参考にしました。
https://youtu.be/mL9B8wuEdms?si=rfwEdVUxDTn7RDeQ&t=105

Zadingのページから「Download」項目の「Zading 2.8(versionによって異なる)」をクリックしてインストール
「zadig-2.8.exe」を起動
「Options」の「List All Devices」にチェックを入れる
USBアダプタを接続し、リストから選択
WinUSB(v6.1.7600.16385)を選択
「Reinstall Driver」を実行
※注意
これを実行するとBluetooth USBアダプタとして機能しなくなります
node-bluetooth-hci-socketのGitHubにロールバックすると戻ると書いてありますが、戻りませんでした。
「The driver was installed successfuly」が表示されたら完了です

手順４　Gitをインストール

toio.jsのGitHubからファイル一式をダウンロードするために、Git Bashをインストールします。

gitのページからダウンロード
https://gitforwindows.org/
インストーラーを起動
「Git-2.43.0-64-bit.exe」がダウンロードされたら、デフォルト設定のままインストールします。
正常に動くか確認する
インストールが終わったら、コマンドプロンプトで正常にインストールできているか確認します。

Gitバージョン確認.

git -v

Gitバージョン確認結果.

git version 2.43.0.windows.1

・参考サイト

手順５　toio.jsをローカル環境に複製する

toio.jsのGitHubに移動して、URLをコピー
コマンドプロンプトを開いて作業環境のディレクトリに移動
今回はC:\Users\ユーザー名に複製する
以下のコマンドを実行
完了すると「toio.js」というフォルダができているはずです。

リポジトリをクローン.

git clone https://github.com/toio/toio.js.git

手順６　yarnのインストールとビルド

cdコマンドでtoio.jsディレクトリに移動し、以下のコマンドを実行
package.jsonが設置されます

yarn install

yarn build

手順７　nobleをインストール

toio.jsを展開したディレクトリで、以下のコマンドを実行し、nobleをインストールします。

nobleのインストール.

npm install noble

※実行後、バージョン違いによるエラーが起きる場合は、以下のように、
--legacy-peer-depsを追加することで、強制的にインストールできます。

npm install --legacy-peer-deps noble

ここまでの手順が正常に終われば、環境構築は完了です。

手順８　サンプルプログラムを実行

サンプルプログラムは「examples」の中に３つ用意されています。
実行方法はGitHubに書かれています。
https://github.com/toio/toio.js#video_game-example

今回は、keyboard-controlを試します。
toio.jsに移動し、以下のコマンドを実行します。
toio Cubeの電源が入っていることを確認してください。

keyboard-control実行.

yarn example:keyboard-control

Bluetoothが自動で接続され、キーボードの矢印キーでtoioを動かすことができます。

参考サイト