Esp32BleAndroid Quick Start

A Unity 3D object ‘ tumbler’ in the Demo scene tilts using acceleration the generated　data of the Esp32. The ESP32 generates 3D Object position data ‘x, y, z’ using the SIN function. The Esp32 sends that data from the Esp32 to Unity through Android mobile phone using the BLE (Bluetooth low energy) interface.

When clicking a Unity 3D object ‘Button’ in the Demo scene, Unity sends the numerical data obtained from the Unity 3D object ‘Inputfield’ to the Esp32. Unity works at Android mobile phone and sends the numerical data to the Esp32 using the BLE (Bluetooth low energy) interface.

The following shows the capture screen when the Demo scene runs.


This Quick Start explains how to display the Demo scene on Unity using Esp32BleAndroid. This Quick Start also includes some steps for downloading and setting up a package in Unity Project, and writing the Esp32 code.

Step-1 Download and set up a package in Unity Project
Step-2 Write Esp32 code using Arduino IDE
Step-3 Run Demo scene

Step-1 Download and set up a package in Unity Project

  1. Download Esp32BleAndroid from the Asset Store, and click on the Import button.

  2. The package is imported under the Assets folder in your Unity project.

  3. Click the Project tab, choose ‘Assets’ > ‘Esp32BleAndroidInterface’ > ‘Scenes’ folder of the left side menu, double click on the Demo scene ‘Esp32BleAndroidSampleScene’ in the Project window.

  4. Connect Android mobile phone by USB cable to Windows PC, build the purchased assets according to ‘Building games for Android’, and run it in Android mobile phone.

  5. Display Esp32BleAndroid from application information in Android mobile phone as follows. Change the Location permission to ON because of the need to enable Bluetooth Low Energy Scanning.

Step-2 Write Esp32 code using Arduino IDE

  1. Connect the Esp32 by Micro USB cable to Android mobile phone, then build a software development environment for Esp32Ble with the Arduino IDE according to ‘Arduino IDE for Esp32Ble.‘

  2. Compile and write Esp32 code ‘esp32ble-v2.ino’ of the folder ‘/Assets /Esp32BleAndroidInterface/esp32ble-v2’ into the Esp32 using the Arduino IDE.

Step-3 Run Demo scene

  1. The installed Esp32BleAndroid on Android mobile phone displays the game object as follows.

  2. The Android Logcat displays the game status as follows. The Android Logcat refer to ‘Install and Use Android Logcat’ for details.

  3. The ‘Serial Monitor’ of Arduino IDE displays the data “x, y, z” as follows.

    4. [ Not connect to Unity ]

    [ Connect to Unity and send acceleration data ]

  4. Set No0 / No1 into Inputfield ’No0’ / Inputfield ‘No1’ in the game screen, then click the Button ‘On’ to send to the Esp32. Show Inputfield ’No0’ / Inputfield ‘No1’ as follows.

  5. The Android Logcat displays the game status at clicking Button ‘On’ as follows.

  6. The ‘Serial Monitor’ in Arduino IDE displays the No0/No1 data as follows.