Bluetooth Pairing

Preparation

• System requirements: Android 4.3 or later. Smart Industry App SDK works with Android 6.0 and later.

• Manifest permissions:

  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
  
  <!-- Android 12 added -->
  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
  ...
  

• Bluetooth permission precheck: It is performed before Bluetooth scanning and connection. Otherwise, the app cannot use Bluetooth as expected.

  • Before scanning and connection, the app checks if it is allowed to access location services.

  • Check if the phone’s Bluetooth is turned on.

    Smart Industry App SDK does not provide the logic for precheck. You can implement it on your own.

Initialize IActivator

Parameters

Example

BLEActivator bleActivator = (BLEActivator) ActivatorService.activator(ActivatorMode.BLE);

Initialize device scanning IDiscovery

Parameters

Example

IDiscovery iDiscovery = ActivatorService.discovery(DiscoveryMode.BLE);

Device scanning parameters

Example

DiscoveryParams discoveryParams = new DiscoveryParams(new DiscoveryParams.Builder().setTimeout(600_000));
iDiscovery.setParams(discoveryParams);

Register IDiscoveryListener to listen for scanning result

Parameters

IBluetoothDevice data model

getDeviceType indicates the type of device to be paired.

IDiscovery iDiscovery = ActivatorService.discovery(DiscoveryMode.BLE);
iDiscovery.setListener(new IDiscoveryListener() {
            @Override
            public void didDiscover(@NonNull IDiscoveryDevice iDiscoveryDevice) {
                if (iDiscoveryDevice instanceof IBluetoothDevice){
                    ((IBluetoothDevice) iDiscoveryDevice).getAddress();
                    ((IBluetoothDevice) iDiscoveryDevice).getId();
                }

            }
        });

Device scanning

// Start scanning.
iDiscovery.startDiscovery();
// Stop scanning.
iDiscovery.stopDiscovery();

Initialize pairing parameters

Get the parameters from the result of the scanning listener.

Parameters

BLEActivatorParams params = new BLEActivatorParams.Builder()
                .setAddress("address")
                .setAssetId("assetId")
                .setDeviceType(deviceType)
                .setUuid("uuid")
                .setProductId("productId")
                .setTimeout(time)
                .build();
        bleActivator.setParams(params);

Register IActivatorListener to listen for pairing result

Example

bleActivator.setListener(new IActivatorListener() {
            @Override
            public void onSuccess(@Nullable IDevice iDevice) {
                Log.d(TAG, "onSuccess: ");

            }

            @Override
            public void onError(@NonNull String s, @NonNull String s1) {
                Log.d(TAG, "onError: ");

            }
        });

Start pairing

This method starts device pairing.

Example

bleActivator.start();

Stop pairing

Example

bleActivator.stop();

Destroy pairing instance

Example

bleActivator.destroy();