UnityCoreBluetooth

iOS & macOS Unity Native Plugin for Core Bluetooth framework

Example: Get Raw Value from Daydream Controller

Requirements

Unity

• Unity 2021.X
• Unity 2022.X
• Unity 2022.2+ (Apple Silicon)

Platforms

• iOS 14+
• macOS 12+ (Apple Silicon and Intel)

Installation

Download VideoCreator.unitypakcage from Releases and install it in your project.

Set Info.plist

Set privacy - bluetooth always usage description in Info.plist.
You can also set it in PostProcessBuild.

public class PostXcodeBuild
{
    [PostProcessBuild]
    public static void SetXcodePlist(BuildTarget buildTarget, string pathToBuiltProject)
    {
        if (buildTarget != BuildTarget.iOS) return;
        var plistPath = pathToBuiltProject + "/Info.plist";
        var plist = new PlistDocument();
        plist.ReadFromString(File.ReadAllText(plistPath));
        var rootDict = plist.root;
        rootDict.SetString("NSBluetoothAlwaysUsageDescription", "use ble");
        File.WriteAllText(plistPath, plist.WriteToString());
    }
}

Features

• Peripheral
  • Get name
  • Search services
• Service
  • Get uuid
  • Search characteristics
• Characteristic
  • Get uuid
  • Get properties
  • Write value
  • Read value
  • Receive notify

Usage

Example (Get Raw Value from Daydream Controller)

SeeMore SampleUser.cs

About Daydream Controller

Get raw value form Daydream controller

Property	Target
Peripheral Name	Daydream controller
Service UUID	FE55
Characteristic Usage	notify

1. Get CoreBluetoothManager instance

Get shared CoreBluetoothManager instance.

manager = CoreBluetoothManager.Shared;

2. Start Scan On PowerOn

manager.OnUpdateState((string state) =>
{
    Debug.Log("state: " + state);
    if (state != "poweredOn") return;
    manager.StartScan();
});

3. Discover And Connect Daydream Controller

manager.OnDiscoverPeripheral((CoreBluetoothPeripheral peripheral) =>
{
    if (peripheral.name != "")
        Debug.Log("discover peripheral name: " + peripheral.name);
    if (peripheral.name != "Daydream controller") return;

    manager.StopScan();
    manager.ConnectToPeripheral(peripheral);
});

4. Discover Services And Characteristic On Connected

manager.OnConnectPeripheral((CoreBluetoothPeripheral peripheral) =>
{
    Debug.Log("connected peripheral name: " + peripheral.name);
    peripheral.discoverServices();
});

manager.OnDiscoverService((CoreBluetoothService service) =>
{
    Debug.Log("discover service uuid: " + service.uuid);
    if (service.uuid != "FE55") return;
    service.discoverCharacteristics();
});

5. Enable Notify

manager.OnDiscoverCharacteristic((CoreBluetoothCharacteristic characteristic) =>
{
    string uuid = characteristic.uuid;
    string usage = characteristic.propertis[0];
    Debug.Log("discover characteristic uuid: " + uuid + ", usage: " + usage);
    if (usage != "notify") return;
    characteristic.setNotifyValue(true);
});

6. Handle Notify Value

manager.OnUpdateValue((CoreBluetoothCharacteristic characteristic, byte[] data) =>
{
    this.value = data;
    this.flag = true;
});

7. Start CoreBluetoothManager

manager.Start();

8. Write Value

byte[] value = { 0x64, 0x68 };
characteristic.Write(value);

Examples

• Show Detail

UnityExample

• Example for Unity
• Unity Version
  • check Examples/UnityExample/ProjectSettings/ProjectVersion.txt
• Work on Unity Editor And iOS device
• Show raw value from Daydream controller or M5StickC

M5Peripheral

• Peripheral Example for M5StickC (Plus)
• Support write and notify

NativeExamples

DaydreamExample iOS

• Native Examample for iOS
• Show raw value from Daydream controller

DaydreamExample macOS

• Native Examample for macOS
• Show raw value from Daydream controller