Magic Pair配网

一、概述

本文主要介绍如何使用配网SDK（含UI）、配网SDK（不含UI）进行Magic Pair配网。

二、前提条件

1. 完成准备工作
2. 完成环境搭建
3. 完成配网SDK（含UI）或者配网SDK（不含UI）集成

三、使用

3.1 配网流程

Magic Pair配网流程，是指SDK与设备根据私有协议进行配网，通过标准的设备发现（蓝牙、Wi-Fi、局域网等）简化用户配置流程，快速给设备入网，提升用户添加设备的效率。

3.2 配网SDK（含UI）

3.2.1 初始化

参见环境搭建-统一初始化。

配网前请确保已正确配置：

• positionInfo（家庭 / 位置 ID）
• coapServer（与当前服务地区匹配的设备入网域名）
• country / area / supportDeviceArea（建议先确定 country 再反查，参见地区对照表）

3.2.2 跳转到指定设备配网页

统一初始化完成后，可通过 LumiAccessSDKManager 拉起指定设备型号的配网 UI：

Kotlin

LumiAccessSDKManager.getInstance().gotoAccessConfigModule(
    this,
    "deviceModel",
    object : LumiResultCallBack {
        override fun fail(errorCode: Int?, errorMessage: String?) {
            // 配网失败
        }

        override fun success(activity: WeakReference<Activity>, message: String?) {
            // 配网成功。成功后可在合适时机关闭配网页：
            activity.get()?.finish()
        }
    }
)

参数说明

3.3 配网SDK（不含UI）

目前Magic Pair配网方式，尚不支持不带UI的接入方式。