
Haply Hub
バグ修正
このバージョンのHubでは、バージョン1.5.0で発生したデータ収集の動作変更に対応しています。一部の新規ユーザーに、設定を再度行うよう求めるプロンプトが表示される場合があります。
読み込み中...

このバージョンのHubでは、バージョン1.5.0で発生したデータ収集の動作変更に対応しています。一部の新規ユーザーに、設定を再度行うよう求めるプロンプトが表示される場合があります。

1.5.0 に存在していた不具合です。
特に重要な注意事項が一つあります。保存済みのアプリプロファイルにマウント回転が含まれ、デバイスマウントが有効な場合、アプリ起動時にその回転がデバイスマウントの上に重ねて適用されるようになりました。 1.5.0 では、デバイスマウントが回転を管理している間、Hub はこの回転を無視していたため、ワークスペースが二重に回転する可能性があります。Hub は保存済みエントリごとに1回警告を表示します。回転が意図的なものであれば警告を閉じてください。そうでない場合は、その保存済みの回転を既定値にリセットして、再度保存してください。
また、細かな変更点があります。「他のプログラムで使用中」のオーバーレイは削除されました(他のアプリがデバイスを使用中でも、デバイスパネルが 3D ビューをぼかさなくなりました)。バッジをクリックすると、その種類の機能が非表示になります。
なし。

