The Bluetooth Is Open action on the Kuika platform is used to check if Bluetooth is turned on on a device. This action verifies if Bluetooth is active on the device so that your app can use Bluetooth features. If Bluetooth is turned off, this action can give the app a warning to turn Bluetooth on or stop certain actions.

The Bluetooth Is Open action is only supported in mobile apps.

This training content consists of the following topics:

Adding a Data Source Connection to Your App with Bluetooth
Adding a New Method for Bluetooth Connection to Your Application
Adding Bluetooth Is Open Action

Add Data Source Connectivity to Your App with Bluetooth

Log in to the Kuika platform.
Open the Mobile project you will work with from the Apps screen.
Go to the Datasources module from the left menu. In this module, you can view the data sources, actions and tables used in your application and add a new data source, action or table.

To add a new data source, click the + icon next to the Sources heading.

Select Bluetooth as Datasource Type and set a name for the data source.
Click on the CREATE button.

On the screen that opens, fill in the following fields:

Device Name (1): The name of the device visible to the user. (This field is mandatory.)
Device ID (2): The unique ID of the device. (This field is optional.)
Device Address (3): The Bluetooth address of the device (For example: 00:1A:2B:3C:4D:5E) (This field is optional.)

Then click the CREATE (4) button to create the data source.

Add a New Method for Bluetooth Connection to Your Application

After creating the data source, click on the ADD NEW METHOD button in the right corner.
Configure the fields in the pop-up as follows:

Name (1): Enter the name of the method.
Characteristic ID (2): Used to distinguish each characteristic.
Service ID (3): GATT identifies services that devices use to represent specific functions or data types.
Characteristic Type (4): Characteristics identified by UUID (Universally Unique Identifier). This field allows read (Read), write (Write) or mark (Notify or Indicate) operations.

After filling in the required fields, click the SAVE button to create the method.

Adding Bluetooth Is Open Action

Click on the method you created.
In the Properties panel on the right side, follow these steps from the +ADD ACTION drop-down menu:
- Custom → Kuika → BluetoothIsOpen_bluetooth.

Then configure the following fields:

showAlert (1): Determines whether a warning message is shown when Bluetooth is off. If this field is enabled, an alert message will be displayed indicating that Bluetooth is turned off.
alertMessage (2): Determines the content of the alert message to be displayed when Bluetooth is turned off. For example: “Please turn Bluetooth on”.

3. After completing the configuration, click the SAVE button.

You have successfully added the Bluetooth Is Open action to your application.

‍