蓝牙 Mesh 批量配网

本文介绍Android SDK中提供蓝牙Mesh设备批量配网的能力。

依赖

依赖 SDK

概述

MeshSdk

提供蓝牙mesh基础能力。

DeviceCenter

配网统一入口。

ApiClient

提供API通道能力,和基础环境配置信息。

初始化

初始化的操作请参见SDK初始化

配网

  • 带配网设备列表

    DeviceInfo来源由设备发现返回,不用做修改

    DeviceInfo 属性说明如下:

    属性

    类型

    是否必填

    描述

    linkType

    enum

    ALI_APP_MESH 为APP本地发现;ALI_GATEWAY_MESH为网关发现

    productId

    String

    mac

    String

    productKey

    String

    addDeviceFrom

    String

    描述

    meshGatewayIotId

    String

    meshDeviceId

    String

    deviceId

    String

  • 开始配网

     AddDeviceBiz.getInstance().startConcurrentAddDevice(Context context,List<DeviceInfo> devicesInfos,IConcurrentAddDeviceListener listener);
                        
  • 配网结果回调

    interface IConcurrentAddDeviceListener {
    
        /**
         * 当 DeviceInfo 校验完成后触发
         *
         * @param deviceInfo  当前正在操作的DeviceInfo
         * @param isSuccess   true 表示成功 false 表示失败
         * @param dcErrorCode 失败ErrorCode
         */
        void onPreCheck(DeviceInfo deviceInfo, boolean isSuccess, DCErrorCode dcErrorCode);
    
        /**
         * 当准备配网时触发
         */
        void onProvisionPrepare(DeviceInfo deviceInfo, int prepareType);
    
        /**
         * 当开始配网时触发
         */
        void onProvisioning(DeviceInfo deviceInfo);
    
        /**
         * 当配网状态发生变化时触发
         * @param status 当前配网状态,请参见ProvisionStatus
         */
        void onProvisionStatus(DeviceInfo deviceInfo, ProvisionStatus status);
    
        /**
         * 当配网结束时触发
         *
         * @param isSuccess   是否成功
         * @param deviceInfo  成功时返回的设备信息
         * @param dcErrorCode 失败时返回的错误码
         */
        void onProvisionedResult(boolean isSuccess, DeviceInfo deviceInfo, DCErrorCode dcErrorCode);
  • 停止配网

    AddDeviceBiz.getInstance().stopConcurrentAddDevice();

网关控制

网关控制参考物模型SDK