Skip to content

Latest commit

 

History

History
183 lines (144 loc) · 4.55 KB

README.md

File metadata and controls

183 lines (144 loc) · 4.55 KB

UnityCoreBluetooth

Platform Unity Xode

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

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

NativeExamples

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