3.5.8 は、ホットプラグと再接続およびマウントプリセットに焦点を当てたパッチリリースです。公開 C API は 3.5.7 から変更されておらず、削除されたルートもありません。デフォルト設定のクライアントに影響する変更はすべて、3.5.7 に含まれていたバグの修正と、診断情報の改善です。このサイクルの新機能は SDK のオプトインのステージスイッチの背後にあり、これらは引き続きオフで出荷されます。デフォルトのクライアントからは見えません。
3.5.7 と異なり、このリリースではデフォルトのクライアントが観測する動作が 8 か所で変わります。そのうち 5 つは広範囲に及びます。デバイスは、そのセッションが登録するまでセッションから除外されます。state.current_cursor_position はアプリケーション空間に移動します。フォースゲートはセッションごとになります。マウントの書き込みには単位回転が必要になります。中央揃えプリセットは、デバイスの現在の回転に従うようになり、custom または defaults を返すことがあります。残りの 3 つは影響範囲が限定的です。Minverse では、arm_front と defaults がセッションのマウントをリセットし、state.body_orientation の値が変わります。また、device-connection-loop は、デバイス名を指定しないレシーバーに対しても発生することがあります。それぞれの影響を受ける方と移行方法は、「潜在的な破壊的変更」の項に記載しています。
エンジニアリング向けの補足チェンジログ(__CODE_code-1__)には、ステージゲートされた API の詳細、これらの修正の内部メカニズム、設計記録へのポインタ、Issue の参照をまとめています。
device-safety-triggered イベントも再び配信されます。3.5.7 では、サービスを再起動するまでこれらが失われていました。device-connection-loop イベントを 1 回受け取ります。再接続するとすぐにグリップが戻ります。state.body_orientation とデバイスマウントの基準が、Y 軸まわりに 90 度回転しなくなりました。キャリブレーション姿勢でデバイスが再び単位行列を返します。state.current_cursor_position は、隣にある cursor_position と同様にセッションのアプリケーション空間で報告されるようになりました。そのため、指令された位置は送信時と同じ座標系で返ってきます。device not found の警告を 1 回ログに出します。その後は 10 秒ごとに、破棄されたコマンドの件数とともにリマインダーを出力し、再検出時には device found again を 1 行出力します(ベンチでは 2.5 秒間に 16,939 行出力されていました)。POST /ports/{port}/reset は、応答しないレシーバーのバックオフもキャンセルするようになりました。そのため、次の再オープン試行はすぐに行われます。ホットプラグと再接続
GET /devices?session=)で届きます。Unable to serialize が2,178行、レシーバーを抜き差ししたときには3ミリ秒で11行)。マウントとプリセット
[1, 5.5] の範囲外の有効なスケールを拒否していました。両方のトランスポートで、同じルールを適用するようになりました。つまり、いずれの軸でもゼロ付近でなければ、有限な任意のスケールを受け入れます。DELETE config/mount は config.preset に古いプリセット名を残していたため、それを再適用すると削除されたマウントが復活していました。さらに Minverse では、arm_front / defaults が現在のマウントをリセットせずに保持していました。state.body_orientation と保存されたマウント基準は、Y 軸まわりに 90 度ずれて読み取られていました(左手系のユニットは、単位回転の基準を Y 軸まわり +90 度の回転として報告していました)。デバイス設定
config.gravity_compensation(v3.0 および v3.1)と GET /{device_type}/{id}/config/gravity_compensation が更新されます。また、そのデバイスを保持している各セッションは、次のメッセージで完全な応答を1回受け取ります。3.5.7 では、デバイスの変更通知が無視され、デバイスが再接続されるまで古い値が残っていました。それ以前のファームウェアは通知を送らないため、そこでは何も変わりません。ワイヤ値
cursor_position、cursor_velocity、current_cursor_force はアプリケーション空間の値でした。基底が恒等でない場合、エコーの成分が並べ替えられて返っていました(XZ-Y では、送信値 (x, 0.090, 0.197) がエコーで (x, -0.197, 0.090) になっていました)。v3.1 の完全フレームおよびストリーミングフレームでは、セッションの基底とマウントを使って変換されるようになりました。3.5.0 以降に存在していた問題です。34 と読まれていました)。同じフレーム内の session.session_id には実際の ID が入っていました。現在は、文書化された uint32 スキーマに合わせて、完全な 32 ビット ID になりました。3.5.0 以降に存在していた問題です。GET /devices?session=)。3.5.7 では、ホットプラグの間に未設定の値として表示されていました。JSON の形式は変わりません。また、カスタムグリップがすべて省略された場合でも、既定の出力では custom_verse_grip: [] が維持されます。影響を受けるケース: フレームごとに配列の位置で機器を識別しているクライアント、あるフレームから機器が欠けたときに切断とみなすクライアント、最初のフレームの未設定の値を読み取るクライアント。移行方法: 機器は device_id をキーにしてください。機器を含む最初のフレームをその機器の接続時とみなしてください。切断の検出は配列への所属ではなく、イベントチャネルから行ってください。cursor_position および指令された目標値と一致するようになります。GET/POST/DELETE /{device_type}/{id}/config/filters/force_gate および config.filters.force_gate.gain は、機器の現在のゲインではなく、そのセッション自身の値(既定値 0.3)を報告します。影響を受けるケース: 監視用または設定用のセッションからフォースゲートを設定したクライアント、あるいは機器の現在値が返ってくると想定して読み取ったクライアント。移行方法: フォースゲートは駆動を行うセッションから設定してください。実効値は駆動中のセッションで確認してください。POST|PATCH config/mount は、二乗ノルムが 1 から 1e-3 を超えてずれたクォータニオンに対して 400 invalid mount transform (non-finite, non-unit rotation or ~zero scale axis) を返します。WebSocket の configure.mount は警告をログに出力し、以前のマウントを維持します。3.5.7 では拒否されていた [1, 5.5] の範囲外のスケールが、今回は受け付けられるようになりました。影響を受けるケース: 正規化されていないクォータニオンを送信していたクライアント、またはサービス側でスケールの上限が適用されることを前提としていたクライアント。移行方法: クォータニオンは送信前に正規化してください。希望するスケールの範囲は、クライアントの UI 側で制限してください。arm_front_centered / led_front_centered は、適用時点の機器の回転に基づいて位置を解決します。適用後に機器が 1 度を超えて回転した場合、config.preset は custom を返します(config.preset の session-updated イベントを伴います)。これは、再接続やインクウェルの再キャリブレーションの後も、クライアントからの書き込みなしに発生します。また、セッションスコープの DELETE config/mount の後には defaults を返します。影響を受けるケース: config.preset の名前に基づいて動作を決めているクライアント。移行方法: 機器を動かした後に再度中央揃えするには、プリセットを再適用してください。custom は「プリセットがもはや現在の姿勢を表していない」を意味するものとして扱ってください。arm_front_centered の位置が x = -0.13 から x = -0.12 に移動しました(実機で手動調整)。影響を受けるケース: これらのプリセットでカスタムマウントを維持することに依存していた Minverse ユーザー、または旧中心位置に対してキャリブレーションしていたユーザー。移行方法: 旧中心位置に対して行った Minverse のキャリブレーションを再確認してください。device_id はそのポートで最後に準備完了と認識された ID になり、一度もなければ空になります。attempts は一連の失敗の期間内の失敗回数を、window_ms は最初の失敗からの経過時間を数えます。ペイロードの形式は変わりません。影響を受けるケース: device_id が空になることはないと想定していたクライアント。移行方法: 空の device_id を処理してください。
🔖 リリース 7.11.0


