Routage des entrées

Sous Android 9 et versions antérieures, il n'était pas possible d'interagir avec plusieurs écrans par commande 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 auxquels appartiennent les différents écrans. L'association est effectuée par des numéros de port, où port fait référence au port physique auquel un écran est connecté.

Par exemple, si un appareil Android possède deux ports HDMI libellés hdmi1 et hdmi2, les valeurs du port 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. Cela permet aux fabricants d'appareils de 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 du hub d'événements.

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, celui-ci 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 l'implémentation d'un 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 (tel qu'un pavé tactile) lorsqu'il est connecté à l'écran externe, puis une configuration de routage peut être fournie pour cibler l'entrée depuis un 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 qui correspond au port spécifié pour InputDevice.location.
  • Si un port de périphérique d'entrée est spécifié dans le fichier de mappage et qu'il n'existe actuellement aucune fenêtre d'affichage avec un port d'affichage correspondant, le périphérique 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, la fenêtre d'affichage est définie conformément aux règles existantes.
  • Aucune modification du noyau n'est requise dans les pilotes d'entrée.
  • Les ports des périphériques d'entrée sont déterminés à l'aide de l'ioctl EVIOCGPHYS.