SimpleBLE for Unity
The underlying SimpleBLE backends are tested separately. Documentation and C# usage examples ... Synchronous and async C# APIs with cancellation support for asynchronous operations.
by SimpleBLE
Price History +
Unity compatibility
Validated with Unity 6.3 LTS (6000.3.24f1) and Unity 6.6 (6000.6.4f1). Independent of render pipeline: Built-in, URP and HDRP. Includes SimpleBLE native runtime v1.2.0.
Supported OS and requirements
- Windows 10/11: x86_64, BLE-capable adapter and Bluetooth enabled.
- macOS 14+: Apple Silicon and Intel. Configure a Bluetooth usage description and grant Bluetooth access. Sandboxed applications also require the Bluetooth entitlement.
- iOS 15+: ARM64 physical devices, IL2CPP and Device SDK. Requires iOS Build Support, Xcode signing and a Bluetooth usage description. Apple build hooks link CoreBluetooth and Foundation.
- Android 12 / API 31+: ARM64, IL2CPP and runtime Bluetooth permissions. Initialize Bluetooth on Unity's main thread before using the API.
- Linux: Ubuntu 22.04/24.04, x86_64, BlueZ, system D-Bus and a BLE adapter.
Integration notes
Native callbacks run on worker threads. Marshal callback data to Unity's main thread before calling Unity APIs. Dispose owned adapter and peripheral handles when finished. Platform permissions and application signing are configured by the consuming project; setup instructions are included.
iOS simulators, Mac Catalyst, tvOS, Linux ARM64, WebGL and consoles are outside this package's target set. Background Bluetooth behavior depends on the OS and application configuration. Android's neverForLocation scan flag may filter some beacons; applications deriving location must configure their own location permissions.
Packaging covers all five targets. Representative Unity binding acceptance includes macOS ARM64 and x86_64 IL2CPP players, high managed stripping, domain reload disabled, and signed physical iOS hardware GATT checks. The underlying SimpleBLE backends are tested separately.
Documentation and C# usage examples
SimpleBLE for Unity brings Bluetooth Low Energy to Unity applications through a C# API.
Connect nearby sensors, controllers, companion hardware and IoT devices using asynchronous operations and events. Discover adapters and peripherals, exchange binary data, and subscribe to notifications or indications.
Managed bindings and native runtime libraries are included for all five supported platforms.
Included
- Adapter discovery, state checks, timed scanning and discovery events.
- Peripheral connection, disconnection and service inspection.
- Characteristic and descriptor reads and writes, including write request and write command.
- Notifications, indications, manufacturer data and byte-array payloads.
- Synchronous and async C# APIs with cancellation support for asynchronous operations.
- Native libraries for Windows, macOS, iOS, Android and Linux.
- Offline installation, usage and platform documentation, plus documented C# examples.
BLE operations run locally and do not require an online service. This is a runtime code plugin; C# examples are provided in the documentation.
Licensing
When acquired through the Unity Asset Store, this plugin and its included SimpleBLE managed and native libraries use the standard Unity Asset Store EULA. No separate SimpleBLE license purchase is required for this distribution. See Third-Party Notices.txt in the package.