设备配网

Overview

设备配网是用户配置设备的第一步。设备配网SDK提供了把设备配置到路由器的能力，目前提供以下两种配网方式：

• BLE配网模式

• SoftAP配网模式

Android10及以上需要提供定位权限，拿到手机所连的Wi-Fi的名称。

BLE 配网模式

BLE SDK 中提供了配网功能，通过与设备建立BLE连接，发送配网信息至设备，设备连接Wi-Fi之后发送连接结果给App。

开始扫描BLE设备

• 接口说明

  开始扫描BLE设备

    startScan(LPBLEScanListener listener)
  

• 参数

• 返回值

  无

停止扫描BLE设备

• 接口说明

  配网结束或者不需要扫描时，请停止扫描BLE设备，降低应用耗电。

    stopScan()
  

• 参数

  无

• 返回值

  无

连接设备

• 接口说明

  与设备建立BLE连接。

    connectBLE(LPBluetoothDevice device，LPConnectBLEListener listener)
  

• 参数

• 返回值

  无

• 示例代码

    LPBLEManager.getInstance().connectBLE(bluetoothDevice, new LPConnectBLEListener() {
                @Override
                public void onFailed(int i, String s) {
                    Log.i(TAG, "connectBLE onFailed");
                }
  
                @Override
                public void onStartConnect() {
                    Log.i(TAG, "connectBLE onStartConnect");
                }
  
                @Override
                public void onConnectFail(Exception e) {
                    Log.i(TAG, "connectBLE onConnectFail");
                }
  
                @Override
                public void onConnectSuccess(BluetoothGatt bluetoothGatt, int i) {
  
                    Log.i(TAG, "connectBLE onConnectSuccess");
                }
  
                @Override
                public void onDisConnected(boolean b, BluetoothGatt bluetoothGatt, int i) {
                    Log.i(TAG, "connectBLE onDisConnected");
                }
            });
  

断开与设备的连接

• 接口说明

  断开与设备的BLE连接。

    disConnect()
  

• 参数

  无

• 返回值

  无

获取 Wi-Fi 列表

• 接口说明

  获取设备周边的 Wi-Fi 列表。

    getWLANList(LPBLEAPListListener listener)
  

• 参数

• 返回值

  无

• 示例代码

    LPBLEManager.getInstance().getWLANList(new LPBLEAPListListener() {
            @Override
            public void onSuccess(List<BLEAPInfo> apItemList) {
  
                Log.i(TAG, "Get WiFi list success++");
  
                adapter.clear();
  
                ArrayList<BLEAPInfo> arrayList = new ArrayList<>();
  
                arrayList.addAll(apItemList);
  
                ArrayList<BLEAPInfo> finalAPLIst = arrayList;
  
                refreshHandler.post(new Runnable() {
                    @Override
                    public void run() {
  
                        adapter.setDeviceList(finalAPLIst);
                        adapter.notifyDataSetChanged();
                    }
                });
            }
  
            @Override
            public void onFailed(Exception e) {
                Log.i(TAG, "Get WiFi list failed++");
            }
        });
  

发送配网信息

• 接口说明

  发送配网指令。

    connectToWiFi(String ssid, String pwd, LPBLEConnectWifiListener listener)
  

• 参数

• 返回值

  无

• 示例代码

    LPBLEManager.getInstance().connectWLAN(ssid, pwd,
                            new LPConnectBLEListener() {
                                @Override
                                public void LPConnectSuccess(String ip, String uuid) {
                                    //searching device online
                                    connectSuccess(ip, uuid);
                                }
  
                                @Override
                                public void LPConnectFailed(int errorCode) {
                                    //connect failed
                                    connectFail(errorCode);
                                }
                            });
  

LPBLEState

• 描述 BLE 配网流程中使用的常量

• 常量

SoftAP 配网模式

LPWiFiSetupManager 提供了Wi-Fi配网的能力。

• LPApItem

  路由信息：ssid名称，信号强度，bssid地址等

• LPWiFiSetupFailed errorCode

  errorCode 所对应的含义

检测手机是否连接到设备热点

• 接口说明

  Wi-Fi配网模式需要手机的Wi-Fi连接到设备的热点网络上，所以需要检测手机的Wi-Fi是否连接到设备热点，可以设定检测的时间

    isLinkplayHotspot()
  

• 参数

N/A

• 返回值

  BOOL

获取 Wi-Fi 列表

• 接口说明

  手机Wi-Fi连接到设备热点后，可以获取到周边的Wi-Fi列表。

    getApList（LPApListListener listener）
  

• 参数

• 返回值

  无

开始配网接口

• 接口说明

    connectToWiFi(LPApItem item, String pwd, LPWiFiSetupListener listener)
  

  设备连接Wi-Fi时，手机与设备之间的连接将会断开，手机会自动连接到其他Wi-Fi上。请提示用户将手机连接到目标Wi-Fi上。

• 参数

• 返回值

  无

重新检测配网结果

• 接口说明

  配网失败后，如果手机所连WiFi和选择的目标路由器Wi-Fi不一致，可调用此方法重新检测配网结果

    retryCheckWithTime（int timeout, LPWiFiSetupListener listener）
  

• 参数

• 返回值

  无