本主題詳細說明 Windows 10 版本 1607 和更新版本操作系統中用於星形控制器觸覺回饋支援的 HID 輸出報告。
觸覺回饋收集(選擇性)
如果 Windows 星形控制器裝置支援觸覺回饋,它可以允許系統和應用程式利用它,方法是在 Windows 星形控制器 TLC 中包含觸覺回饋集合(Page 0x0E、Usage 0x01)。 如需 HID 規格如何支援觸覺回饋的詳細資訊,請參閱 觸覺頁面 批准 HID 規格。
主機會在輸出報告中使用下列使用方式(透過觸覺意見反應集合),讓主機向 Windows 星形控制器裝置發出觸覺回饋事件。 如果裝置選擇公開觸覺意見反應集合,則必須使用某些方式,才能支援主機起始的觸覺回饋。
| member | 描述 | 頁 | 識別碼 | 強制/選擇性 |
|---|---|---|---|---|
| 手動觸發程式 | 從主機以明確命令引發的電壓。 | 0x0E | 0x21 | 必要 |
| 強度 | 輸出 – 手動觸發波的強度百分比 | 0x0E | 0x23 | 選擇性 |
| 重複計數 | 輸出 – 在初始播放之後播放手動觸發電壓的次數 | 0x0E | 0x24 | 選擇性 |
| Retrigger 期間 | 輸出 – 重複時重試手動觸發程式之前等候的時間持續時間 | 0x0E | 0x25 | 選擇性 |
手動觸發程序
手動觸發程式使用方式代表由主機要求播放的電壓清單支援的電壓使用量。 當輸出報表包含非WAVEFORM_NONE的手動觸發程式傳送到裝置時,它應該立即開始播放指定的波浪線與輸出報表中包含的其他屬性(強度、重複計數、重試週期)。 當輸出報表包含手動觸發程式WAVEFORM_STOP時,應該停止任何進行中的超聲波播放。
強度
強度使用量代表要套用至超聲波的最大強度百分比。 此值應介於 0 和 100% 之間。 100% 表示裝置會以最大強度觸發超聲波,0% 表示觸覺換能器未啟用。
在輸出報表中設定時,這個值會覆寫相同輸出報表中所定義之手動觸發電壓的預設強度。 這不會設定新的預設強度。
重複計數
重複計數使用量代表重複超聲波的次數。 重複計數為零,表示手動觸發程式電壓應該只播放一次(不重複)。 如果超過電壓截斷時間,則預期會忽略任何不完整的重複。
在輸出報表中設定時,這個值會覆寫相同輸出報表中定義的手動觸發電壓的默認重複計數。 這不會設定新的預設重複計數。
Retrigger 期間
Retrigger 期間使用量代表裝置在輸出報表中重複手動觸發波紋之前所等待的時間量,根據重複計數所指定的值。 此值的單位為毫秒。 如果 Retrigger 期間小於所播放之電壓的持續時間,則應該在重試器期間所指示的時間週期停止並重新啟動電壓。
在輸出報表中設定時,它會覆寫相同輸出報表中定義的手動觸發電壓的預設重試週期。 這不會設定新的預設 Retrigger Period。