Technical Documentation - Usage - MacBLE

In most cases, you need to build an app to connect to the real cube and check the operation, which takes time. By using the BLE plugin for MacOS, you can connect directly to the real cube from the Unity Editor without building the app.

This section explains how to connect to the real cube from the Unity Editor on a Mac.

Confirmed operating environment

We have confirmed that it works in the following environment. You don’t necessarily have to match, but if it doesn’t work in your environment, please refer to the following.

Tools and Software	Confirmed version	Recommended version
OS	MacOS 13.4.1	MacOS 11 or higher
Unity	2022.3.44f1	2022.3 or higher
Device	MacBook Pro 2017	N/A

Import Method

As a preliminary step, go to Apple menu in the upper left corner of the screen and click “About this Mac” to check your OS version.

If your OS version is 10.x , 11.x or 12.x, please refer to How to download a pre-built bundle file. For other OS versions, please refer to How to build the bundle file on your own PC.

Please configure Unity in the Bluetooth permission list in macOS security settings if it’s not already included. (Reference: macOS User Guide)

How to download a pre-built bundle file

1. Download bundle file

Open toio/ble-plugin-unity/Releases and click on bleplugin_10.bundle.zip if your OS version is 10.x or bleplugin_11.bundle.zip if your OS version is 11.x or 12.x. If your OS version is 10.x, click on bleplugin_10.bundle.zip, and if your OS version is 11.x 12.x, click on bleplugin_11.bundle.zip to download.

As of v1.5.1, this SDK targets the v1.0.0 release.

2. Drag and drop bundle file into your Unity project

Open your Unity project and navigate to the folder Assets > ble-plugin-unity > Plugins. Unzip the downloaded zip file and drag and drop the bundle file directly into the Unity window.

How to build the bundle file on your own PC

1. Download Xcode project

Open toio/ble-plugin-unity and click [Code] > [Download ZIP] to download the repository.

2. Build bundle file

Unzip the downloaded zip file and open the Xcode project file located at bleplugin_projects/macOS/bleplugin/bleplugin.xcodeproj. Open the project settings screen, click on “bleplugin” in the TARGETS list, then click on the “Build Settings” tab and open the Deployment settings.

Click [macOS (version value)] in the right column of macOS Deployment Target in the Deployment settings, and select the OS version that you checked in the prior work.

After completing the above tasks, click the play button (:arrow_forward:) in the upper left corner of Xcode to start the build, and wait until the build is complete.

3. Drag and drop bundle file into your Unity project

Open your Unity project and navigate to the folder Assets > ble-plugin-unity > Plugins. Drag and drop bundle file generated by the build directly from Xcode window to Unity window.