メインコンテンツまでスキップ

エンジン制御

このモジュールには、エンジン制御に関連する関数が含まれています。

関数​

このモジュールは、特定のタスクに対応し、さまざまな目的に向けたユーティリティを提供する関数群を提供します。利用可能な関数を参照して、このモジュールが提供する機能を最大限に活用してください。

記事​

interhaptics_init​

この関数は、Interhaptics Engine のさまざまなコンポーネントとモジュールを初期化します。

  • Haptic Material Manager: ハプティック効果のロードと保存を担当するモジュール
  • Human Avatar Manager: デバイス、ヒューマンアバター、体験の間のマッピングを担当するモジュール
  • Haptic Event Manager: ハプティックソースの制御を担当するモジュール

構文:

interhaptics_init()

戻り値:

ブーリアン

interhaptics_quit​

この関数は、Interhaptics Engine のさまざまなコンポーネントとモジュールをクリーンアップします。アプリケーションを終了する前に呼び出す必要があります。

構文:

interhaptics_quit()

戻り値:

N/A

interhaptics_set_global_intensity​

この関数は、エンジン全体のグローバルレンダリング強度係数を設定します。

構文:

interhaptics_set_global_intensity(intensity)
引数データ型説明
intensity実数正の値です。0 は何もありません。基本値は 1 です。

戻り値:

N/A

interhaptics_get_global_intensity​

この関数は、エンジン全体のグローバルレンダリング強度係数を取得します。

グローバル強度を返します。ミキサーが初期化されていない場合は -1 を返します。

構文:

interhaptics_get_global_intensity()

戻り値:

実数

interhaptics_add_hm​

この関数は、.haps ファイルの内容を Interhaptics Engine に追加し、後で使用できるようにします。他の関数で使用するための、新しいハプティック効果への参照を返します。

構文:

interhaptics_add_hm(content)
引数データ型説明
contentストリングスロードする .haps ファイルの JSON 内容です。Interhaptics の .haps 形式に従う必要があります。

戻り値:

実数

interhaptics_add_parametric_effect​

この関数は、振幅、ピッチ、トランジェントなどのパラメータを処理してハプティック効果を作成します。指定された入力パラメータに基づいてハプティック効果を生成し、オプションでループさせることもできます。

作成されたハプティック効果の ID を返します。

構文:

interhaptics_add_parametric_effect(amplitude, pitch, freq_min, freq_max, transient, is_looping)
引数データ型説明
amplitude実数の配列振幅値の配列です。Time -- Value のペアとしてフォーマットする必要があります。Value は 0 から 1 の間です。
pitch実数の配列ピッチ値の配列です。Time -- Value のペアとしてフォーマットする必要があります。Value は 0 から 1 の間です。
freq_min実数周波数範囲の最小値です。
freq_max実数周波数範囲の最大値です。
transient実数の配列トランジェント値の配列です。配列は Time -- Amplitude -- Pitch のトリプレットとしてフォーマットする必要があり、Amplitude と Pitch の値はどちらも 0 から 1 の範囲です。
is_loopingブーリアン効果をループさせるかどうかを示します。

戻り値:

実数

interhaptics_delete_hm​

この関数は、既存のハプティック効果を削除します。

構文:

interhaptics_delete_hm(material_ref)
引数データ型説明
material_ref実数削除するハプティック効果の ID です。

戻り値:

N/A

interhaptics_update_hm​

この関数は、既にロードされているハプティック効果の内容を置き換え、置き換えが成功したかどうかを返します。これは、ハプティック効果の ID を永続的に保つ必要がある場合に役立ちます。

構文:

interhaptics_update_hm(material_ref, content)
引数データ型説明
material_ref実数置き換えるハプティック効果の ID です。
contentストリングスロードする .haps ファイルの JSON 内容です。Interhaptics の .haps 形式に従う必要があります。

戻り値:

ブーリアン