Laporan output pengontrol radial Windows
Topik ini merinci laporan output HID yang digunakan untuk dukungan umpan balik haptik pengontrol radial di Windows 10, versi 1607 dan sistem operasi yang lebih baru.
Koleksi umpan balik haptic (opsional)
Jika perangkat pengontrol radial Windows mendukung umpan balik haptik, itu dapat memungkinkan sistem dan aplikasi untuk memanfaatkannya dengan menyertakan koleksi umpan balik haptik (0x0E Halaman, Penggunaan 0x01) dalam TLC pengontrol radial Windows. Untuk informasi selengkapnya tentang bagaimana spesifikasi HID mendukung umpan balik haptik, silakan lihat ratifikasi halaman Haptics ke spesifikasi HID.
Host menggunakan penggunaan berikut dalam laporan output (melalui pengumpulan umpan balik haptik) untuk memungkinkan host mengeluarkan peristiwa umpan balik haptik ke perangkat pengontrol radial Windows. Jika perangkat memilih untuk mengekspos koleksi umpan balik haptik, beberapa penggunaan wajib untuk memungkinkan umpan balik haptik yang dimulai host didukung.
| Anggota | Deskripsi | Halaman | ID | Wajib/Opsional |
|---|---|---|---|---|
| Pemicu Manual | Bentuk gelombang untuk diaktifkan sebagai perintah eksplisit dari host. | 0x0E | 0x21 | Wajib |
| Intensitas | Output – Intensitas bentuk gelombang Pemicu Manual sebagai persentase | 0x0E | 0x23 | Opsional |
| Jumlah Ulangi | Output – Frekuensi memutar bentuk gelombang Pemicu Manual setelah pemutaran awal | 0x0E | 0x24 | Opsional |
| Periode Pengambilan | Output – Durasi waktu untuk menunggu sebelum mengambil kembali Pemicu Manual saat mengulangi | 0x0E | 0x25 | Opsional |
Pemicu manual
Penggunaan Pemicu Manual mewakili penggunaan bentuk gelombang yang didukung dari daftar bentuk gelombang yang telah diminta untuk dimainkan oleh host. Ketika laporan output yang berisi Pemicu Manual selain WAVEFORM_NONE dikirim ke perangkat, laporan tersebut harus segera mulai memutar bentuk gelombang yang ditentukan dengan properti tambahan yang disertakan dalam laporan output (Intensitas, Jumlah Ulang, Periode Pengambilan). Saat laporan output berisi Pemicu Manual WAVEFORM_STOP, pemutaran bentuk gelombang yang sedang berlangsung harus dihentikan.
Intensitas
Penggunaan Intensitas mewakili persentase intensitas maksimum untuk diterapkan pada bentuk gelombang. Nilai ini harus bervariasi antara 0 dan 100 persen. 100 persen menunjukkan bentuk gelombang akan dipicu oleh perangkat pada kekuatan maksimumnya, dan 0 persen menunjukkan transduser haptik tidak diaktifkan.
Saat diatur dalam laporan output, nilai ini akan mengambil alih Intensitas default untuk bentuk gelombang Pemicu Manual yang ditentukan dalam laporan output yang sama. Ini tidak mengatur Intensitas default baru.
Jumlah pengulangan
Penggunaan Jumlah Berulang menunjukkan berapa kali untuk mengulangi bentuk gelombang. Jumlah Ulangi nol menunjukkan bentuk gelombang Pemicu Manual hanya boleh diputar satu kali (tidak ada pengulangan). Jika waktu cutoff bentuk gelombang telah terlampaui, diharapkan pengulangan yang tidak lengkap akan diabaikan.
Saat diatur dalam laporan output, nilai ini mengambil alih jumlah pengulangan default untuk bentuk gelombang Pemicu Manual yang ditentukan dalam laporan output yang sama. Ini tidak mengatur Jumlah Ulang default baru.
Periode Pengambilan
Penggunaan Periode Pengambilan mewakili jumlah waktu perangkat untuk menunggu sebelum mengulangi bentuk gelombang Pemicu Manual dalam laporan output, sesuai nilai yang ditentukan oleh Jumlah Berulang. Unit untuk nilai ini adalah milidetik. Jika Periode Pengambilan lebih kecil dari durasi bentuk gelombang yang dimainkan, bentuk gelombang harus dihentikan dan dimulai ulang pada periode waktu yang ditunjukkan oleh periode pengambilan.
Saat diatur dalam laporan output, ia mengambil alih periode pengambilan default untuk bentuk gelombang Pemicu Manual yang ditentukan dalam laporan output yang sama. Ini tidak mengatur Periode Pengambilan default baru.