Bluetooth

1. Overview

This article mainly introduces how to use the Device Pairing SDK (With UI) and Device Pairing SDK (Without UI) by Bluetooth.

2. Preconditions

1. Confirm completion Preparation
2. Confirm the completion of Environment Build
3. Complete Device Pairing SDK (With UI) or Device Pairing SDK (without UI) integration

3. Use

3.1 Pairing Process

Device Pairing by Bluetooth means that after the App discovers the device through Bluetooth, it connects to the device through Bluetooth, and sends the pairing information to the device, and finally completes the device registration, binding and other operations.

3.2 Device Pairing SDK (With UI), API call

3.2.1 Jump to the Device Pairing device list page

Jump to the select device list page, which lists all the devices supported by the current SDK.

   LMAccessSDKManager.Companion.getInstance()
                .gotoAccessListPage(
                        this,
                        "homeId",
                        "roomId",
                        "coapServer",
                        new LumiResultCallBack() {
                            @Override
                            public void success(@NonNull WeakReference<Activity> weakReference, @Nullable String s) {

                            }

                            @Override
                            public void fail(@Nullable Integer integer, @Nullable String s) {

                            }
                        }
                );

参数说明

3.2.2 Jump to the specified device configuration page

LMAccessSDKManager.Companion.getInstance()
        .gotoAccessConfigModule(
                this,
                "deviceModel",
                "homeId",
                "roomId",
                "coapServer",
                new LumiResultCallBack() {
                    @Override
                    public void success(@NonNull WeakReference<Activity> weakReference, @Nullable String s) {

                    }

                    @Override
                    public void fail(@Nullable Integer integer, @Nullable String s) {

                    }
                }

        );

Parameter Description

3.3 Device Pairing SDK (without UI)

3.3.1 Get bindKey

The third-party app needs to implement the interface request by itself, please refer to Aqara Developer Platform

3.3.2 Bluetooth Discovery

BleScanner bluetoothLeScanner = new BleScanner(this);
bluetoothLeScanner.findDeviceByBle(2000L)
        .onTerminateDetach()
        .as(AutoDispose.autoDisposable(AndroidLifecycleScopeProvider.from(this)))
        .subscribe(new Consumer<List<ScanResult>>() {
            @Override
            public void accept(List<ScanResult> scanResults) throws Exception {

            }
        }, new Consumer<Throwable>() {
            @Override
            public void accept(Throwable throwable) throws Exception {

            }
        });

Parameter Description

3.3.3 Send distribution network information

AccessConfigBean accessConfigBean = new AccessConfigBean(
        "ssid",
        "password",
        "coapServer",
        "bindKey"
);

AccessBleManager manager = new AccessBleManager.BLEAccessBuilder()
        .setAccessInfo(accessConfigBean)
        .setAccessMode(AccessBleManager.BleAccessMode.ACCESS_MODE_BLE_SUB_DEVICE)
        .setBleMac("deviceBleMac")
        .setAccessListener(new IAccessListener() {
            @Override
            public void connectSuccess() {

            }

            @Override
            public void accessResult(@Nullable String s) {

            }

            @Override
            public void accessFail(int i, @Nullable String s) {

            }
        })
        .build(this);

//Start to configure the network
manager.startAccess();

//Call resource recycling at the appropriate time, otherwise there may be data caching in the Device Pairing, resulting in unsuccessful problems.
manager.onDestroy();

Parameter Description

accessMode value