Device Pairing UI BizBundle

Device Pairing UI BizBundle is used to implement pairing guidance and smart device activation. It applies to multiple common types of smart devices, such as Wi-Fi devices, Zigbee devices, Bluetooth devices, and devices that support QR code scanning like GPRS & NB-IoT devices. The UI BizBundle provides the service logic and UI encapsulation to guide pairing and activate smart devices over different protocols.

Device types

Wi-Fi device pairing

Wi-Fi smart devices can be paired and connected to cloud services in two modes: Wi-Fi Easy Connect (EZ) mode and access point (AP) or hotspot mode. IP cameras (IPCs) can be paired after QR code scanning.

Zigbee device pairing

Zigbee gateways and sub-devices can be paired.

Bluetooth device pairing

Tuya provides the following Bluetooth solutions.

QR code pairing

A smart device that supports this pairing mode is connected to Tuya’s cloud services immediately after power on. The app can be used to scan the QR code on the device to implement cloud-based device activation and binding. The QR code must comply with Tuya’s QR code rules. For more information, contact Tuya’s account manager.

Matter device pairing

Version requirement: 2.1.0-cube.1 or later

If you want to use the Matter device pairing feature, see Prepare for Integration with Matter Device for initialization.

Pairing by auto discovery

Tuya provides efficient pairing features on top of Tuya’s generic pairing technologies for smart devices.

Integrate with the UI BizBundle

1. Create a project.

   Integrate Smart Life App SDK for Android into your project with Android Studio and add the framework of the UI BizBundle to your project.

2. Configure the build.gradle file.

   sdk_version description

   • When the sdk_version is 2.0.0-cube.2, make sure the Cube deployed in the cloud is 2.0 or later.
   • When the sdk_version is 2.1.0-cube.1, make sure the Cube deployed in the cloud is 2.1 or later.

   dependencies {
       api "com.thingclips.smart:thingsmart-bizbundle-device_activator:${sdk_version}"
       api "com.thingclips.smart:thingsmart-activator-device-guide:4.9.1-cube.1"
       api "com.thingclips.smart:thingsmart-activator-ui-kit:4.9.1-cube.1"
       // To implement the QR code scanning feature, depend on the BizBundle for QR code scanning.
       api "com.thingclips.smart:thingsmart-bizbundle-qrcode_mlkit:2.0.0-cube.2"
   }
   

3. Obfuscate the code.

   #fastJson
   -keep class com.alibaba.fastjson.**{*;}
   -dontwarn com.alibaba.fastjson.**
   
   #rx
   -dontwarn rx.**
   -keep class rx.** {*;}
   -keep class io.reactivex.**{*;}
   -dontwarn io.reactivex.**
   -keep class rx.**{ *; }
   -keep class rx.android.**{*;}
   
   #fresco
   -keep class com.facebook.drawee.backends.pipeline.Fresco
   -keep @com.facebook.common.internal.DoNotStrip class *
   -keepclassmembers class * {
   @com.facebook.common.internal.DoNotStrip *;
   }
   
   #tuya
   -keep class com.thingclips.**{*;}
   -dontwarn com.thingclips.**
   

Configure features

Make API requests

Open the pairing page

ThingDeviceActivatorManager.INSTANCE.startDeviceActiveAction(this);

ThingDeviceActivatorManager.INSTANCE.addListener(new IThingDeviceActiveListener() {

            @Override
            public void onDevicesAdd(List<String> list) {

            }

            @Override
            public void onRoomDataUpdate() {

            }

            @Override
            public void onOpenDevicePanel(String s) {

            }

            @Override
            public void onExitConfigBiz() {

            }
        });

Request parameters

Response parameters

Open the QR code scanning page

ScanManager.INSTANCE.openScan(this);