Hello XR Developers! Today, we’re taking a deep dive into creating your very own drawing app using the Logitech MX-Ink stylus with Meta Quest. If you’re familiar with apps like ShapesXR or PaintingVR, you’ll love this new way of sketching and painting inside your headset. In this tutorial, we’ll walk through how to set up the stylus, explore the sample assets from Logitech, and create a fully functional drawing app. Let’s get started!
Setting Up the Logitech MX-Ink Stylus
- Visit the Logitech GitHub Page:
- Head over to the Logitech MX-Ink Unity Integration Guide and download the MX Ink Unity Package.
- This package comes with all the sample code, stylus mapping, 3D models, and prefabs for your app.
- Download the Input Action Set:
- Starting with Meta version 68, Meta Quest supports the MX-Ink Stylus through an Input Action Set, which you can also download from the GitHub page.
- This set includes the new OpenXR Interaction Profile for the Logitech pen, so you don’t need to manually bind input actions.
- Check for Meta SDK Compatibility:
- Ensure that you have Meta Core SDK version 68.0.2 or newer installed in your Unity project. You can check and install this through the Package Manager.
- Add the Input Action Map by going to
Edit > Project Settings > Meta XR
and reference your downloaded map under Input Actions.
Setting Up the Stylus in Unity
- Import Assets:
- Import the Unity Package from the GitHub page into your project.
- Add the stylus model to your scene—no need to parent it to any controllers. The model will track the stylus input on its own.
- Create the StylusHandler Script:
- This script will handle stylus inputs like pressure sensitivity, buttons for grabbing and deleting, and haptic feedback.
- Define variables for controlling haptic feedback, including duration, amplitude, and a threshold to trigger the vibration when enough pressure is applied.
- Declare events like
OnFrontPressed
,OnBackReleased
, andOnDocked
to trigger interactions based on the stylus state.
- Stylus Input and Pose Handling:
- Use
UpdateStylusPose
to determine if the stylus is active and in which hand, updating its position and rotation accordingly. - Manage stylus pressure and button states using methods like
GetActionStateFloat
andGetActionStateBoolean
.
- Use
- Generate Haptic Feedback:
- If the stylus’s pressure exceeds the threshold, generate haptic feedback through the OVRPlugin to vibrate the hand holding the stylus.
Building the Drawing Logic
- Create the Drawing Script:
- This script controls the drawing and manipulation of lines using Unity’s
LineRenderer
component. - Define variables to store all drawn lines, manage the width of lines based on stylus pressure, and set colors for drawing and highlighting lines.
- This script controls the drawing and manipulation of lines using Unity’s
- Start Drawing:
- When the user presses the stylus tip, the app enters
Drawing
mode, creating a new line using theLineRenderer
. - As the stylus moves, the script adds points to the line and adjusts its width dynamically based on the pressure applied.
- When the user presses the stylus tip, the app enters
- Highlight and Move Lines:
- Use proximity detection to highlight lines when the stylus is close. Change the line’s color to
highlightColor
when it is near enough. - Once a line is highlighted, users can grab and move it in 3D space by adjusting the points in the
LineRenderer
.
- Use proximity detection to highlight lines when the stylus is close. Change the line’s color to
- Delete Lines:
- Pressing the back button on the stylus will delete the currently highlighted line from the scene.
Setting Up the Scene
- Attach Scripts:
- Add the
StylusHandler
andDrawing
scripts to the stylus object in your scene. - Set your desired colors, thresholds, and event handlers for a fully interactive experience.
- Add the
- Pairing the Stylus with Meta Quest:
- Open the Meta Horizon App on your phone, go to your headset settings, and select Controllers.
- Click on “Pair New Controller,” choose “Pair Stylus,” and press the menu and back buttons on the stylus for 4 seconds to pair it with your headset.
Testing Your Drawing App
- Try Drawing:
- Once paired, test drawing by pressing the stylus tip or middle button. You’ll see the line width adjust according to the pressure applied.
- Use the front button to grab and move drawings, and the back button to delete them.
- Toggle between VR and passthrough mode using the stylus buttons, creating a seamless experience.
Support Black Whale🐋
Thank you for following this article. Stay tuned for more in-depth and insightful content in the realm of XR development! 🌐
Did this article help you out? Consider supporting me on Patreon, where you can find all the source code, or simply subscribe to my YouTube channel!