.haps ファイル形式

.haps ファイル

ハプティック効果は、JSON ベースの形式で記述された .haps ファイルに保存されます。これらのファイルは Haptic Composer で編集され、アプリケーションやゲーム内で使用される際に Interhaptics Engine によってレンダリングされます。これらは、アプリケーション内の特定のイベントやインタラクションに応じてレンダリングされるハプティック信号を記述するデジタルアセットです。.haps ファイルは汎用的でプラットフォーム非依存となるよう設計されており、Interhaptics SDK が選択された周辺機器へのハプティック体験の変換を管理します。これらのファイルには、振動、スティフネス、テクスチャなど、複数のハプティックパーセプションを保存することができ、.haps ファイル内のすべてのパーセプションは同じ方法で整理される階層構造に従います。

キーフレーム

キーフレームは、ハプティック体験を精密に制御するためのハプティック効果の基本的なコンポーネントです。各キーフレームには以下の情報が含まれます:

ハプティックプロパティを変調するレンダリング空間内の位置
その位置で変調されるハプティックプロパティ

現在、.haps ファイルで変更可能なハプティックプロパティは、ハプティック信号の振幅と周波数です。これらの特性は、対象となるパーセプションや周波数帯域に応じて異なる方法で解釈されます。キーフレームで定義された位置とハプティックプロパティは、Interhaptics Engine がアプリケーション内でハプティック体験をレンダリングするために使用します。

ハプティックノート

ハプティックノートは、タイムライン上でハプティック効果を整理および管理するための便利な方法を提供する、キーフレームのグループ化です。ハプティックノートは、タイムライン上で簡単に識別および操作できる自己完結型のハプティック効果です。Haptic Composer 内でタイムライン上にドラッグするブロックがハプティックノートです。

現在、サポートされているハプティックノートには次の 2 種類があります:

トランジェント: ショックなどの短時間のハプティック効果で、Haptic Composer 上では黄色で表示されます。
ハプティック効果: Haptic Composer 上で青色で表示されるハプティックパターン。

ハプティックノートを使用することで、複数のハプティック効果やプロパティを組み合わせて、複雑なハプティック体験を作成することができます。

ハプティックメロディ

ハプティックメロディには、タイムライン上のハプティック効果のリストが含まれます。ハプティック効果は重ねることができません。ハプティックメロディは、それぞれのプロパティを持って結果に混合されます。2つの異なるメロディ上の同じ位置にハプティクスが定義されている場合、ハプティクス出力は両方の結果を同時に提供します。

例えば、高周波振動を持つハプティック効果は低周波振動を持つ別のハプティック効果と混合され、最終結果には両方の振動パターンが含まれます。すべてのデバイスがメロディに表現される広帯域のハプティック効果を提供できるわけではありません。各デバイスの機能については、デバイス統合ドキュメントを参照してください。

パーセプション

パーセプションとは、Haptic Composer を使用して作成およびレンダリング可能なさまざまな種類のハプティック効果です。現在サポートされているパーセプションは次のとおりです:

振動

振動は、時間の経過とともに発生する振動触覚イベントです。.haps ファイルにはハプティック振動の広帯域表現が保存され、トランジェント、エフェクト、複数のメロディを使用して作成できます。

スティフネス

スティフネスは、変位に関連して発生する力です。.haps ファイルにはスティフネス値の正規化された表現が保存され、デバイスの変位やデバイスの強度能力に適応させることが可能です。スティフネスは、PlayStation®5 DualSense™ ワイヤレスコントローラーなどのコントローラー向けにアダプティブトリガーフィードバックを設計するためにも使用できます。アプリケーション統合がハプティックフィードバックの実行レートを決定します。

ハプティックパーセプションは .haps ファイルに保存され、Interhaptics SDK が選択された周辺機器へのハプティック体験の変換を管理することに注意してください。