本文介绍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。