Kuika's Scan Devices action allows your app to scan and list Bluetooth devices in its immediate vicinity. When you develop an app with Bluetooth capabilities, it is used to interact with other Bluetooth devices in the vicinity of the device. In this tutorial, you will learn how to add a Scan Devices action to your app.

The Scan Devices action only supports mobile applications.

This training content consists of the following topics:

Adding a data source connection to your app via Bluetooth.
Adding a new method for Bluetooth connection to your app.
Adding a Scan Devices 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 Scan Devices Action

After creating a new method:

Click on the method you created.

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

executePageInitActionAfterClose: Determines whether the page loading processes are automatically restarted after the scan is completed and the device scan window is closed when you activate the switch.

Configure Scan Devices Action Parameters

Click on the “ADD OPTIONAL PARAMETER” (1) drop-down menu.
Configure the following parameters from the drop-down menu:

serviceIds: Used to find only Bluetooth devices with specific services during the scanning process. By entering the UUIDs of the targeted services, it ensures that only devices that support this service are listed in the scan result.
connectingMessage: Used to specify the message to be displayed for 5 seconds when connecting to a Bluetooth device. For example, this parameter can be set to “Connecting to device. Please wait...”, this message will be displayed to the user during the connection process.

So you have added Scan Devices action to your application.