Skip to content

Latest commit

 

History

History
138 lines (97 loc) · 8.93 KB

README.md

File metadata and controls

138 lines (97 loc) · 8.93 KB
Raw

VFSKeyboard

tags: VFSKeyboard, ReadMe, Unity Asset, VR, Unity, SHING MING STUDIO

🐯 VR, Fast and Simple 🐱

VFSKeyboard is an open-source keyboard, as its name, suitable for VR development environment, fast and simple to use.

Supported Engine Unity
Supported Version 2019.4.14f1 +
Download Source Unity Asset Store
Download Link (Click the picture) Asset_store_2

FEATURES

  • Autofill to the corresponding inputField which is the last time select by user
  • Cross-platform building by Oculus Integration, SteamVR Plugin, Unity XR Interaction Toolkit
  • "One seconds" setup
  • Easy-to-use
  • Auto enable/disable the virtual keyboard when trigger/untrigger* the “InputField” UI component
  • Customize the keyboard button color when the user release, select, and press

*Untrigger means the VR controller (or laser pointer) leave to point the keyboard area for about 3 seconds (default setting)

FAST INSTALLATION

  1. [important] Make sure that your VR controller (or laser pointer) can interact with the UI component (e.g. click the button) in the scene first before using this asset
  2. Add the “InputField” gameObject and then add the “InputFieldDetection” script at this gameObject
  3. Add the “Virtual Keyboard Controller” prefab in the scene
  4. Drag the “Virtual Keyboard” prefab to the Canvas UI gameObject, become the childObject of the Canvas UI gameObject
  5. Fine-tuning the UI component to a suitable position, and now you can play it now :)

p.s. In our unitypackage, our example scene is made by Unity XR Interaction Toolkit framework and using the Oculus Quest 2 for our testing. Install the Unity XR Interaction Toolkit framework and double-click the example scene to try it out!

INSTALLATION IN DETAILS

Step 1 - Set Up your VR development environment

  1. According to the VR device you are using and you're expected to develop the VR framework, install the corresponding package and plugin. As our example, we first open the Package Manager, and then click Advanced button, select Show preview packages
  2. Search XR Interaction Toolkit and then install it
  3. Go to Edit -> Project Setting -> XR Plug-in Management -> install XR Plug-in Management
  4. Select the corresponding Plug-in Providers which match your VR device. In our example, we select Oculus, and then it will automatically install Oculus XR Plugin

Step 2 - Set Up the VR controller (or laser pointer) that can interact with the UI component in the scene

  1. For how to make the VR controller (or laser pointer), pls check out this ReadMe session: The Details of the Demo - Building the laser pointer

Step 3 - Download and import VFSKeyboard packages

The part that our components are responsible for

  1. Download and import "VFSKeyboard"
  2. Add two "InputField" gameObject in the scene and then add the "InputFieldDetection" script at those gameObject. This script is mainly responsible for sending the signal that opens the "Virtual Keyboard" when the laser pointer click the InputField gameObject
  3. Add the "Virtual Keyboard Controller" prefab in the scene. This gamObject mainly control the "Virtual Keyboard" open or not
  4. Drag the "Virtual Keyboard" prefab to the Canvas UI gameObject, become the childObject of the Canvas UI gameObject
  5. Fine-tuning the UI component to a suitable position, and now you can play it now :)

Step 4 - Fine-tuning the VFSKeyboard setting(Optional)

Ther have some setting that let you modify such customize the keyboard button color when the user release, select, and press and the automatically closing time of the Virtual Keyboard

  1. You can set the automatically closing time of the Virtual Keyboard of what you want. This setting is in the gameObject path, "Virtual Keyboard/Background"

  2. For color setting of the Virtual Keyboard button, you can select the gameObject that path is "Virtual Keyboard/Background/{row1, row2, row3...}/{A, B, C, D, E...}", then modify the "GetKeyCode" script parameter {mNormalColor, mHoverColor, mDownColor}

KNOW ISSUE / IMPROVEMENT

  • Can’t get the cursor (or laser pointer) position (in characters) within a text InputField if the project using Oculus Integration and XR Interaction Toolkit to develop
  • Add more punctuation key to the keyboard in the future

Demo - Try it out!

Demo builds from the different framework and using the Oculus Quest 2 for testing are available here

  1. The Unity Project File

  2. Building by Oculus Integration:

  3. Building by SteamVR Plugin:

  4. Building by Unity XR Interaction Toolkit

  5. General input(Physical Mouse) (Not VR Development)

Building by Oculus Integration Building by SteamVR Plugin Building by XR Interaction Toolkit General input (by Physical Mouse)
Running on Windows V V V V
Running on Android(Oculus) V V
Having a know issue V V
Version 29.0 v2.7.3 (sdk 1.14.15) 0.10.0-preview.7 N/A
*Press the keyboard key by 1 or 2 3 3 Physical Mouse

*In the Demo, we set some button events on Oculus Controller to trigger the event when the button is down such as press the keyboard key

The Details of the Demo - Building the laser pointer

The above Demo follows the following tutorial to set the laser pointer that can interact with the UI component in the scene and then add VFSKeyboard to interact InputField and Virtual Keyboard components

  1. Making the laser pointer with Oculus Integration https://www.youtube.com/watch?v=8fT478uopco

  2. Making the laser pointer with SteamVR Plugin: (I). https://www.youtube.com/watch?v=3mRI1hu9Y3w&t=314s (II). https://www.youtube.com/watch?v=h_BMXDWv10I (III). https://www.youtube.com/watch?v=vNqHRD4sqPc&t=881s

  3. Making the laser pointer with Unity XR Interaction Toolkit https://www.youtube.com/watch?v=BZt74PVb7sM

Update History

  • v1.0 Jun 22, 2021: First release

🐛 Issue report 🕷️

If you encounter any software issues, please feel free to report via this link. Thank you.

🐯 About Author / Contact Information 🐕

paypal

LICENSE

MIT License Create by Wong, Shing Ming