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 du 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 sur 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 directes entre les mains, tandis que le clavier sur HoloLens (1ère 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 TouchScreenKeyboard et une variable pour contenir la chaîne renvoyée par le clavier.

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

Appeler le clavier

Lorsqu’un événement se produit en demandant 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, définir le texte de l’espace réservé ou prendre en charge la correction automatique). Pour obtenir la liste complète des paramètres, reportez-vous à la documentation de 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

Outre l’utilisation directe de la classe TouchScreenKeyboard, vous pouvez également obtenir une entrée utilisateur à l’aide du champ d’entrée de l’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 fonctionnalités et LES API de plateforme de réalité mixte. À partir de là, vous pouvez continuer vers n’importe quelle rubrique ou accéder directement au déploiement de votre application sur un appareil ou un émulateur.