Laporan fitur pengontrol radial Windows
Topik ini merinci laporan fitur 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 (melalui pengumpulan umpan balik haptik) untuk mengomunikasikan dukungan bentuk gelombang umpan balik haptik dan memungkinkan host untuk mengonfigurasi umpan balik haptik pada perangkat pengontrol radial Windows. Jika perangkat memilih untuk mengekspos koleksi umpan balik haptik, beberapa penggunaan wajib untuk memungkinkan konfigurasi umpan balik haptik otomatis didukung.
| Anggota | Deskripsi | Halaman | ID | Wajib/Opsional |
|---|---|---|---|---|
| Daftar Bentuk Gelombang | Daftar bentuk gelombang haptik yang diurutkan yang didukung oleh perangkat | 0x0E | 0x10 | Wajib |
| Daftar Durasi | Daftar durasi yang diurutkan untuk bentuk gelombang dalam Daftar Bentuk Gelombang | 0x0E | 0x11 | Wajib |
| Pemicu Otomatis | Bentuk gelombang untuk diaktifkan secara otomatis atas kebijaksanaan perangkat | 0x0E | 0x20 | Wajib |
| Kontrol Terkait Pemicu Otomatis | Penggunaan HID kontrol yang terkait dengan umpan balik haptik | 0x0E | 0x22 | 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 |
| Waktu Cutoff Bentuk Gelombang | Waktu maksimum bentuk gelombang Pemicu Manual dapat diputar sebelum diputus | 0x0E | 0x28 | Opsional |
Daftar Bentuk Gelombang
Penggunaan Waveform List mewakili kumpulan penggunaan HID dari bentuk gelombang yang didukung, diurutkan menggunakan ordinal. Bentuk gelombang haptik yang telah ditentukan sebelumnya didefinisikan dalam spesifikasi HID. Windows mendukung penerapan bentuk gelombang berikut untuk perangkat yang mengaktifkan umpan balik haptik:
| Gelombang | Deskripsi | Halaman | ID | Wajib/Opsional |
|---|---|---|---|---|
| WAVEFORM_NONE | No-op. Seharusnya tidak berdampak pada status bermain bentuk gelombang yang sedang berlangsung. | 0x0E | 0x1001 | Wajib |
| WAVEFORM_STOP | Menghentikan pemutaran bentuk gelombang yang sedang berlangsung. | 0x0E | 0x1002 | Wajib |
| WAVEFORM_CLICK | Membuat umpan balik "klik" singkat | 0x0E | 0x1003 | Wajib |
| WAVEFORM_BUZZ_CONTINUOUS | Buzzes perangkat untuk durasi waktu yang lama | 0x0E | 0x1004 | Opsional |
Baik WAVEFORM_NONE maupun WAVEFORM_STOP diperlukan untuk semua perangkat haptik yang mematuhi HID. Ordinal 1 dan 2 secara implisit diatur ke WAVEFORM_NONE dan WAVEFORM_STOP. Mereka tidak perlu dideklarasikan dalam Daftar Bentuk Gelombang atau Daftar Durasi. Daftar Bentuk Gelombang mendeklarasikan bentuk gelombang yang didukung dengan minimum fisik dan maksimum setiap ordinal dalam daftar.
Daftar Durasi
Penggunaan Daftar Durasi mewakili kumpulan durasi untuk bentuk gelombang yang didukung dalam daftar Bentuk Gelombang, diurutkan menggunakan ordinal. Unit untuk durasi bentuk gelombang adalah milidetik, dan durasi harus berupa nilai non-nol positif untuk bentuk gelombang yang tidak berkelanjutan. Jika bentuk gelombang berkelanjutan (akan diputar sampai dihentikan oleh host atau Waktu Cutoff Bentuk Gelombang terlampaui), maka durasinya didefinisikan sebagai nol.
WAVEFORM_NONE dan WAVEFORM_STOP diasumsikan memiliki durasi nol. Mereka tidak perlu dideklarasikan dalam Daftar Durasi.
Pemicu Otomatis
Penggunaan Pemicu Otomatis mewakili penggunaan bentuk gelombang yang didukung dari Daftar Bentuk Gelombang yang akan dipicu secara otomatis oleh perangkat sesuai kebutuhan berdasarkan interaksi pengguna. Ini memungkinkan respons latensi lebih rendah terhadap interaksi pengguna umum seperti rotasi dan mengklik. Ini mungkin perlu dimodifikasi atau dinonaktifkan oleh host, dan dapat diatur melalui laporan fitur. Bentuk gelombang Pemicu Otomatis dapat dinonaktifkan dengan diatur ke nol oleh host.
Kontrol Terkait Pemicu Otomatis
Kontrol Terkait Pemicu Otomatis menentukan penggunaan HID yang diperluas dari kontrol fisik yang terkait dengan umpan balik haptik otomatis pada perangkat. Untuk perangkat pengontrol radial, kontrol ini harus didefinisikan sebagai penggunaan Putar nomor yang ditentukan dalam koleksi tingkat atas yang sama.
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.
Jika ditentukan dalam laporan fitur, ini mengatur intensitas default untuk semua bentuk gelombang Pemicu Otomatis dan Pemicu Manual untuk perangkat.
Jumlah Ulangi
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.
Jika ditentukan dalam laporan fitur, ini mengatur jumlah pengulangan default untuk semua bentuk gelombang Pemicu Otomatis dan Pemicu Manual untuk perangkat.
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.
Jika ditentukan dalam laporan fitur, ini mengatur periode pengambilan default untuk semua bentuk gelombang Pemicu Otomatis dan Pemicu Manual untuk perangkat.
Waktu Cutoff Bentuk Gelombang
Penggunaan Waveform Cutoff Time mewakili jumlah waktu maksimum perangkat akan memungkinkan bentuk gelombang Pemicu Manual diulang sebelum mengakhiri pemutaran. Ini adalah nilai konstan untuk perangkat dan mencakup bentuk gelombang berkelanjutan tanpa durasi yang ditetapkan, dan bentuk gelombang dengan durasi diskrit yang diatur untuk diulang berkali-kali. Unit untuk nilai ini adalah milidetik.