Rapports de fonctionnalités du contrôleur radial Windows
Cette rubrique détaille les rapports de fonctionnalités de HID utilisés pour la prise en charge des retours haptiques du contrôleur radial dans les systèmes d’exploitation Windows 10, version 1607 et ultérieurs.
Collecte de commentaires haptiques (facultatif)
Si un périphérique de contrôleur radial Windows prend en charge le retour haptique, il peut permettre au système et aux applications d'en tirer parti en incluant une collection de retour haptique (Page 0x0E, Utilisation 0x01) dans le TLC du contrôleur radial Windows. Pour plus d’informations sur la façon dont la spécification IHM prend en charge les réactions tactiles, consultez la ratification sur la page consacrée à l’haptique de la spécification IHM.
L’hôte utilise les utilisations suivantes (par le biais de la collection de commentaires haptiques) pour communiquer la prise en charge de la forme d’onde de commentaires haptiques et permettre à l’hôte de configurer les commentaires haptiques sur l’appareil du contrôleur radial Windows. Si un appareil choisit d’exposer une collection de commentaires haptiques, certaines utilisations sont obligatoires pour permettre la prise en charge de la configuration des commentaires haptiques automatiques.
Membre | Description | Page | id | Obligatoire/facultatif |
---|---|---|---|---|
Liste des ondes | Liste triée des ondes haptiques prises en charge par l’appareil | 0x0E | 0x10 | Obligatoire |
Liste des durées | Liste triée des durées pour les ondes dans la liste des ondes | 0x0E | 0x11 | Obligatoire |
Déclenchement automatique | Onde permettant de déclencher automatiquement, à la convenance de l’appareil | 0x0E | 0x20 | Obligatoire |
Contrôle associé au déclenchement automatique | Utilisation IHM du contrôle associé à une réaction tactile | 0x0E | 0x22 | Obligatoire |
Intensité | Sortie - Intensité de l’onde de déclenchement manuel en pourcentage | 0x0E | 0x23 | Facultatif |
Nombre de répétitions | Sortie - Nombre de fois où lire l’onde de déclenchement manuel après la lecture initiale | 0x0E | 0x24 | Facultatif |
Période de redéclenchement | Sortie - Durée d’attente avant de redéclencher le déclenchement manuel lors d’une répétition | 0x0E | 0x25 | Facultatif |
Temps limite de l’onde | Durée maximale pendant laquelle une onde de déclenchement manuel peut être lue avant d’être coupée | 0x0E | 0x28 | Facultatif |
Liste des ondes
L’utilisation de la liste des ondes représente une collection des utilisations IHM des ondes prises en charge, ordonnées à l’aide d’ordinaux. Les ondes haptiques prédéfinies sont définies dans la spécification IHM. Windows prend en charge l’implémentation des formes d’onde suivantes pour un appareil compatible avec les commentaires haptiques :
Onde | Description | Page | id | Obligatoire/facultatif |
---|---|---|---|---|
WAVEFORM_NONE | No-op. Ne doit pas avoir d’impact sur l’état de lecture des ondes en cours. | 0x0E | 0x1001 | Obligatoire |
WAVEFORM_STOP | Arrête la lecture des ondes en cours. | 0x0E | 0x1002 | Obligatoire |
WAVEFORM_CLICK | Crée une brève réaction « clic » | 0x0E | 0x1003 | Obligatoire |
WAVEFORM_BUZZ_CONTINUOUS | Buzze l’appareil pendant une durée prolongée | 0x0E | 0x1004 | Facultatif |
WAVEFORM_NONE et WAVEFORM_STOP sont requises pour tous les appareils haptiques compatibles IHM. Les ordinaux 1 et 2 sont implicitement définis sur WAVEFORM_NONE et WAVEFORM_STOP. Ils n’ont pas besoin d’être déclarés dans la liste des ondes ou la liste des durées. La liste Ondes indique les ondes prises en charge par le minimum et le maximum physique de chaque ordinal de la liste.
Liste des durées
L’utilisation de la liste des durées représente une collection des durées des ondes prises en charge dans la liste des ondes, classées à l’aide d’ordinaux. L’unité de durée d’une onde est la milliseconde et cette durée doit être une valeur positive non nulle pour toute onde non continue. Si une onde est continue (est lue jusqu’à ce qu’elle soit arrêtée par l’hôte ou que le temps limite de l’onde soit dépassé), sa durée est définie comme zéro.
WAVEFORM_NONE et WAVEFORM_STOP sont supposées avoir une durée de zéro. Elles n’ont pas besoin d’être déclarées dans la liste des durées.
Déclenchement automatique
L'utilisation du déclenchement automatique représente une utilisation de forme d'onde prise en charge à partir de la liste des formes d'onde qui sera déclenchée automatiquement par l'appareil selon les besoins en fonction des interactions de l'utilisateur. Cela permet une réponse à latence plus faible aux interactions courantes de l'utilisateur comme la rotation et le clic. Cela peut devoir être modifié ou désactivé par l'hôte et peut être défini via un rapport de fonctionnalité. La forme d'onde de déclenchement automatique peut être désactivée en étant définie sur zéro par l'hôte.
Contrôle associé au déclenchement automatique
Le contrôle associé au déclencheur automatique spécifie l’utilisation étendue IHM du contrôle physique associé à un retour haptique automatique sur l’appareil. Pour un périphérique de contrôleur radial, ce contrôle doit être défini comme l'utilisation du cadran spécifiée dans la même collection de niveau supérieur.
Intensité
L’utilisation de l’intensité représente le pourcentage d’intensité maximale à appliquer à une onde. Cette valeur doit varier entre 0 et 100 %. 100 % indique que les ondes seront déclenchées par l’appareil à leur puissance maximale et 0 % indique que le transducteur haptique n’est pas activé.
S’il est défini dans un rapport de fonctionnalités, il définit l’intensité par défaut pour toutes les formes d’onde du déclencheur automatique et du déclencheur manuel pour l’appareil.
Nombre de répétitions
L’utilisation du nombre de répétitions représente le nombre de fois qu’une onde doit être répétée. Un nombre de répétitions égal à zéro indique que l’onde de déclenchement manuel ne doit être lue qu’une seule fois (pas de répétition). Si le temps limite de l’onde a été dépassé, il est prévu que toutes les répétitions incomplètes soient ignorées.
S’il est défini dans un rapport de fonctionnalités, il définit le nombre de répétitions par défaut pour toutes les formes d’onde du déclencheur automatique et du déclencheur manuel pour l’appareil.
Période de redéclenchement
L’utilisation de la période de redéclenchement représente le temps d’attente de l’appareil avant de répéter une onde de déclenchement manuel dans un rapport de sortie, selon la valeur spécifiée par le Nombre de répétitions. Les unités de cette valeur sont les millisecondes. Si la période de redéclenchement est inférieure à la durée de l’onde en cours de lecture, l’onde doit être arrêtée et redémarrée à la période indiquée par la période de redéclenchement.
S’il est défini dans un rapport de fonctionnalités, il définit la période de redéclenchement par défaut pour toutes les formes d'onde de déclenchement automatique et de déclenchement manuel pour l'appareil.
Temps limite de l’onde
L’utilisation du temps limite de l’onde représente la durée maximale pendant laquelle l’appareil permet de répéter une onde de déclenchement manuel avant de mettre fin à la lecture. Il s’agit d’une valeur constante pour l’appareil qui inclut à la fois des ondes continues sans durées définies et des ondes avec des durées discrètes qui sont définies pour se répéter plusieurs fois. Les unités de cette valeur sont les millisecondes.