Magic Leap XR Keyboard

A keyboard that can be used in any project that supports Unity's XR Interaction Toolkit. Demo scene can be found in Assets/MagicLeap/Runtime/KeyboardExample/Scenes/XRKeyboardExample.unity

How to import

Add the following git url to the Unity Package Manager: https://github.com/magicleap/MagicLeapXRKeyboard.git?path=/Packages/MagicLeapXRKeyboard

Scene Setup

To have the same interactions as in the example scene, make the following changes:

1. Select the Game Controller GameObject from the XR Rig
2. Disable Force Grab from the XR Ray Interactor
3. In the same component, enable Keep Selected Target Valid

Standard Layouts

Learn how to create cusom layouts here

Getting Started

Make sure to set the input option in Player Settings to new.

Keyboard

• Place the Keyboard prefab from Packages/Magic Leap XR Keyboard/Runtime/Prefabs/Keyboard Manager.prefab into the scene

Set Up Input Fields

• Add the script TMPInputFieldTextReceiver.cs onto any TextMeshPro Input Field you want to use with the Keyboard

Structure

The Keyboard prefab is structured in the following way:

• KeyboardManager.cs - Allows users to toggle the Keyboard on and off.
• Keyboard.cs - Manages multiple Keyboard Layouts and controls modifier key presses like Shift and Caps Lock
• KeyboardLayout.cs - groups the Keys and Keyboard Rows and communicates to the Keyboard Builder to generate a new layout if needed.
• KeyboardBuilder.cs - consumes JSON data to create the Keyboard Layout objects. The script requires that you assign the Keyboard Key and Keyboard Row prefab.
• KeyboardKey.cs - Controls the visual key graphics and input

Editing Layout

To edit the layout:

1. Create or navigate to an existing Keyboard Layout.
2. Edit the Keyboard Layout Data inside of the Keyboard Builder component.
3. Press Regenerate Keyboard to update the keyboard layout in the scene.
4. When you are finished, modify the Layout ID and description.
5. Press Write New Json .to save the data to the Streaming Assets folder. Note: to toggle between Panels with a key press, assign the key's keycode as the Panel ID

Editing Visuals

1. Navigate to an existing Keyboard Layout.
2. Modify the Key prefab in the Keyboard Builder component.
3. Press Regenerate Keyboard to update the keyboard layout in the scene.

Unicode and Special Characters

Shift

Other Special Labels

Keycodes

Disclaimers

This project is based on UltraLeap's XR Keyboard which is licensed under Apache 2.0 This project is licensed under the Magic Leap Developer License