Routage des entrées

Sous Android 9 et versions antérieures, il n'était pas possible d'interagir avec plusieurs écrans via un écran tactile, car il n'existait aucun mécanisme d'association entre les écrans et les périphériques d'entrée. Par exemple, un écran tactile peut fournir une sortie vidéo HDMI (qui s'enregistrerait comme un écran sur Android) et une sortie USB pour l'écran tactile (qui s'enregistrerait comme un périphérique d'entrée). Si plusieurs appareils étaient connectés de cette manière, il serait impossible de déterminer quel appareil d'entrée appartient à quel écran. Le même problème s'applique aux appareils pliables dotés de plusieurs écrans intégrés.

Android 10 a ajouté un mécanisme permettant de spécifier les périphériques d'entrée appartenant à chaque écran. L'association est effectuée par numéros de port, où port fait référence au port physique auquel un écran est connecté.

Par exemple, si un appareil Android dispose de deux ports HDMI nommés hdmi1 et hdmi2, les valeurs des ports d'affichage peuvent être 1 et 2. Les valeurs des ports restent les mêmes, même lorsqu'un écran différent (par exemple, un modèle ou un fabricant d'écran différent) est connecté au même port HDMI physique. Les fabricants d'appareils peuvent ainsi fournir des instructions pour assembler et mettre à niveau les écrans.

L'association est configurée dans /vendor/etc/input-port-associations.xml. Exemple :

<ports>
    <port display="0" input="usb-xhci-hcd.0.auto-1.1/input0" />
    <port display="1" input="usb-xhci-hcd.0.auto-1.2/input0" />
</ports>

Dans l'exemple ci-dessus, display="0" spécifie le port auquel l'écran est connecté. input="usb-xhci-hcd.0.auto-1.1/input0" spécifie le port auquel le périphérique d'entrée est connecté. Pour déterminer les ports associés à des appareils spécifiques, utilisez la commande de terminal suivante, puis examinez la propriété location de ces appareils dans l'état d'Event Hub.

adb shell dumpsys input

Si de nombreux appareils sont connectés, appuyez sur un appareil spécifique pour examiner le tableau RecentQueue dans l'état du Gestionnaire d'entrée. Vous pouvez ensuite identifier les appareils qui ont généré l'événement le plus récent. Vous pouvez ensuite trouver l'appareil correspondant dans l'état Event Hub.

Pour déterminer les ports d'affichage attribués aux écrans connectés, utilisez adb shell dumpsys display, puis recherchez la propriété address de DisplayDeviceInfo pour chaque écran sous "Display Devices" (Appareils d'affichage). Vous pouvez également utiliser adb shell dumpsys SurfaceFlinger --display-id pour vider les informations d'identification de tous les écrans connectés. Consultez également la section Identifiants d'affichage statiques.

Si vous spécifiez une association pour un périphérique d'entrée spécifique et que l'écran correspondant n'est pas présent dans le système, le périphérique d'entrée est désactivé jusqu'à ce que l'écran correspondant s'affiche. L'association n'est effectuée que pour les appareils tactiles.

Routage pour les multi-écrans dynamiques

Android 10 vous permet de configurer des appareils multi-écrans statiques. Les associations dynamiques ne sont pas encore activées. Toutefois, certains cas d'utilisation peuvent être traités en fournissant des informations de routage pour les écrans et les panneaux d'entrée qui ne sont pas toujours présents ou en utilisant des périphériques d'entrée virtuels, puis en fournissant des informations de routage supplémentaires à ces périphériques virtuels. Si une implémentation d'appareil est compatible avec:

  • Expérience semblable à celle d'un ordinateur de bureau avec une station d'accueil : une configuration de routage peut être fournie pour cibler l'entrée de l'accessoire d'entrée connecté à la station d'accueil (identifié uniquement par le port) vers l'écran externe (identifié par le port).
  • Écran principal servant de source d'entrée (comme un pavé tactile) lorsqu'il est connecté à l'écran externe. Une configuration de routage peut alors être fournie pour cibler l'entrée à partir du panneau tactile virtuel (identifié par un ID virtuel unique) vers l'écran externe (identifié par le port).

Implémentation

  • Pour les appareils physiques, le port auquel le périphérique d'entrée est connecté et le port auquel l'écran est connecté sont utilisés pour faire correspondre les écrans avec les écrans tactiles.
  • Les mappages sont stockés dans InputReaderConfiguration.
  • TouchInputMapper.mViewport est défini sur la fenêtre d'affichage correspondant au port spécifié pour InputDevice.location.
  • Si un port d'appareil d'entrée est spécifié dans le fichier de mappage et qu'il n'existe actuellement pas de fenêtre d'affichage correspondant au port d'affichage, l'appareil d'entrée sur ce port est désactivé.
  • Si aucun port n'est spécifié pour un périphérique d'entrée particulier, le viewport est défini conformément aux règles existantes.
  • Aucune modification du noyau n'est requise dans les pilotes d'entrée.
  • Les ports de l'appareil d'entrée sont déterminés à l'aide de l'ioctl EVIOCGPHYS.