Bluetooth Keyboard / Mouse

Introduction

Quantum functions as a Bluetooth keyboard, enabling you to input information directly into apps on your phone.

Please note that this feature works only when the app is active, compatible with Bluetooth keyboards, and the screen is unlocked.

Make sure you have the latest firmware. Bluetooth keyboard support has been introduced with a firmware update.

Pairing Quantum

When Quantum works as a Bluetooth keyboard, operating systems (iOS, Android, Windows, Mac) will need to pair it. It is a Bluetooth term to set up safe communication between two devices. For example, this dialog will appear on iOS. Expect to see similar dialogs on Android, Windows and Mac as well. Please note that Quantum can be paired with only one device at a time.

When the pairing dialog appears, you have two options:

Canceling the pairing will prevent Quantum from functioning as a Bluetooth keyboard.
Selecting “Connect” will allow it to pair and function as a keyboard.

Canceling the pairing can be useful when using the MagiScript Editor on a desktop to develop mini-apps. If you cancel, you’ll be prompted to pair again the next time you connect.

Occasionally, you may need to re-pair Quantum – this can happen after pairing with another device, a firmware update, or similar changes. If Quantum connects briefly and then disconnects, it’s likely time to re-pair. Check our Troubleshooting Guide for steps on how to remove the pairing from your phone’s Bluetooth settings.

Once paired, most operating systems will automatically reconnect to Quantum when you turn it on. However, note that this does not establish a connection to an app – you’ll still need to connect to your app manually as before.

Caveats

On iOS, when a Bluetooth keyboard is connected, the onscreen virtual keyboard is automatically disabled. However, pressing Quantum’s power button will bring the virtual keyboard back.

If you pair Quantum with an operating system (Windows, Mac, iOS, Android), the pairing with another operating system may fail. You will have to “forgot this device” and pair it again to connect.

Keyboard Mini-Apps

We created many built-in mini-apps to use Quantum as a Bluetooth keyboard. If you would like to modify them, our MagiScript documentation includes their source code or you can create your own with MagiScript’s Bluetooth Keyboard support.

Numeric keyboard – enter numbers
NOKIA alphanumeric keyboard – enter any word
Cursor keyboard – for Inject 2 (for example)
Media controls – control music
Custom keyboard – type WikiTest keywords, setup your own keyboard

International Keyboard Support

Bluetooth keyboards are sending keyboard positions, not the exact character associated with that key. For example, on a German or Hungarian “QWERTZ” keyboard (if that’s your OS setting), when the keyboard sends “0”, an “ö” character will be typed. On a French “AZERTY” keyboard when the keyboard sends “a”, then the “q” character will be typed. The selected keyboard layout defines which characters Quantum will be able to send.

Operating systems are handling the situation differently. You are likely to use an iOS or Android phone with Quantum, and perhaps a Windows or Mac for development. You will know the settings of the device you are working with, but you can also connect Quantum to a spectator’s phone. This allows you to perform a lock screen effect or to type a prediction on their phone, however, their keyboard settings will be unknown.

Currently we support a keyboard variation called “International Keyboard”. We have tested it with both iOS and Android. By default, all the English letters and other characters are working, and additionally some accented letters (mostly Western European) are working as well, but to have them, make sure you configure your OS in the Keyboard section of Quantum Settings. Currently, the accented characters are available with MagiScript only, no built-in mini-apps supports entering them.