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

fuziki / UnityCoreBluetooth