Plugin Documentation

BluetoothLink
Bluetooth Low Energy central for Unreal

Scan for, connect to and exchange data with BLE peripherals: services, characteristics, read/write/notify.

v1.0.0
UE 4.27–5.0+
Android · iOS
Category Networking
Alpha XP
BluetoothLink diagram
BluetoothLink — architecture & feature overview

Overview

BluetoothLink acts as a BLE central. Create a manager and scanner, discover peripherals by service UUID, connect, and read/write/subscribe to characteristics. Helper nodes handle UUIDs and byte conversions.

Fork note Module BleUtilities was renamed to BluetoothLink for UE 4.27–5.0+ (Android JNI class/native names renamed in lockstep). UUID normalization and byte conversion helpers were added.

Requirements

RequirementDetails
Unreal Engine4.27–5.0+
LanguageBlueprints and/or C++
PlatformsAndroid · iOS

Installation

  1. Copy the BluetoothLink folder into your project's Plugins/ directory.
  2. C++ projects: regenerate project files and build. Blueprint-only projects can launch the editor directly.
  3. Open Edit → Plugins and confirm BluetoothLink is enabled.

Manager / scanner

NodeTypeDescription
Create BLE Manager / Create BLE ScannerCallableCreate the central manager and scanner.
Scan / Connect / Read / Write / SubscribeCallableStandard BLE central operations (via the BLE interfaces).

Helpers (BluetoothLink BPL)

NodeTypeDescription
Convert Bytes To Hex String / Convert Hex String To BytesPureHex conversions.
Hex To UUID / Is Valid UUIDPureUUID helpers.
Normalize BLE UUIDPureExpand a 16/32-bit short UUID to full 128-bit form.
Bytes To UTF8 StringPureDecode a characteristic value as UTF-8.

Utility node pack

General-purpose networking utilities added to UBluetoothLinkUtilsBPL — available from Blueprints and C++.

NodeTypeDescription
CRC32 Of BytesPureCRC32 checksum of a byte array.
MD5 Of String / SHA1 Of StringPureHex digests of a UTF-8 string.
Make Guid StringPureNew random GUID (hyphenated).
Now Unix SecondsPureCurrent UTC time as Unix seconds.
Unix Seconds To ISO8601PureUnix seconds → ISO-8601 UTC string.
Format Byte SizePureHuman-readable size, e.g. 1536 → 1.5 KB.
Random TokenPureRandom alphanumeric token (ids, nonces).
XOR Bytes With KeyPureXOR bytes with a repeating key (obfuscation, not encryption).
Is Valid HostnamePureRFC-952/1123-style hostname validation.

Credits

© Alpha XPalphaxp.net. Developed and maintained for UE 4.27–5.0+.