Q&A

This content is not available in your language yet.

このページは よくある質問（FAQ） と、実運用で見つかった トラブル対応事例（ページ下部）をまとめています。順次追加していきます。

接続関連

Studio でデバイスが見つからない

ファームウェアが書き込まれ、Wi-Fi 設定が済んでいるか確認
PC とデバイスが同じネットワークに繋がっているか
ファイアウォールで UDP broadcast と mDNS がブロックされていないか
Helper が起動しているか（Studio 上部の「Helper 接続中」インジケータ）
Helper のログを確認: hapbeat-helper log（Helper をインストール）

Wi-Fi 接続できない

Hapbeat は 2.4 GHz 帯のみ対応。5 GHz 専用ルーターでは動作しない
Studio の Manage タブから Wi-Fi を再設定: Hapbeat を初期設定する

VR HMD（Quest 等）から直接使いたい

Wi-Fi UDP broadcast 方式なので HMD が同じネットワークにあれば動く
HMD が AP 機能を持たないためルーターなしでは Hapbeat を AP にする必要あり

PC に Wi-Fi と有線 LAN を同時接続するとデバイスがオフラインになる

別途センサーなどを有線 LAN（イーサネット）で繋ぎ、Hapbeat を Wi-Fi で使う構成で起こります。

原因: Hapbeat の通信は UDP broadcast を使います。PC を Wi-Fi と有線 LAN の 2 つの別ネットワークに同時接続すると、Windows は通常有線を優先するため、broadcast が有線側（センサーのネットワーク）にのみ送出され、Wi-Fi 上の Hapbeat に届きません。Studio がオフライン表示になるだけでなく、同じ PC からの触覚再生にも影響します。

対処: Wi-Fi アダプターのインターフェイスメトリックを有線より小さく（優先度を高く）します。センサーへの通信は宛先指定（unicast）のため、変更後も問題なく動作します。

管理者権限の PowerShell:

# 変更前の値を控える
Get-NetIPInterface -AddressFamily IPv4 | ft InterfaceAlias,InterfaceMetric

# Wi-Fi を優先に（エイリアス名は環境に合わせる）
Set-NetIPInterface -InterfaceAlias "Wi-Fi" -InterfaceMetric 10
Set-NetIPInterface -InterfaceAlias "イーサネット" -InterfaceMetric 60

元に戻す場合:

Set-NetIPInterface -InterfaceAlias "Wi-Fi" -AutomaticMetric Enabled
Set-NetIPInterface -InterfaceAlias "イーサネット" -AutomaticMetric Enabled

GUI の場合: アダプター設定 → Wi-Fi の IPv4 プロパティ → 詳細設定 → 「自動メトリック」のチェックを外し、Wi-Fi に小さい値を設定（戻すときはチェックを戻す）。

有線（センサー）と Wi-Fi（Hapbeat）は別サブネットになるようご設定ください。将来的には Studio / Helper / SDK 側で送信インターフェイスを選べるよう改善予定です。

Kit / コンテンツ関連

Studio でビルドした Kit が転送できない

Helper が起動中か、WebSocket（localhost:7703）に接続できているか
Studio 上部の「Helper 接続中」インジケータを確認
対象デバイスがオンラインで Studio から見えているか確認

振動が鳴らない

Kit が転送されているか（Studio の Kit タブで対象デバイスへの転送状態を確認）
Event ID が合っているか
デバイスの音量（Volume）が十分高いか

その他

複数台同時に別々の振動を出したい

Group ID 機能で分離する。Address の仕組み参照。

事例（トラブル対応事例）

実際の問い合わせから一般化した事例と対処をまとめています。

バッテリー駆動中に電源が切れ、USB 給電でのみ復帰する（Band）

症状: バッテリー駆動で何度か振動させると OLED が消えて動作しなくなる。電源スイッチの入切では戻らず、USB Type-C を接続すると復帰する。電源に接続した状態では発生しない。

原因: 強い振動を再生すると一瞬だけ大きな電流が流れ、バッテリーの電圧が瞬間的に下がります。これを過放電とみなしてバッテリーの保護回路が働くと電源が遮断されます。この保護は充電（USB）を与えないと解除されないため、電源スイッチでは戻らず USB でのみ復帰します。強い振動・低い周波数の振動・残量の低下・バッテリーの劣化は、いずれもこの電圧低下を起こしやすくする要因です。

対処:

再生する振動を強くしすぎない（再生強度・音量を下げる。最も効果的）
低い周波数の強い振動を避ける
早めに充電する／連続して頻繁に使う場合は USB 給電をしながら使う
バッテリー残量表示は目安として扱う（実際より多めに表示されることがあります）
上記でも実用上支障がある場合はバッテリー劣化の可能性があるため、交換をご相談ください

インストール済み Kit が「events なし」と表示される（再起動すると直る）

症状: Kit をデバイスにデプロイした後、Manage（インストール済み Kit）で Kit は表示されるものの「events なし」（イベント 0 件）になる。一方、Manage の再生テストで Event ID を手入力すると振動は再生される。Helper と Studio を再起動すると直ることがある。

原因: PC に常駐する Helper のバージョンが古いと、Studio のログ表示を開いている間に、デバイスとの通信（Kit のイベント一覧取得）が一時的に不安定になることがあります。振動の再生（手入力の再生テスト）は別の通信経路のため影響を受けず、「一覧は空なのに再生はできる」状態になります。Helper / Studio を再起動すると通信状態がリセットされ、一時的に解消します。この不具合は新しい Helper（v0.1.4 以降）で修正済みです。

対処:

Helper を最新版に更新する（ターミナルで pipx upgrade hapbeat-helper を実行し、更新後に Helper を再起動）
Helper のバージョンは Studio 上部の Helper 表示、またはターミナルの pipx list で確認できます
更新後は、再起動での対処は不要になります