Kuika's Bluetooth Permission Is Given action is used to check whether you have granted an application access to Bluetooth features. If permission is not granted, this action can send a warning message and start the process of requesting permission. In this tutorial, you will learn how to add a Bluetooth Permission Is Given action to your application.

The Bluetooth Permission Is Given action only supports mobile applications.

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 a Bluetooth Permission Is Given action.

Add Data Source Connectivity to Your App with Bluetooth

After logging in to the Kuika platform, open the Mobile project you will work on from the “Apps” screen.
Go to the “Datasources” (1) module. In the Datasources module, you can view the data sources, actions and tables in the application you have developed, add a new data source, a new action and a new table.

To add a new data source to your application, click on the “+” (2) icon next to the “Sources” heading on the left side of the Datasources module.

Select “Bluetooth” (1) as the Datasources type and give it a name (2).
Then click on the “CREATE” (3) button.

On the screen that opens, fill in the Device Name, Device ID and Device Address fields.

Device Name (1): The name of the device visible to the user.

It is mandatory to enter the Device Name field.

Device ID (2): The unique ID of the device.
Device Address (3): The Bluetooth address of the device. For example, the address of a Bluetooth device: “00:1A:2B:3C:4D:5E.”

It is not mandatory to enter the Device ID and Device Address.

Then click on the “CREATE” (4) button.

Add a New Method for Bluetooth Connection to Your Application

After adding a Bluetooth connection to your app, click on the “ADD NEW METHOD” button in the right corner.

Configure the settings in your application's method from the pop-up that opens.some text
- Name (1): This is the field where the created method name is entered.
- Characteristic ID (2): The characteristic ID is usually used to distinguish each characteristic.
- Service ID (3): GATT defines services that devices can use to represent specific functions or data types.
- Characteristic Type (4): Characteristics, as units under services, represent a specific function or data. Each characteristic is identified by a UUID (Universally Unique Identifier) and can allow operations such as read (Read), write (Write) or mark (Notify or Indicate).
After filling in the required fields, click on the “SAVE” button to create the method.

Add Bluetooth Permission Is Given Action

After creating a new method:

Click on the method you created.

Select “Custom→ Kuika→ BluetoothPermissionIsGiven_bluetooth” from the Properties panel “+ADD ACTION” drop-down menu on the right side.
Configure the following fields from the drop-down menu:

showAlert (1): You can specify whether a warning message is shown when Bluetooth is turned off. If you turn the switch on, an alert message will be displayed indicating that Bluetooth is turned off.
alertMessage (2): Allows you to specify the content of the alert message to be shown when Bluetooth is turned off. For example, you can write a message like “Please turn on Bluetooth”.

So you have added a Bluetooth Permission Is Given action to your application.