基本的な使い方

この章では、Interhaptics エクステンションの基本的な使い方について説明します。

初期化

最初に行うことは、interhaptics_init を使用してエクステンションを初期化することです。

その後、「プロバイダー」(ハプティクスフィードバックを提供できるコントローラーなどの接続デバイス)の存在を確認する必要があります。プロバイダーを初期化するには、interhaptics_providers_init を呼び出します。プロバイダーが存在するかどうかを確認するには、interhaptics_providers_available を呼び出します。

/// Create イベント
interhaptics_init();
interhaptics_providers_init();

.haps ファイルのロード

ハプティック効果は、Interhaptics で使用されるカスタムファイル形式の .haps ファイルに保存されます。

interhaptics_add_hm を使用して、.haps ファイルに保存されたハプティック効果を追加できます。

var _file = file_text_open_read("HapticMaterials/BodyHit.haps")
var _content = file_text_read_string(_file);
file_text_close(_file);

hm_index = interhaptics_add_hm(_content);

その後、このハプティック効果に対して 1 つまたは複数のターゲットを追加できます。

var _commanddata =
{
    sign: INTERHAPTICS_OPERATOR.PLUS,
    group: INTERHAPTICS_GROUP_ID.PALM,
    side: INTERHAPTICS_LATERAL_FLAG.GLOBAL
};

interhaptics_add_target_to_event(hm_index, [_commanddata]);

Interhaptics の更新

Interhaptics を更新するには、まずすべてのハプティクスイベントを計算し、次にステップごとにハプティクスを レンダリング する必要があります。

/// Step イベント
var _time = current_time / 1000;
interhaptics_compute_all_events(_time);
interhaptics_providers_render_haptics();

ハプティック効果の再生

ハプティック効果を再生するには、interhaptics_play_event を使用します。

interhaptics_play_event(hm_index, -time, 0, 0);

クリーンアップ

/// Clean Up イベント
interhaptics_providers_clean();
interhaptics_quit();