Kit タブ
Kit タブ（副題 Vibration Clips）は Studio で最もよく使うタブです。WAV 触覚素材を Library で管理し、それらを Kit にまとめてデバイスへ配布します。
このページは 各コントロールが何をするか の網羅リファレンスです。「最初の Kit を作る手順」は 最初の Kit を作る、「Kit の作成・配布のワークフロー」は Kit を作って配布する、Kit / Event ID / manifest の概念は Event ID と Kit を参照してください。
- タブ切替 — Kit / UI / Manage を切り替え（現在 Kit）
- ツールバー — 表示切替（side / stacked）・クリップ詳細（
i）・操作説明（?） - Library パネル — 素材クリップの一覧（検索・並び替え・Import・Amp プリセット）
- Kit Editor パネル — 選択中 Kit（図は
demo-kit）に含まれる Events - モード説明 — 各再生モード（FIRE / CLIP / BOTH）の比較を開く
- モード選択レール — 各 Event の FIRE / CLIP / BOTH
- Deploy / Save Folder — デバイスへ転送 / フォルダへ書き出し
※ 画像はデモ表示（匿名のサンプルデータ）。
レイアウトとビューモード
Section titled “レイアウトとビューモード”Kit タブは 2 ペイン構成です。
- Library パネル: WAV 素材の一覧（左 / 上）
- Kit Editor パネル: 選択中 Kit に含まれる Event の一覧（右 / 下）
ツールバー左端の view mode トグル で 2 つの配置を切り替えます。
| ボタン | モード | 配置 |
|---|---|---|
⊥ | side | Library 左・Kit Editor 右（左右分割） |
─ | stacked | Library 上・Kit Editor 下（上下分割、境界をドラッグでリサイズ可） |
選択したビューモードは保存され、次回も復元されます。
共通ツールバー
Section titled “共通ツールバー”
- 表示切替 — Library を左（side）/ 上（stacked）
- クリップ詳細（
i） — 長さ・ch・サイズ等の表示 ON/OFF - 操作説明（
?） — マウス / キーボード操作の一覧
ペイン上部のツールバーにあるコントロール。
| コントロール | 役割 |
|---|---|
view mode（⊥ / ─） | Library を左 / 上どちらに置くか |
i（info toggle） | クリップ詳細（長さ・チャンネル・サンプルレート・サイズ・Note）の表示 ON/OFF |
?（操作説明） | マウス / キーボード操作のチートシートをポップオーバー表示。詳細は ショートカット一覧 |
| DevicePill | 接続中デバイスの状態を表示 |
| Vol ピル | 接続中デバイスのボリューム（MCP4018 wiper）を Vol {wiper}/128 ({percent}%) で表示（接続時のみ） |
Library パネル
Section titled “Library パネル”
- Library フォルダ — WAV 素材フォルダの指定
- 検索 — 名前 / タグ / グループでフィルタ
- フラット / ツリー — 一覧表示の切替
- Import — WAV を追加（隣の Refresh でディスク再スキャン）
- Amp プリセット — Amp 設定の保存 / 読込
WAV 触覚素材ファイルの一覧です。Library フォルダから自動 import されます。
Library フォルダチップ（📁 Library）
Section titled “Library フォルダチップ（📁 Library）”WAV 素材を置くフォルダを指定します。ここから Studio が clips/ / メタデータを読み書きします。
- 未指定時:
+ Libraryボタンでフォルダを選択 - 指定済み時: フォルダ名表示 +
⇄（変更） /×（解除）
Library ツールバー
Section titled “Library ツールバー”| コントロール | 役割 |
|---|---|
| Search ボックス | 名前 / タグ / グループでフィルタ |
| Sort セレクト | 並び順。名前 ↑ / ↓・更新日時 (新しい順 / 古い順)・長さ (短い順 / 長い順) の 6 通り（永続化） |
| + Import | ファイルダイアログから WAV / mp3 / ogg / flac / aac / m4a を追加。2 件以上は進捗バー表示 |
| Refresh | ディスク上の clips/ を再スキャン（新規 / 削除を反映）。ウィンドウ復帰時にも自動実行 |
フラット / ツリー（= / ▸） | 一覧をフラット表示するか、素材ファイルのフォルダ構造でグループ表示するか |
Amp プリセットバー
Section titled “Amp プリセットバー”Library 側の Amp（libraryIntensity）を一括で保存 / 読込します。
- プリセット選択:
(new)（全クリップの Amp を 0.5 にリセット）＋保存済みプリセット。選ぶと即適用 - Save as…: 現在の Amp 設定を新規プリセットとして保存（既定名
amp-YYYYMMDD、同名は上書き確認） - Delete: 選択中プリセットを削除（確認あり）
クリップカード
Section titled “クリップカード”各素材ファイルが 1 カードとして並びます。
| 要素 | 説明 |
|---|---|
| ▶ / ■ | 再生 / 停止。Helper + デバイス接続時は実機で振動、未接続はブラウザ音声でプレビュー |
| 名前（インライン編集） | クリックで rename。使用可能文字は英小文字 / 数字 / - / _（違反は警告） |
| Amp スライダー | 基準振動強度（0〜100%、5% ステップ）。数値クリックで直接入力 |
| + Kit | 選択中（アクティブ）Kit に追加。アクティブ Kit が無いと無効 |
| Edit | 詳細モーダル（Name / Note / Group / Tags の編集、Swap、Archive） |
| × Archive | クリップを clips/archive/ に退避（Studio から非表示・確認なし・ファイルを戻せば復活） |
| ⇅ Swap | クリップ名 ↔ Note を入れ替え（素材ファイル名を一時退避してリネームしたいとき）。Note が空だと無効 |
i（info toggle）が ON のときは、カード下部に 長さ / チャンネル（Mono/Stereo）/ サンプルレート / ファイルサイズ / Note が表示されます。
ドラッグ＆ドロップ: クリップを Kit Editor パネルへドラッグして追加できます。
Library の Edit モーダル
Section titled “Library の Edit モーダル”「Edit」で開くクリップ詳細モーダル。
- Name（英小文字 / 数字 /
-/_、最大 64 文字） - Note（自由記述メモ。import 時は原ファイル名が自動セットされ、カード hover で表示）
- Group（整理用ラベル。例
impacts） - Tags（チップ形式。Enter で追加、
×で削除） - ⇅ Swap（Name ↔ Note。Name 側は拡張子除去 + 英数字 sanitize）
- Archive（確認ダイアログ後に
clips/archive/へ退避）
Kit Editor パネル
Section titled “Kit Editor パネル”
- Kit 作成 — Kit 名を入力して Create（Name / Version / Target Device もこの領域で編集）
- 容量ゲージ（青）— FIRE クリップが使う flash 容量（表示専用だが重要）
選択中の Kit に含まれる Event の一覧です。
Kit フォルダチップ（📦 Kit）
Section titled “Kit フォルダチップ（📦 Kit）”Kit のビルド成果物（manifest.json + install-clips/ + stream-clips/）の書き出し先。未指定なら Library フォルダ直下に <kitId>/ を作成します。Unity の Assets/.../Kits/ を指定すると SDK が Kit を直接読めます（Kit を作って配布する）。
新規 Kit 作成
Section titled “新規 Kit 作成”入力欄 + Create で Kit 名を入力して作成します。Kit 名は フォルダ名 + manifest.name + Event ID の prefix で共通利用され、命名規則は ^[a-z][a-z0-9-]*$（英小文字始まり・英小文字 / 数字 / -）。違反文字は入力時点で除去されます。
Kit リストと Kit 詳細
Section titled “Kit リストと Kit 詳細”各 Kit 行は [▸/▼] [Kit 名] [N events] [×] で、クリックで開閉します。アクティブ Kit を開くと詳細が展開されます。
Kit メタ
- Name（インライン編集、
^[a-z][a-z0-9-]*$。無効時は赤字でエラー表示） - Version（semver 慣習・強制なし）
Target Device（折りたたみ / 任意）— Kit 作者が調整したハードウェア設定を manifest に記録します。
| フィールド | 内容 |
|---|---|
| Board | 対象基板（例 duo_wl_v3） |
| FW min | 必要ファーム最低バージョン（firmware_version_min） |
| Volume level / Wiper (0-127) / Volume steps | 基準ボリューム。⟳ デバイスから取り込む で接続中デバイスの現在値を反映 |
Capacity ゲージ — install-clips/（FIRE モード）が消費するデバイス flash 容量を可視化します。Kit が空き容量を超えると赤く警告します（超過してもデプロイ自体は可能）。デバイス未接続時は推定値表示です。
Events ヘッダーと一括操作
Section titled “Events ヘッダーと一括操作”
- モード説明 — FIRE / CLIP / BOTH の比較を開く
- 一括変更 — 全 Event を一括でモード切替
- イベント操作 — Amp スライダー / Edit / Swap / 削除
- モード選択レール — FIRE / CLIP / BOTH（Event ごと）
- Events（N） と Kit 容量を表示（容量は FIRE モードのクリップのみが対象）
- Sort セレクト: Library の 6 通りに加えて
追加順/追加順 (逆)（挿入順）。選択はhapbeat-studio-kit-sortに永続化 - モード説明（
?）: 各再生モードのデバイス側挙動を比較するモーダルを開く（正確な仕様は Mode を切り替える） - 一括変更… セレクト: Kit 内全 Event を
> FIRE/♪ CLIP/>♪ BOTHのいずれかに一括切替
Kit Event 行
Section titled “Kit Event 行”各 Event は Library と同じクリップカード + 右側の モードセレクタレール で構成されます。
- カード部分は Library と同一（▶ 再生 / 名前 / Amp / Edit / ⇅ Swap / × Kit から削除）。名前・Amp・Note は Library とは独立した copy（Library で後から変更しても Kit 内 Event には影響しない）
- × 削除: Kit から Event を外す（元の Library クリップは残る）
- モードセレクタ（3 択ラジオ、下記）
再生モード（FIRE / CLIP / BOTH）
Section titled “再生モード（FIRE / CLIP / BOTH）”各 Event の再生モードを 3 択で選びます（KitEvent.modes 配列の UI 表現）。
| 表示 | 記号 | manifest 内部値 | 主な用途 |
|---|---|---|---|
| FIRE | > | ['command'] | 短い one-shot・本番運用。デバイス内蔵 WAV を再生（低遅延・オフライン） |
| CLIP | ♪ | ['stream_clip'] | 長尺・動的変調・プロトタイピング。SDK が WAV を UDP ストリーム |
| BOTH | >♪ | ['command', 'stream_clip'] | 開発段階で両方を試すとき。events と stream_events の両 bucket に同じ base eventId で並存 |
モード変更や一括変更の際は、再生中プレビューは自動停止します。判断材料は Fire と Clip の違い、Studio 上の操作と制約は Mode を切り替える を参照。
Kit Event の Edit モーダル
Section titled “Kit Event の Edit モーダル”- Name（英小文字 / 数字 /
-/_。kit 内の表示名 + eventId を再構成） - Note（Event 独自のメモ。Library とは独立）
- Event ID（読み取り専用。
<kit名>.<clip名>で自動導出） - ⇅ Swap / Remove from kit（確認あり・Library 元クリップは残る）
Deploy と Save Folder
Section titled “Deploy と Save Folder”
- Deploy — ビルドして Helper 経由でデバイスへ転送
- Save Folder — フォルダに書き出し（デバイスには送らない）
Kit 詳細の下部に 2 つのボタンが並びます（手順は Kit を作って配布する）。
| ボタン | 動作 | 必要なもの |
|---|---|---|
| Save Folder | manifest.json + WAV を Kit フォルダに書き出す（デバイスには送らない） | Library / Kit フォルダ |
| Deploy | 同じビルドを行い、その zip を Helper 経由でデバイスに転送 | + Helper + オンラインの再生デバイス |
- 音声が前回保存から変わっていない Event は WAV 再エンコードがキャッシュで skip されます（Amp 調整だけなら高速）
- ボタン横の ステータスが、フォルダ未指定 / Kit 名無効 / 保存中 / 保存済み / デバイス準備状況（
Helper offline/デバイスが見つかりません/N device(s) ready）を示します - 複数デバイス選択時は各デバイスへ順に配信し、デバイスごとの進捗 / 成否が表示されます
デプロイ前チェック: Kit フォルダ指定・全 Event が空でない Event ID を持つ・Event ID が contracts 形式（category.name、[a-z0-9_-]）に合致、を満たさないとブロックされます。
永続化とデータモデル
Section titled “永続化とデータモデル”| データ | 保存先 |
|---|---|
クリップ WAV / Kit 出力（manifest.json / install-clips/ / stream-clips/） | Library / Kit ローカルフォルダ（disk が真実） |
| クリップ音声・エンコード済み WAV キャッシュ | ブラウザ IndexedDB |
| クリップ / Kit メタ・Amp プリセット | Library フォルダ内の JSON（clips-meta.json / kits-meta.json / amp-presets.json） |
| view mode・sort・info toggle 等の UI 状態 | localStorage |
ディスクの変更は自動検出されません（Refresh ボタン、またはウィンドウ復帰で再スキャン）。Kit メタは編集ごとに自動保存されますが、Kit フォルダ内の WAV / manifest は Save Folder / Deploy を押すまで書き換わりません。Kit / manifest の構造は Event ID と Kit を参照。
キーボード操作
Section titled “キーボード操作”パネル内にカーソルがある / フォーカスしているときのみ反応します（テキスト入力中は無効）。
| キー | Library | Kit Editor |
|---|---|---|
| ↑ / ↓ | 選択を上下移動（表示順） | 選択を上下移動（表示順） |
| ← / → | 選択クリップの Amp を ±5% | 選択 Event の Amp を ±5% |
| Space | 再生 / 停止 | 再生 / 停止（再生開始時にデバイス wiper を取得） |
| Enter | 選択クリップをアクティブ Kit に追加 | — |
| Delete / Backspace | — | 選択 Event を Kit から削除 |
全一覧は ショートカット一覧 を参照。
- 最初の Kit を作る — 初回チュートリアル
- Kit を作って配布する — 作成・配布の作業手順
- Mode を切り替える — FIRE / CLIP / BOTH の操作と制約
- Event ID と Kit — Kit / manifest / Event ID の概念
- Fire と Clip の違い — mode 選択の判断材料
- gain の乗算構造 — intensity が乗算チェーンのどこに入るか