このトピックでは、Windows 10 バージョン 1607 以降のオペレーティング システムで放射型コントローラーの触覚フィードバックのサポートに使用される HID 出力レポートについて説明します。
触覚フィードバック コレクション (省略可能)
Windows 放射型コントローラー デバイスで触覚フィードバックがサポートされている場合は、Windows 放射型コントローラー TLC 内に触覚フィードバック コレクション (ページ 0x0E、用途 0x01) を含めると、システムとアプリケーションでこのフィードバックを利用できます。 HID 仕様がどのようにハプティクス フィードバックをサポートしているかの詳細については、「Haptics page」の HID 仕様への準拠を参照してください。
ホストは、出力レポート (触覚フィードバック コレクションから) で次の使用方法を使用して、ホストが Windows 放射型コントローラー デバイスに対して触覚フィードバック イベントを発行できます。 デバイスでハプティクス フィードバック コレクションを公開する場合、ホスト側で開始したハプティクス フィードバックをサポートするには一部の用途が必須になります。
| メンバー | 説明 | ページ | id | 必須/省略可能 |
|---|---|---|---|---|
| 手動トリガー | ホスト側からの明示的なコマンドとして起動する波形。 | 0x0E | 0x21 | Mandatory |
| 強度 | 出力 - 手動トリガー波形の強度の割合 | 0x0E | 0x23 | オプション |
| 繰り返し回数 | 出力 - 初期再生後に手動トリガー波形を再生する回数 | 0x0E | 0x24 | オプション |
| 再トリガー周期 | 出力 – 手動トリガーを繰り返すときに待機する時間長 | 0x0E | 0x25 | 省略可能 |
手動トリガー
手動トリガーの使用法は、ホストによって再生が要求されている波形リストのサポートされている波形の使用法です。 WAVEFORM_NONE 以外の手動トリガーを含む出力レポートがデバイスに送信されると、出力レポートに含まれるその他のプロパティ (強度、繰り返し回数、再トリガー周期) を使用して、指定された波形の再生がすぐに開始します。 出力レポートに WAVEFORM_STOP の手動トリガーが含まれているときは、進行中の波形の再生が停止します。
強度
強度用途は、波形に適用する最大強度の割合を表します。 この値の変動幅は、0 から 100% である必要があります。 100% はデバイスが最大強度で波形をトリガーすることを、0% はハプティクス変換器が有効になっていないことを示します。
この値は、出力レポートで設されると、同じ出力レポートで定義されている手動トリガーの波形の既定の強度をオーバーライドします。 これにより、新しい既定の強度は設定されません。
繰り返し回数
繰り返し回数用途は、波形を繰り返す回数を表します。 繰り返し回数が 0 の場合、手動トリガーの波形の再生は 1 回のみ (繰り返しなし) にする必要があることを示します。 波形カットオフ時間を超えた場合、不完全な繰り返しを無視することが期待されます。
この値は、出力レポートで設されると、同じ出力レポートで定義されている手動トリガーの波形の既定の繰返し回数をオーバーライドします。 これにより、新しい既定の繰り返し回数は設定されません。
再トリガー周期
再トリガー周期用途は、繰り返し回数で指定された値ごとに、出力レポートで手動トリガーの波形を繰り返す前にデバイスが待機する時間を表します。 この値の単位はミリ秒です。 再トリガー周期が再生される波形の時間長よりも短い場合は、再トリガー周期で指定されている周期で波形を停止してから再開する必要があります。
この値は、出力レポートで設されると、同じ出力レポートで定義されている手動トリガーの波形の既定の再トリガー周期をオーバーライドします。 これにより、新しい既定の再トリガー周期は設定されません。