Partager via


Saisie au clavier dans Unity

Espace de noms :UnityEngine
Type : TouchScreenKeyboard

Bien que HoloLens prenne en charge de nombreuses formes d’entrée, y compris les claviers Bluetooth, la plupart des applications ne peuvent pas supposer que tous les utilisateurs auront un clavier physique disponible. Si votre application nécessite une entrée de texte, une forme de clavier visuel doit être fournie.

Unity fournit la classe TouchScreenKeyboard pour accepter l’entrée au clavier lorsqu’aucun clavier physique n’est disponible.

Comportement du clavier système HoloLens dans Unity

Sur HoloLens, touchScreenKeyboard tire parti du clavier visuel du système et se superpose directement au-dessus de la vue volumétrique de votre application MR. L’expérience est similaire à l’utilisation du clavier dans les applications intégrées de HoloLens. Notez que le clavier système se comporte en fonction des fonctionnalités de la plateforme cible, par exemple le clavier sur HoloLens 2 prend en charge les interactions manuelles directes, tandis que le clavier sur HoloLens (1re génération) prend en charge GGV (regard, mouvement et voix). En outre, le clavier système ne s’affiche pas lors de l’exécution de la communication à distance Unity de l’éditeur vers un HoloLens.

Utilisation du clavier système dans votre application Unity

Déclarer le clavier

Dans la classe , déclarez une variable pour stocker le TouchScreenKeyboard et une variable pour contenir la chaîne retournée par le clavier.

UnityEngine.TouchScreenKeyboard keyboard;
public static string keyboardText = "";

Appeler le clavier

Lorsqu’un événement se produit pour demander une entrée au clavier, utilisez ce qui suit pour afficher le clavier.

keyboard = TouchScreenKeyboard.Open("text to edit");

Vous pouvez utiliser des paramètres supplémentaires passés dans la TouchScreenKeyboard.Open fonction pour contrôler le comportement du clavier (par exemple, la définition du texte d’espace réservé ou la prise en charge de la correction automatique). Pour obtenir la liste complète des paramètres, reportez-vous à la documentation d’Unity.

Récupérer le contenu typé

Le contenu peut simplement être récupéré en appelant keyboard.text. Vous pouvez récupérer le contenu par image ou uniquement lorsque le clavier est fermé.

keyboardText = keyboard.text;

Options de clavier alternatives

En plus d’utiliser directement la classe TouchScreenKeyboard , vous pouvez également obtenir des entrées utilisateur à l’aide du champ d’entrée d’interface utilisateur d’Unity ou du champ d’entrée TextMeshPro. En outre, il existe une implémentation basée sur TouchScreenKeyboard dans la scène HandInteractionExamples de MRTK (il existe un exemple d’interaction clavier sur le côté gauche).

Point de contrôle de développement suivant

Si vous suivez le parcours de développement Unity que nous avons mis en place, vous êtes en train d’explorer les api et fonctionnalités de la plateforme Mixed Reality. À partir de là, vous pouvez passer à n’importe quelle rubrique ou accéder directement au déploiement de votre application sur un appareil ou un émulateur.