デバイス検出と宛先指定

送信はデバイスごとの unicast が標準です。まだ 1 台も見つかっていない間だけブロードキャストにフォールバックします。

接続と app 名

hb.begin(7700, "MyDevice");   // UDP ソケットを開く。app 名（16 文字以内）は OLED に表示

app 名が Hapbeat の OLED に表示されれば接続成功の合図です。アプリ終了時は hb.end() で離脱を通知します（OLED の app 名がクリアされます）。

検出

hb.begin(7700, "MyDevice");
hb.discover(1500);            // ブロードキャスト PING → 応答した全デバイスを登録

void loop() {
  hb.ping();                  // 数秒おき。これで unicast 宛先が維持される
  // ...
}

discover() はタイムアウトいっぱい待って応答した全デバイスを宛先表に登録します（最大 8 台）。以降 play / stop / stopAll とストリーミングはその全台へ unicast されます。1 台も見つからなければ従来どおりブロードキャストで送ります。

ブロードキャストが遅い理由: Wi-Fi の AP は、同じ AP に省電力状態の端末が 1 台でもいると group-addressed フレームを次の DTIM ビーコン（100〜300 ms 周期）まで保留します。 Hapbeat 側の設定では回避できません（原因は無関係な他端末のため）。加えてブロードキャストは MAC 層の ACK / 再送が無く最低レートで送られるため落ちやすくなります。unicast はどちらの影響も受けません。

宛先表のデバイスは、最後の PONG から一定時間（既定 15 秒）で外れます。loop() から数秒おきに ping() を呼んでください。全部外れると自動でブロードキャストに戻ります。

API	用途
`hb.deviceCount()`	生存している既知デバイス数（0 ならブロードキャスト送信）
`hb.deviceIp()`	最初の既知デバイス IP（1 台構成向け）
`hb.setDeviceIp(ip)`	IP を直接指定（検出不要・期限切れしない）。`0.0.0.0` で解除
`hb.poll()`	届いた PONG を取り込む（送信時にも自動で行うため任意）
`hb.setDeviceTimeout(ms)`	生存判定の窓（既定 15000）
`hb.setBroadcastOnly(true)`	常にブロードキャストで送る

宛先を絞る（target）

play / playSine 等の target 引数で宛先を指定します。判定はデバイス側でも行われるため、送り先の選び方に関わらず「target に一致しないデバイスが鳴る」ことはありません。

デバイスのアドレスは常に player_<N>/<position>/group_<M> の正規形です（既定は player_1 / group_1）。照合は位置ベースで、i 番目のセグメント同士だけを比較します。

target	意味
`""`	全デバイス
`"player_1"`	player 1 のデバイス全部（前方一致）
`"player_1/pos_neck"`	その位置のデバイスだけ
`"*/pos_neck"`	全 player の同じ位置
`"//group_2"`	group 2 のデバイス

hb.play("sample-kit.sine_100hz", 0.6f, "player_1/pos_neck");
hb.stopAll("*/*/group_2");

hb.setGroup(n) は CONNECT_STATUS に載せる送信側のグループ id で、宛先の group_<N> とは別物です。