1.4.0 で Hub に保存された値は、もう再生されません。下記の _1.4.0 からアップグレードする前に_ を参照してください。
_アップグレード時には、明示的な回答がないすべてのインストールで両方の設定がオフにリセットされ、ページが 1 度だけ確認を求めます。たとえ両方がオンだった場合や、"show on new updates" がオフの場合でも同様です。回答するか、Settings → Privacy でスイッチをオンにしてください。_
Sep 02, 2026)でローカライズされるようになり、どのタイムゾーンでも同じ暦日が表示されます。1.4.0 に存在していた不具合です。
最も重要な警告は次のとおりです。1.4.0 の Hub で handedness(利き手)または重力補正の値を保存し、Store on device… を一度も使用していない場合は、アップグレードの前、またはアップグレード直後に、その値を設定してデバイスに保存してください。 Hub は初回の読み取り時にこの保存済みエントリを削除し、以降は再生しないため、次回の電源の入れ直し時にデバイスは自身に保存された値に戻ります。ベンチのセットアップが変わる可能性があります。フィールドの Modified バッジから Store on device… を使用してください。
また、軽微な変更ですが、Input Control の Blender ジェスチャーは、ウィンドウ名に「Blender」を含むすべてのウィンドウで動作するようになりました(以前は完全一致が必要でした)。他のアプリと同様の動作です。
なし。

