読み込み中...

Haply デバイス向けのサービスランタイムおよびランタイム SDK です。便利なインストーラーにまとめられています。「external」サービスとも呼ばれます。
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 を処理してください。このリリースで利用可能なすべてのダウンロード: