Giter Club home page Giter Club logo

ue-bluetooth-support's Introduction

Bluetooth Support plugin for UE4

A code plugin for Unreal Engine that allows developers to access the Bluetooth SDK from Blueprint and C++. This is the source code of "Bluetooth Support" code plugin on https://www.unrealengine.com/marketplace/bluetooth-support

Prerequisites

Before adding the plugin to your projects, please take these points into consideration:

  1. This plugin relies on Android native SDK. Only Android is currently supported.
    It won't cause a problem for other platforms. It is safe to call any of the plugin methods on any platform.
    You can always wrap platform-specific features by checking the platform name.
  2. Android started supporting Bluetooth Low Energy since Android 4.3 (API level 18).
    • Accessing the device's default bluetooth adapter (API level 18)
    • Nearby device discovery, connection, characteristic reading (API level 21)
    • Getting a nearby device's TXpower, connectablity, advertising intervale (API level 26)
  3. These permissions and capabilities are required in the manifest file in order to be able to use Bluetooth LE on an Android device.
    Don't worry, you can do that easily by following this official guide
  4. Your app should request ACCESS_COARSE_LOCATION runtime permission in order to be able to discover other BLE devices.
    Here is how to check/request granted permissions at runtime on UE4.

Installation

  1. Clone/download zip this repository
  2. Move/unzip the plugin's downloaded folder inside your projects directory/Plugins/
  3. Restart Unreal Engine (if it is running)
  4. Find the plugin under the "Mobile" category and enable it.

Getting Started

Make sure that your target platform/device family satisfy the Prerequisites listed above

There is no better way to understand how to integrate the use this plugin than seeing it in action!
You can go ahead and clone this demo project. After opeining it on your UE4, you can naviguate to the project settings and take a look at the Blueprints to learn how to call the different functionnalities.

Change log

Milestones on the "Release" channel of this repository.

  • v4.19-4: Unified Scan node with optional filters
    • Scan all, and Scan by UUID are now unified an both support Async result callback, no need to call "getDiscoveredDevices" anymore.
    • Scan by MAC address added
  • v4.19-3: Async scan callback for "filterless" scan.

Donate

If you found this project helpful, consider buying me a โ˜•

paypal

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

ue-bluetooth-support's People

Contributors

tahahichri avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.