Installation

SimpleBLE for Unreal is distributed through Fab. Install it to your engine, or copy the plugin installed from Fab into a single Unreal project.

Install From Fab

1. Install the SimpleBLE plugin for your Unreal Engine version from Fab or the Epic Games Launcher.
2. Open your Unreal project.
3. Go to Edit > Plugins.
4. Search for SimpleBLE.
5. Enable the plugin.
6. Restart the editor when prompted.

After restart, Blueprint nodes are available under the SimpleBLE, SimpleBLE|Adapter, SimpleBLE|Peripheral, SimpleBLE|Backend, and SimpleBLE|Payload categories.

Add To A Single Project

To keep the plugin with one project instead of the engine, copy the SimpleBLE plugin folder installed from Fab into your project:

YourProject/
  Plugins/
    SimpleBLE/
      SimpleBLE.uplugin
      Source/
      Config/
      Docs/

Then regenerate project files if you use an IDE, and enable the plugin from Edit > Plugins.

C++ Module Setup

To call the plugin from a game module, add SimpleBLE as a dependency in your module .Build.cs file:

PublicDependencyModuleNames.AddRange(
    new string[]
    {
        "Core",
        "CoreUObject",
        "Engine",
        "SimpleBLE"
    }
);

Include the public headers you need:

#include "SimpleBLE/Manager.h"
#include "SimpleBLE/Adapter.h"
#include "SimpleBLE/Peripheral.h"
#include "SimpleBLE/PayloadLibrary.h"

Verify The Plugin

The quickest smoke test is to create a Simple BLE Manager object in Blueprint, call Initialize, and run a short scan. If initialization fails, check that Bluetooth is enabled, the device has a BLE-capable adapter, the packaged plugin includes Source/ThirdParty/SimpleBLE/Lib for the target platform, and mobile runtime permissions have been granted.