Rapports de sortie du contrôleur radial Windows
Cette rubrique détaille les rapports de sortie 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 appareil 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 commentaires haptiques (Page 0x0E, Utilisation 0x01) dans le contrôleur radial Windows TLC. Pour plus d’informations sur la façon dont la spécification HID prend en charge les commentaires haptiques, consultez la page Ratification haptique de la spécification HID.
L’hôte utilise les utilisations suivantes dans un rapport de sortie (par le biais de la collection de commentaires haptiques) pour permettre à l’hôte d’émettre des événements de commentaires haptiques sur l’appareil du contrôleur radial Windows. Si un appareil choisit d’exposer une collection de réactions tactiles, certaines utilisations sont obligatoires pour permettre la prise en charge des réactions tactiles initiées par l’hôte.
| Membre | Description | Page | id | Obligatoire/facultatif |
|---|---|---|---|---|
| Déclenchement manuel | Forme d’onde à déclencher en tant que commande explicite à partir de l’hôte. | 0x0E | 0x21 | 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 |
Déclencheur manuel
L’utilisation du déclencheur manuel représente une utilisation prise en charge de la forme d’onde de la liste des formes d’onde qui a été demandée à être lue par l’hôte. Lorsqu’un rapport de sortie contenant un déclenchement manuel autre que WAVEFORM_NONE est envoyé à l’appareil, il doit immédiatement commencer à lire l’onde spécifiée avec les propriétés supplémentaires incluses dans le rapport de sortie (Intensité, Nombre de répétitions, Période de redéclenchement). Lorsqu’un rapport de sortie contient un déclenchement manuel de WAVEFORM_STOP, toute lecture de l’onde en cours doit être arrêtée.
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é.
Lorsqu’elle est définie dans un rapport de sortie, cette valeur remplace l’intensité par défaut pour la forme d’onde du déclencheur manuel définie dans le même rapport de sortie. Cela ne définit pas une nouvelle intensité par défaut.
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 délai de coupure de forme d’onde a été dépassé, toutes les répétitions incomplètes doivent être ignorées.
Lorsqu’elle est définie dans un rapport de sortie, cette valeur remplace le nombre de répétitions par défaut pour la forme d’onde de déclencheur manuel définie dans le même rapport de sortie. Cela ne définit pas un nouveau nombre de répétitions par défaut.
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.
Lorsqu’elle est définie dans un rapport de sortie, elle remplace la période de réinitulation par défaut pour la forme d’onde du déclencheur manuel définie dans le même rapport de sortie. Cela ne définit pas de nouvelle période de nouvelle tentative par défaut.