Wi-Fi and Bluetooth Combo 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

BLEWIFIActivator blewifiActivator = (BLEWIFIActivator) ActivatorService.activator(ActivatorMode.BLE_WIFI);

Initialize device scanning IDiscovery

Parameters

Example

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

Device scanning parameters

Example

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

Register IDiscoveryListener to listen for scanning result

Parameters

IBluetoothDevice data model

getDeviceType indicates the type of device to be paired.

Example

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

            }
        });

Device scanning

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

Initialize pairing parameters

Get the parameters from the result of the scanning listener.

Parameters

BLEWIFIActivatorParams params = new BLEWIFIActivatorParams.Builder()
                .setAddress("address")
                .setAssetId("assetId")
                .setToken("token")
                .setPwd("pwd")
                .setUuid("uuid")
                .setSsid("ssid")
                .setMac("mac")
                .setTimeout(time)
                .build();
blewifiActivator.setParams(params);

Register IActivatorListener to listen for pairing result

Example

blewifiActivator.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: ");

            }
        });
// Added enhanced Activator listener, maintaining compatibility with the previous version of the listener.
blewifiActivator.setListener(new IExtMultiModeActivatorListener() {
            @Override
            public void onActivatorStatePauseCallback(@NonNull String uuid, int configStage, int status) {

            }

            @Override
            public void onSuccess(@Nullable IDevice iDevice) {

            }

            @Override
            public void onError(@NonNull String s, @NonNull String s1) {

            }
        });

Description of onActivatorStatePauseCallback:

Start pairing

This method starts device pairing.

Example

blewifiActivator.start();

Stop pairing

Example

blewifiActivator.stop();

Destroy pairing instance

Example

blewifiActivator.destroy();