(heading)が 135 度から 180 度に変更されました。これは、それ以外は変更のないデフォルトのセッションにおける、3.5.6 からの唯一の想定される目に見える違いです。
ゲート制御もオプトインも不要で、ハンドルのファームウェア 1.3.1 以上のすべてのユーザーが対象です。詳細は「修正」を参照してください。
state.body_orientation が20 Hz でデバイスの姿勢を追従します(Inverse3 / Minverse ファームウェア 7.9 以降、デフォルトで有効)。
config/torque_scaling、config/gravity_compensation、config/handedness に対する DELETE は、サービスに組み込まれた固定の工場出荷時定数ではなく、デバイスが起動時に持っている値を返すようになりました。そのため、左手用として保存されたデバイスが右手用にリセットされることはなくなりました。
session-updated が送出されていました。しかも、いずれもデバイスを特定するものではありませんでした。保持しているすべてのセッションは、引き続き次のスナップショットから更新されます。
devices/*inverse/body_orientation_poll_interval_ms(デフォルトは 50 ms、0 で無効、範囲 0〜5000)により、リアルタイムの姿勢の読み取りを調整できるようになりました。ただし、50 ms のデバイスモーションタイマーが実質的な下限となります。
devices/*inverse/query_orientation_on_idle を有効にした場合、黙って無視されるのではなく、その設定が効果を持たないことが通知されます。
保持されている値自体は変更されないため、デバイスは引き続き使用できます。
config/mount または config/body_orientation の書き込みは、これまでどおりデフォルトのイベントチャネルで通知されます。取り下げられたのはデバイススコープの要因のみで、handedness、torque_scaling、gravity_compensation はセッションごとの通知を引き続き行います。
その値は設定 devices/*inverse/inkwell/dock_heading_deg になりました。2026-09-22 に、ハンドルのファームウェア 1.3.1 のスタイラスを搭載した Minverse で測定しました。従来の 135 度では、ドッキングされたペンが 45 度不足していたため、
ヨー推定器がそれを補正する必要がありました(観測値は +42〜+50 度)。残差は現在、約 5 度以内に収まっています。段階的なゲートの対象外です(ドック・キャリブレーションの処理経路は常に実行されます)。そのため、ハンドルのファームウェア 1.3.1 以上のすべてのユーザーについて、
ドッキングされたペンの公開される姿勢が 45 度変わります。このバージョンを下回るファームウェアでは、ファームウェアがこの値を無視して姿勢全体を即座に設定するため、これらのユーザーには変化はありません。
state.body_orientation は、デバイスがアイドル状態のときにのみ更新されていたため、アプリケーションが力覚のストリーミングを開始した瞬間に値が固定され、すべての利用者が古いハンドシェイクのスナップショットを読み取っていました。現在は既存のモーションタイマーでポーリングされ、セッション中もリアルタイムに更新されます。
config/torque_scaling、config/gravity_compensation、config/handedness に対する DELETE は、デバイス自身が保存している設定の上に、コンパイル時に組み込まれた工場出荷時定数を書き込んでいました。そのため、「デフォルトにリセット」とデバイスの実際の起動時状態が食い違っていました。config/handedness は、保存されていた値にかかわらず、常に right に設定されていました。現在はこの 3 つすべてで保存された値が復元され、
従来の定数は、デバイスから一度も読み取られていない項目の場合に限り使用されます。
session_id、profile、scope しか含まれず、デバイス識別子がなかったため、購読者は複製の発生元を特定することも、一連のイベントを重複排除することもできませんでした。デバイス単位の通知は、デバイスを指定する代替の仕組みが提供されるまで保留されます。セッションごとの更新には変更はありません。
DELETE config/torque_scaling、config/gravity_compensation、config/handedness は、リセットが何を意味するかを変えています。応答と書き込まれる値は、サービス側の固定定数ではなく、デバイスに保存された設定になりました。応答の形式は変わりません。値が異なるのは、保存された設定が工場出荷時定数と異なるデバイスのみです。ただし、
リテラル定数(false / {enabled: true, scaling_factor: 0.0} / right)を前提としていた連携では、異なる値が返されるようになります。
state.body_orientation は、形式と階層(tier)を変えずに、値の意味が変わります。ストリーミングクライアントにとって実質的に静的だったフィールドが、20 Hz で変化するようになります。アタッチ後は定数として扱っていた利用者は、オプトインなしで新しい動作を目にすることになります。
また、非推奨の旧来のフラットな body_orientation スコープも同じレーンに従うようになり、デフォルトのチャネルに漏れ戻らなくなりました。移行: イベントを更新のトリガーとして扱うのをやめ、
セッションのスナップショットから値を読み取ってください。スナップショットは、保持しているすべてのセッションで、オプトインを一切必要とせずに引き続き更新されます。同等のセッションスコープのイベントや、
handedness / torque_scaling / gravity_compensation の通知は影響を受けません。
ハンドルのファームウェア 1.3.1 以上のすべてのユーザーについて、オプトインなしで観測値が変わるためです。そのため、従来の 135 度の基準値に合わせて独自のアプリケーションを調整していた利用者には、実際の移行作業が必要になります。形式の変更はありません。
devices/*inverse/query_orientation_on_idle は、新しいポーリング間隔がゼロ以外であれば冗長になりますが、3.5.7 では意図的に deprecated としてフラグ付けを行っていません。その非推奨化は 3.6 で予定されています。

🔖 リリース 7.10.1


? ボタンの背後に、刷新されたアニメーション付きのイントロがあります。#<id> · <profile> と表示されます。また、Control の読み取り値はピル表示に変わり、デバイスがアイドル状態の場合は、1つの控えめなピルにまとめられます。右下隅の単独のボタンではなくなりました。
? ボタンから再度開けます。左利きに関する注意事項は、このイントロの中に含まれるようになりました。
また、オプトイン不要で動作するライブのマウント機能が含まれます。
1.3.0 に存在していた不具合です。
このリリースで最も重要な警告があります。マシンが 1.3.0 に戻る可能性が少しでもある場合は、初めて 1.4.0 を起動する前に `device-settings.json` をバックアップしてください。移行は一方向のみで、1.3.0 のビルドは移行済みのファイルを空として黙って読み込み、最初の保存時に上書きしてしまいます。元に戻す唯一の方法は、コピーを復元することです。
freeze / continuous に置き換えられています。Hub は古いサービスに対しては、引き続き古い組み合わせで通信します。今回のサイクルで非推奨になったアクション、トリガー、キーボードショートカットはありません。
リリース済みの動作のうち、把握しているもので、1.4.0 では修正しないものです。
0.3 から始まり、最初のフレームから _Modified_ と表示されます。どちらも、まずサービス側の修正が必要です。
2つ目のビューアーは、ポーリングする代わりに自身の session-updated イベントを受けて更新されます。保持しているセッションごとに正確に1回のイベントが送られ、書き込みを行ったクライアントに対して2回送られることはありません。
名前とは裏腹に、config/gravity_compensation の scaling_factor フィールドは乗数ではありません。これは、デバイス自身の重量に加えて補償する、エンドエフェクタの追加ペイロード質量(キログラム単位)です。以前のリセットは名前を額面どおりに受け取り、「中立」の係数 1 に戻していました。これは架空の1キログラムのペイロードに相当するため、リセット後はデバイスがハンドルを押し上げ続けていました。これは接続直後のデバイスの挙動とは異なります。現在のリセットでは、実際の既定値に戻ります。つまり補償は有効で、scaling_factor は 0 に設定されます。デバイスは自重のみを支え、ペイロードはないものとして動作します。アプリケーションがリセットを使って補償の強さを上げていた場合は、代わりに必要な値を明示的に設定してください。
config/home_return のリセットは、ホームリターンを無効にしていながら、有効だと呼び出し元に伝えてしまう状態になっていました。現在はリセットによって本当に工場出荷時の既定値(有効)に戻り、その後アプリケーションが読み取る値は、デバイスが実際に使用している値と一致します。scaling_factor が 1 に書き込まれることを前提にしていたアプリケーションは、代わりに工場出荷時の既定値 0 を受け取ります。いずれの場合も補償自体は有効なままです。リセットに依存せず、値を明示的に設定してください。上記の修正を参照してください。session-updated イベントは自分の書き込みによってのみ届くと想定していたアプリケーションは、同じデバイスを両方が保持している別のクライアントが変更した場合にも、そのイベントを受け取るようになります。その後、設定全体の再描画も行われます。これは上記のファンアウトによる意図された結果です。イベントを受けて再読み込みするだけのクライアントは、変更不要です。
🔖 リリース 7.10.0

ライセンスと初回起動
Freeform
1.2.0 に存在し、1.3.0 で解決されたバグ:

社内向けのアルファビルドと、安定版に到達する前に検証期間(ソーク)を経る公開ベータビルドです。
すべての安定版リリースには、事前に検証されたベータ版が先立つようになりました。
X.Y.Z-develop.N と番号付けされていた社内向けプレリリースは X.Y.Z-alpha.N になり、ベータチャンネルでは X.Y.Z-beta.N が使われます。従来の命名では、セマンティックバージョニングの優先順位規則上「develop」ビルドが「beta」ビルドより 上位 に並んでいました。
今回の名前変更により、この順序は恒久的に修正されます。
v の接頭辞が付くようになりました(3.5.5 ではなく v3.5.5)。既存の履歴では、どちらの形式も引き続き有効です。新しいリリースパイプライン全体も、公開前にエンドツーエンドでリハーサル済みです。
一方で、マルチプラットフォームのテストマトリクス全体は、リリースへのすべての昇格を引き続きゲートしています。
リリース前のテストカバレッジは変わりません。
serde クレート1.0.228 -> 1.0.229(lockfile のみのパッチ更新)、リリースツールの semantic-release
25.0.8 -> 25.0.9、および Alpine コンテナのベースイメージ 3.20 -> 3.24。
自動生成されたリリースノートには、新しいリリースパイプライン自体に関するいくつかの修正が記載されています。
これらは公開前に新規構築されたインフラを強化したものであり、利用中の SDK には影響しません。


🔖 リリース 7.9.0





*_centered プリセットの中心を、実際に到達可能な中心に合わせる (ad6e726), closes #321
🔖 リリース 7.8.0