@ray-js/api 1.7.81 → 1.7.82

package/@types/PlayNetKit.d.ts

@@ -1,7 +1,7 @@
 /**
  * PlayNetKit
  *
- * @version 7.3.0
+ * @version 7.9.1
  */
 declare namespace ty.playnet {
   /**
@@ -55,7 +55,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -123,7 +123,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -277,7 +277,7 @@ declare namespace ty.playnet {
      */
     matterPayload?: SetupPayload
     /**
-     * connectResult
+     * Matter 设备连接结果，connectMatterDevice 成功后传入以继续配网
      * @since PlayNetKit 1.3.0
      */
     connectResult?: ConnectResult
@@ -290,7 +290,7 @@ declare namespace ty.playnet {
      * 目前 子设备配网是否是通过自发现配网 会添加到内部
      * @since PlayNetKit 1.3.0
      */
-    extensions?: Record<string, {}>
+    extensions?: Record<string, Record<string, any>>
     /**
      * 二维码信息  matter配网使用
      * @since PlayNetKit 1.3.0
@@ -299,7 +299,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -453,7 +453,7 @@ declare namespace ty.playnet {
      */
     matterPayload?: SetupPayload
     /**
-     * connectResult
+     * Matter 设备连接结果，connectMatterDevice 成功后传入以继续配网
      * @since PlayNetKit 1.3.0
      */
     connectResult?: ConnectResult
@@ -466,7 +466,7 @@ declare namespace ty.playnet {
      * 目前 子设备配网是否是通过自发现配网 会添加到内部
      * @since PlayNetKit 1.3.0
      */
-    extensions?: Record<string, {}>
+    extensions?: Record<string, Record<string, any>>
     /**
      * 二维码信息  matter配网使用
      * @since PlayNetKit 1.3.0
@@ -475,7 +475,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -509,42 +509,42 @@ declare namespace ty.playnet {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * version
+       * Matter Setup Payload 版本号
        * @since PlayNetKit 1.3.0
        */
       version?: number
       /**
-       * vendorId
+       * Matter 厂商 ID（Vendor ID）
        * @since PlayNetKit 1.3.0
        */
       vendorId?: number
       /**
-       * productId
+       * Matter 产品 ID（Product ID）
        * @since PlayNetKit 1.3.0
        */
       productId?: number
       /**
-       * setupPinCode
+       * Matter 配网 PIN 码
        * @since PlayNetKit 1.3.0
        */
       setupPinCode?: number
       /**
-       * commissioningFlow
+       * Matter 配网流程类型（Commissioning Flow）
        * @since PlayNetKit 1.3.0
        */
       commissioningFlow?: number
       /**
-       * optionalQrCodeInfoMap
+       * QR 码可选 TLV 信息映射
        * @since PlayNetKit 1.3.0
        */
       optionalQrCodeInfoMap?: Record<number, MatterQrCodeInfo>
       /**
-       * discoveryCapabilities
+       * 设备发现能力列表
        * @since PlayNetKit 1.3.0
        */
       discoveryCapabilities?: number[]
       /**
-       * commissioningFlow
+       * Matter 鉴别码（Discriminator）
        * @since PlayNetKit 1.3.0
        */
       discriminator?: Discriminator
@@ -605,37 +605,37 @@ declare namespace ty.playnet {
        */
       discoveryType?: string
       /**
-       * port
+       * 设备通信端口
        * @since PlayNetKit 1.3.0
        */
       port?: number
       /**
-       * ipAddress
+       * 设备 IP 地址
        * @since PlayNetKit 1.3.0
        */
       ipAddress?: string
       /**
-       * uuid
+       * 设备 UUID
        * @since PlayNetKit 1.3.0
        */
       uuid?: string
       /**
-       * thingProductId
+       * 涂鸦产品 ID
        * @since PlayNetKit 1.3.0
        */
       thingProductId?: string
       /**
-       * accessType
+       * Matter 接入类型
        * @since PlayNetKit 1.3.0
        */
       accessType?: number
       /**
-       * nodeId
+       * Matter 节点 ID
        * @since PlayNetKit 1.3.0
        */
       nodeId?: number
       /**
-       * isThingMatter
+       * 是否为涂鸦 Matter 设备
        * @since PlayNetKit 1.3.0
        */
       isThingMatter?: boolean
@@ -804,7 +804,7 @@ declare namespace ty.playnet {
      */
     matterPayload?: SetupPayload
     /**
-     * connectResult
+     * Matter 设备连接结果，connectMatterDevice 成功后传入以继续配网
      * @since PlayNetKit 1.3.0
      */
     connectResult?: ConnectResult
@@ -817,7 +817,7 @@ declare namespace ty.playnet {
      * 目前 子设备配网是否是通过自发现配网 会添加到内部
      * @since PlayNetKit 1.3.0
      */
-    extensions?: Record<string, {}>
+    extensions?: Record<string, Record<string, any>>
     /**
      * 二维码信息  matter配网使用
      * @since PlayNetKit 1.3.0
@@ -826,7 +826,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -891,7 +891,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -982,7 +982,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1120,7 +1120,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1165,7 +1165,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1192,7 +1192,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1292,6 +1292,11 @@ declare namespace ty.playnet {
     complete?: () => void
     /** 接口调用成功的回调函数 */
     success?: (params: {
+      /**
+       * uuid
+       * @since PlayNetKit 7.9.0
+       */
+      uuid: string
       /**
        * 设备id
        * @since PlayNetKit 1.1.0
@@ -1351,7 +1356,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1393,7 +1398,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1435,7 +1440,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1477,7 +1482,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1519,7 +1524,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1743,6 +1748,11 @@ declare namespace ty.playnet {
     complete?: () => void
     /** 接口调用成功的回调函数 */
     success?: (params: {
+      /**
+       * uuid
+       * @since PlayNetKit 7.9.0
+       */
+      uuid: string
       /**
        * 设备id
        * @since PlayNetKit 1.3.0
@@ -1802,7 +1812,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1905,7 +1915,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -1949,6 +1959,113 @@ declare namespace ty.playnet {
     }) => void
   }): void
 
+  /**
+   * 获取当前连接Wi-Fi的详细信息
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function getCurrentWifiInfo(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 当前连接的Wi-Fi名称
+       * @since PlayNetKit 7.9.0
+       */
+      ssid?: string
+      /**
+       * 当前连接的Wi-Fi BSSID
+       * @since PlayNetKit 7.9.0
+       */
+      bssid?: string
+      /**
+       * 当前Wi-Fi频段
+       * ONLY_24G -> 仅2.4G
+       * ONLY_5G -> 仅5G
+       * BOTH_24G_5G -> 双频同名
+       * UNKNOWN -> 未知
+       * @since PlayNetKit 7.9.0
+       */
+      wifiType?: string
+      /**
+       * 当前Wi-Fi能力串，可用于识别企业网络等
+       * @since PlayNetKit 7.9.0
+       */
+      capabilities?: string
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取当前连接Wi-Fi是否命中已缓存的密码
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function getCachedCurrentWifiPassword(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: CachedWifiPasswordInfo[]) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 打开系统Wi-Fi设置页
+   * Android用于跳转系统选择Wi-Fi；iOS可按平台限制实现为不支持或空操作
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function openSystemWifiSettings(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
   /**
    * 指定时间内扫描对应uuid的设备，扫描结果通过【onBLEScanDeviceWithUUID】事件获取
    * @public
@@ -1982,7 +2099,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2009,7 +2126,7 @@ declare namespace ty.playnet {
     /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
     /** 接口调用成功的回调函数 */
-    success?: (params: null) => void
+    success?: () => void
     /** 接口调用失败的回调函数 */
     fail?: (params: {
       /** 错误信息 */
@@ -2172,89 +2289,702 @@ declare namespace ty.playnet {
   }): void
 
   /**
-   * 配网中间态事件
-   * @public
-   * @since PlayNetKit 1.3.0
-   * @platform iOS Android
-   */
-  export function onActivateIntermediateState(
-    listener: (params: IntermediateStateResponse) => void
-  ): void
-
-  /**
-   * 配网中间态事件
-   * @public
-   * @since PlayNetKit 1.3.0
-   * @platform iOS Android
-   */
-  export function offActivateIntermediateState(
-    listener: (params: IntermediateStateResponse) => void
-  ): void
-
-  /**
-   * 扫描到的设备信息
-   * @public
-   * @since PlayNetKit 1.3.0
-   * @platform iOS Android
-   */
-  export function onScanDeviceInfo(
-    listener: (params: ScanDeviceResponse) => void
-  ): void
-
-  /**
-   * 扫描到的设备信息
+   * 启动单设备自发现扫描，扫描结果通过【onSingleDeviceDiscovered】事件持续推送
    * @public
-   * @since PlayNetKit 1.3.0
+   * @since PlayNetKit 7.9.0
    * @platform iOS Android
    */
-  export function offScanDeviceInfo(
-    listener: (params: ScanDeviceResponse) => void
-  ): void
+  export function startSingleDeviceDiscovery(params?: {
+    /**
+     * 扫描超时时间，单位秒；不填则持续扫描直到调用stopSingleDeviceDiscovery
+     * @since PlayNetKit 7.9.0
+     */
+    timeout?: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
   /**
-   * 配网的结果
+   * 停止单设备自发现扫描
    * @public
-   * @since PlayNetKit 1.3.0
+   * @since PlayNetKit 7.9.0
    * @platform iOS Android
    */
-  export function onDeviceActivateResult(
-    listener: (params: DeviceActivateResultResponse) => void
-  ): void
+  export function stopSingleDeviceDiscovery(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
   /**
-   * 配网的结果
+   * 与扫描到的单设备建立蓝牙连接，连接状态通过【onSingleBleConnectionStateChanged】事件推送
    * @public
-   * @since PlayNetKit 1.3.0
+   * @since PlayNetKit 7.9.0
    * @platform iOS Android
    */
-  export function offDeviceActivateResult(
-    listener: (params: DeviceActivateResultResponse) => void
-  ): void
+  export function connectSingleBleDevice(params: {
+    /**
+     * 设备uuid，来自onSingleDeviceDiscovered事件
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
   /**
-   * 扫描到设备后进行通知
+   * 断开单设备蓝牙连接并清理会话
    * @public
-   * @since PlayNetKit 1.1.0
+   * @since PlayNetKit 7.9.0
    * @platform iOS Android
    */
-  export function onBLEScanDevice(
-    listener: (params: ScanDevicePacket) => void
-  ): void
+  export function disconnectSingleBleDevice(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
   /**
-   * 扫描到设备后进行通知
+   * 查询单设备当前状态，仅在进入WiFi列表页首次调用；下拉刷新时直接调querySingleDeviceWifiList
    * @public
-   * @since PlayNetKit 1.1.0
+   * @since PlayNetKit 7.9.0
    * @platform iOS Android
    */
-  export function offBLEScanDevice(
-    listener: (params: ScanDevicePacket) => void
-  ): void
+  export function querySingleDeviceStatus(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 设备当前状态
+       * pendingPair -> 待配网
+       * pairing -> 配网中
+       * paired -> 已配网
+       * offline -> 离线
+       * @since PlayNetKit 7.9.0
+       */
+      status: string
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
   /**
-   * wifi状态发生变化
+   * 查询单设备可见WiFi列表，结果通过【onSingleDeviceWifiListUpdated】事件推送；
+   * needActive=true时允许走PlugPlay预激活链路；false时仅查询WiFi列表
    * @public
-   * @since PlayNetKit 1.1.0
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function querySingleDeviceWifiList(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /**
+     * 配网token。needActive=true时必须传，用于PlugPlay预激活
+     * @since PlayNetKit 7.9.0
+     */
+    token?: string
+    /**
+     * 是否允许在查询WiFi列表前触发PlugPlay预激活
+     * true -> 触发预激活并同时查询WiFi列表
+     * false/不传 -> 仅查询WiFi列表
+     * @since PlayNetKit 7.9.0
+     */
+    needActive?: boolean
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 刷新单设备可见WiFi列表，结果通过【onSingleDeviceWifiListUpdated】事件推送；
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function refreshSingleDeviceWifiList(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /**
+     * 配网token。needActive=true时必须传，用于PlugPlay预激活
+     * @since PlayNetKit 7.9.0
+     */
+    token?: string
+    /**
+     * 是否允许在查询WiFi列表前触发PlugPlay预激活
+     * true -> 触发预激活并同时查询WiFi列表
+     * false/不传 -> 仅查询WiFi列表
+     * @since PlayNetKit 7.9.0
+     */
+    needActive?: boolean
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 下发WiFi或有线配网激活指令，激活过程通过【onSingleActivationProgress】和【onSingleActivationResult】事件推送
+   * ssid/pwd为空时为有线模式（dualGateway路径）；非空时为WiFi模式（deviceScanWifi/manualWifi路径）
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function sendWifiActivation(params: {
+    /**
+     * 主节点(那台已激活、在线的 Beacon+Wi-Fi 设备)的 devId
+     * @since PlayNetKit 7.9.0
+     */
+    relayId?: string
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 配网token，通过getPairConfigToken获取
+     * @since PlayNetKit 7.9.0
+     */
+    token: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /**
+     * WiFi名称，有线模式（dualGateway）时不填
+     * @since PlayNetKit 7.9.0
+     */
+    ssid?: string
+    /**
+     * WiFi密码，有线模式（dualGateway）时不填
+     * @since PlayNetKit 7.9.0
+     */
+    pwd?: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 下发4G优先激活指令，激活过程通过【onSingleActivationProgress】和【onSingleActivationResult】事件推送
+   * 适用路径：cellular4G
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function send4GActivation(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 配网token，通过getPairConfigToken获取
+     * @since PlayNetKit 7.9.0
+     */
+    token: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 下发PlugPlay蓝牙激活指令，激活过程通过【onSingleActivationProgress】和【onSingleActivationResult】事件推送
+   * 从WiFi路径切入时须复用现有蓝牙连接和token，无需重新调connectSingleBleDevice
+   * 适用路径：plugPlay
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function sendPlugPlayActivation(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 配网token，通过getPairConfigToken获取
+     * @since PlayNetKit 7.9.0
+     */
+    token: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 中止当前设备的激活流程，路径切换或用户取消时调用
+   * 切换到plugPlay前必须先调此方法，避免命令冲突
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function stopSingleActivation(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 通过蓝牙通道向设备下发软重置指令，使设备重新进入配网广播模式
+   * 不断开蓝牙连接，不清除token，仅触发设备侧状态重置
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function resetSingleBleDevice(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 强绑定解绑
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function goUnbindFeedback(params: {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /**
+     * 配网成功后的设备id，success为true时有值
+     * @since PlayNetKit 7.9.0
+     */
+    deviceId?: string
+    /**
+     * 错误码，success为false时有值
+     * @since PlayNetKit 7.9.0
+     */
+    errorCode?: number
+    /**
+     * 失败所处阶段（D/E/F/G），success为false时有值
+     * @since PlayNetKit 7.9.0
+     */
+    errorStage?: string
+    /**
+     * 是否可以重试，G阶段账号绑定限制类为false
+     * @since PlayNetKit 7.9.0
+     */
+    canRetry?: boolean
+    /**
+     * 是否可以自动重置设备救回，D/F阶段兜底类为true
+     * @since PlayNetKit 7.9.0
+     */
+    canAutoReset?: boolean
+    /**
+     * 设备名称
+     * @since PlayNetKit 7.9.0
+     */
+    name?: string
+    /**
+     * 设备图标URL
+     * @since PlayNetKit 7.9.0
+     */
+    iconUrl?: string
+    /**
+     * 房间ID
+     * @since PlayNetKit 7.9.0
+     */
+    roomId?: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 查询当前家庭下的 beacon Wifi Master 节点
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function queryFlashDistributionNode(params: {
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /**
+     * ssid
+     * @since PlayNetKit 7.9.0
+     */
+    ssid?: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 配网中间态事件
+   * @public
+   * @since PlayNetKit 1.3.0
+   * @platform iOS Android
+   */
+  export function onActivateIntermediateState(
+    listener: (params: IntermediateStateResponse) => void
+  ): void
+
+  /**
+   * 配网中间态事件
+   * @public
+   * @since PlayNetKit 1.3.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onActivateIntermediateState(listener)
+   * ty.playnet.offActivateIntermediateState(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offActivateIntermediateState(
+    listener: (params: IntermediateStateResponse) => void
+  ): void
+
+  /**
+   * 扫描到的设备信息
+   * @public
+   * @since PlayNetKit 1.3.0
+   * @platform iOS Android
+   */
+  export function onScanDeviceInfo(
+    listener: (params: ScanDeviceResponse) => void
+  ): void
+
+  /**
+   * 扫描到的设备信息
+   * @public
+   * @since PlayNetKit 1.3.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onScanDeviceInfo(listener)
+   * ty.playnet.offScanDeviceInfo(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offScanDeviceInfo(
+    listener: (params: ScanDeviceResponse) => void
+  ): void
+
+  /**
+   * 配网的结果
+   * @public
+   * @since PlayNetKit 1.3.0
+   * @platform iOS Android
+   */
+  export function onDeviceActivateResult(
+    listener: (params: DeviceActivateResultResponse) => void
+  ): void
+
+  /**
+   * 配网的结果
+   * @public
+   * @since PlayNetKit 1.3.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onDeviceActivateResult(listener)
+   * ty.playnet.offDeviceActivateResult(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offDeviceActivateResult(
+    listener: (params: DeviceActivateResultResponse) => void
+  ): void
+
+  /**
+   * 扫描到设备后进行通知
+   * @public
+   * @since PlayNetKit 1.1.0
+   * @platform iOS Android
+   */
+  export function onBLEScanDevice(
+    listener: (params: ScanDevicePacket) => void
+  ): void
+
+  /**
+   * 扫描到设备后进行通知
+   * @public
+   * @since PlayNetKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onBLEScanDevice(listener)
+   * ty.playnet.offBLEScanDevice(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offBLEScanDevice(
+    listener: (params: ScanDevicePacket) => void
+  ): void
+
+  /**
+   * wifi状态发生变化
+   * @public
+   * @since PlayNetKit 1.1.0
    * @platform iOS Android
    */
   export function onWifiStateChange(listener: (params: Privacy) => void): void
@@ -2263,6 +2993,12 @@ declare namespace ty.playnet {
    * wifi状态发生变化
    * @public
    * @since PlayNetKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onWifiStateChange(listener)
+   * ty.playnet.offWifiStateChange(listener)
+   * ```
    * @platform iOS Android
    */
   export function offWifiStateChange(listener: (params: Privacy) => void): void
@@ -2279,6 +3015,12 @@ declare namespace ty.playnet {
    * 蓝牙状态发生变化
    * @public
    * @since PlayNetKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onBLEStateChange(listener)
+   * ty.playnet.offBLEStateChange(listener)
+   * ```
    * @platform iOS Android
    */
   export function offBLEStateChange(listener: (params: Privacy) => void): void
@@ -2297,6 +3039,12 @@ declare namespace ty.playnet {
    * 蓝牙权限发生变化
    * @public
    * @since PlayNetKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onBlePermissionChange(listener)
+   * ty.playnet.offBlePermissionChange(listener)
+   * ```
    * @platform iOS Android
    */
   export function offBlePermissionChange(
@@ -2317,6 +3065,12 @@ declare namespace ty.playnet {
    * 本地网络权限发生变化
    * @public
    * @since PlayNetKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onlocalNetWorkPermissionChange(listener)
+   * ty.playnet.offlocalNetWorkPermissionChange(listener)
+   * ```
    * @platform iOS Android
    */
   export function offlocalNetWorkPermissionChange(
@@ -2337,6 +3091,12 @@ declare namespace ty.playnet {
    * 老流程配网,阶段上报
    * @public
    * @since PlayNetKit 1.3.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onReceiveActivatorState(listener)
+   * ty.playnet.offReceiveActivatorState(listener)
+   * ```
    * @platform iOS Android
    */
   export function offReceiveActivatorState(
@@ -2357,12 +3117,200 @@ declare namespace ty.playnet {
    * 扫描到设备后进行通知
    * @public
    * @since PlayNetKit 1.3.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onBLEScanDeviceWithUUID(listener)
+   * ty.playnet.offBLEScanDeviceWithUUID(listener)
+   * ```
    * @platform iOS Android
    */
   export function offBLEScanDeviceWithUUID(
     listener: (params: ScanDevicePacket) => void
   ): void
 
+  /**
+   * 自发现到新设备时回调
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function onSingleDeviceDiscovered(
+    listener: (params: SingleDeviceDiscoveredEvent) => void
+  ): void
+
+  /**
+   * 自发现到新设备时回调
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onSingleDeviceDiscovered(listener)
+   * ty.playnet.offSingleDeviceDiscovered(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offSingleDeviceDiscovered(
+    listener: (params: SingleDeviceDiscoveredEvent) => void
+  ): void
+
+  /**
+   * 蓝牙连接状态变化回调
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function onSingleBleConnectionStateChanged(
+    listener: (params: SingleBleConnectionEvent) => void
+  ): void
+
+  /**
+   * 蓝牙连接状态变化回调
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onSingleBleConnectionStateChanged(listener)
+   * ty.playnet.offSingleBleConnectionStateChanged(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offSingleBleConnectionStateChanged(
+    listener: (params: SingleBleConnectionEvent) => void
+  ): void
+
+  /**
+   * 单设备可见WiFi列表更新回调，可能多次触发（设备端流式返回）
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function onSingleDeviceWifiListUpdated(
+    listener: (params: SingleDeviceWifiListEvent) => void
+  ): void
+
+  /**
+   * 单设备可见WiFi列表更新回调，可能多次触发（设备端流式返回）
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onSingleDeviceWifiListUpdated(listener)
+   * ty.playnet.offSingleDeviceWifiListUpdated(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offSingleDeviceWifiListUpdated(
+    listener: (params: SingleDeviceWifiListEvent) => void
+  ): void
+
+  /**
+   * 配网中间阶段进度回调
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function onSingleActivationProgress(
+    listener: (params: SingleActivationProgressEvent) => void
+  ): void
+
+  /**
+   * 配网中间阶段进度回调
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onSingleActivationProgress(listener)
+   * ty.playnet.offSingleActivationProgress(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offSingleActivationProgress(
+    listener: (params: SingleActivationProgressEvent) => void
+  ): void
+
+  /**
+   * 配网最终结果回调，每次激活只触发一次
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function onSingleActivationResult(
+    listener: (params: SingleActivationResultEvent) => void
+  ): void
+
+  /**
+   * 配网最终结果回调，每次激活只触发一次
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onSingleActivationResult(listener)
+   * ty.playnet.offSingleActivationResult(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offSingleActivationResult(
+    listener: (params: SingleActivationResultEvent) => void
+  ): void
+
+  /**
+   * Plugplay结果回调
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function onSingleActivationPlugPlayResult(
+    listener: (params: SingleActivationResultEvent) => void
+  ): void
+
+  /**
+   * Plugplay结果回调
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onSingleActivationPlugPlayResult(listener)
+   * ty.playnet.offSingleActivationPlugPlayResult(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offSingleActivationPlugPlayResult(
+    listener: (params: SingleActivationResultEvent) => void
+  ): void
+
+  /**
+   * wifi 发生变化
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @platform iOS Android
+   */
+  export function onReachabilityChanged(
+    listener: (params: Record<string, any>) => void
+  ): void
+
+  /**
+   * wifi 发生变化
+   * @public
+   * @since PlayNetKit 7.9.0
+   * @example Demo
+   * ```tsx
+   * const listener = function (res) { console.log(res) }
+   * ty.playnet.onReachabilityChanged(listener)
+   * ty.playnet.offReachabilityChanged(listener)
+   * ```
+   * @platform iOS Android
+   */
+  export function offReachabilityChanged(
+    listener: (params: Record<string, any>) => void
+  ): void
+
   /** @since PlayNetKit 1.3.0 */
   export interface ScanParams {
     /**
@@ -2429,7 +3377,7 @@ declare namespace ty.playnet {
      */
     icon?: string
     /**
-     * 设备icon
+     * 产品 ID（Product ID）
      * @since PlayNetKit 1.3.0
      * @defaultValue ""
      */
@@ -2456,7 +3404,7 @@ declare namespace ty.playnet {
      */
     isThingMatter?: boolean
     /**
-     * 错误码，0-为成功
+     * 扫描异常时的错误码，成功或未出错时可不传；0 表示无错误
      * @since PlayNetKit 1.3.0
      */
     errorCode?: string
@@ -2509,93 +3457,93 @@ declare namespace ty.playnet {
   /** @since PlayNetKit 1.3.0 */
   export interface HgwBean {
     /**
-     * ip
+     * 网关 IP 地址
      * @since PlayNetKit 1.3.0
      */
     ip: string
     /**
-     * gwId
+     * 网关设备 ID
      * @since PlayNetKit 1.3.0
      */
     gwId: string
     /**
-     * active
+     * 激活状态
      * @since PlayNetKit 1.3.0
      */
     active?: number
     /**
-     * ablilty
+     * 能力位（字段名 ablilty 为历史拼写）
      * @since PlayNetKit 1.3.0
      */
     ablilty?: number
     /**
-     * lastSeenTime
+     * 最后一次被发现的时间戳
      * @since PlayNetKit 1.3.0
      */
     lastSeenTime?: number
     /**
-     * mode
+     * 工作模式
      * @since PlayNetKit 1.3.0
      */
     mode?: number
     /**
-     * productKey
+     * 产品 Key
      * @since PlayNetKit 1.3.0
      */
     productKey?: string
     /**
-     * encrypt
+     * 是否加密通信
      * @since PlayNetKit 1.3.0
      */
     encrypt?: boolean
     /**
-     * version
+     * 协议版本号
      * @since PlayNetKit 1.3.0
      */
     version: string
     /**
-     * token
+     * 是否支持 Token 配网
      * @since PlayNetKit 1.3.0
      */
     token?: boolean
     /**
-     * wf_cfg
+     * 是否支持 Wi-Fi 配置
      * @since PlayNetKit 1.3.0
      */
     wf_cfg?: boolean
     /**
-     * extend
+     * 扩展信息
      * @since PlayNetKit 1.3.0
      */
     extend?: string
     /**
-     * ssid
+     * 网关当前连接的 Wi-Fi 名称
      * @since PlayNetKit 1.3.0
      */
     ssid?: string
     /**
-     * devConfigAttribute
+     * 设备配置属性
      * @since PlayNetKit 1.3.0
      */
     devConfigAttribute?: number
     /**
-     * apConfigType
+     * AP 配网类型
      * @since PlayNetKit 1.3.0
      */
     apConfigType?: number
     /**
-     * sl
+     * 信号强度等级
      * @since PlayNetKit 1.3.0
      * @defaultValue -1
      */
     sl?: number
     /**
-     * uuid
+     * 设备 UUID
      * @since PlayNetKit 1.3.0
      */
     uuid?: string
     /**
-     * proAbility
+     * 产品能力位
      * @since PlayNetKit 1.3.0
      */
     proAbility?: number
@@ -2604,17 +3552,17 @@ declare namespace ty.playnet {
   /** @since PlayNetKit 1.3.0 */
   export interface MatterQrCodeInfo {
     /**
-     * tag
+     * QR 码 TLV 标签
      * @since PlayNetKit 1.3.0
      */
     tag?: number
     /**
-     * intDataValue
+     * 整型数据值
      * @since PlayNetKit 1.3.0
      */
     intDataValue?: number
     /**
-     * data
+     * 字符串数据值
      * @since PlayNetKit 1.3.0
      */
     data?: string
@@ -2629,12 +3577,12 @@ declare namespace ty.playnet {
   /** @since PlayNetKit 1.3.0 */
   export interface Discriminator {
     /**
-     * value
+     * 鉴别码数值
      * @since PlayNetKit 1.3.0
      */
     value?: number
     /**
-     * shortDiscriminator
+     * 是否为短鉴别码（12 bit）
      * @since PlayNetKit 1.3.0
      */
     shortDiscriminator?: boolean
@@ -2643,42 +3591,42 @@ declare namespace ty.playnet {
   /** @since PlayNetKit 1.3.0 */
   export interface SetupPayload {
     /**
-     * version
+     * Matter Setup Payload 版本号
      * @since PlayNetKit 1.3.0
      */
     version?: number
     /**
-     * vendorId
+     * Matter 厂商 ID（Vendor ID）
      * @since PlayNetKit 1.3.0
      */
     vendorId?: number
     /**
-     * productId
+     * Matter 产品 ID（Product ID）
      * @since PlayNetKit 1.3.0
      */
     productId?: number
     /**
-     * setupPinCode
+     * Matter 配网 PIN 码
      * @since PlayNetKit 1.3.0
      */
     setupPinCode?: number
     /**
-     * commissioningFlow
+     * Matter 配网流程类型（Commissioning Flow）
      * @since PlayNetKit 1.3.0
      */
     commissioningFlow?: number
     /**
-     * optionalQrCodeInfoMap
+     * QR 码可选 TLV 信息映射
      * @since PlayNetKit 1.3.0
      */
     optionalQrCodeInfoMap?: Record<number, MatterQrCodeInfo>
     /**
-     * discoveryCapabilities
+     * 设备发现能力列表
      * @since PlayNetKit 1.3.0
      */
     discoveryCapabilities?: number[]
     /**
-     * commissioningFlow
+     * Matter 鉴别码（Discriminator）
      * @since PlayNetKit 1.3.0
      */
     discriminator?: Discriminator
@@ -2693,37 +3641,37 @@ declare namespace ty.playnet {
      */
     discoveryType?: string
     /**
-     * port
+     * 设备通信端口
      * @since PlayNetKit 1.3.0
      */
     port?: number
     /**
-     * ipAddress
+     * 设备 IP 地址
      * @since PlayNetKit 1.3.0
      */
     ipAddress?: string
     /**
-     * uuid
+     * 设备 UUID
      * @since PlayNetKit 1.3.0
      */
     uuid?: string
     /**
-     * thingProductId
+     * 涂鸦产品 ID
      * @since PlayNetKit 1.3.0
      */
     thingProductId?: string
     /**
-     * accessType
+     * Matter 接入类型
      * @since PlayNetKit 1.3.0
      */
     accessType?: number
     /**
-     * nodeId
+     * Matter 节点 ID
      * @since PlayNetKit 1.3.0
      */
     nodeId?: number
     /**
-     * isThingMatter
+     * 是否为涂鸦 Matter 设备
      * @since PlayNetKit 1.3.0
      */
     isThingMatter?: boolean
@@ -2743,74 +3691,73 @@ declare namespace ty.playnet {
   /** @since PlayNetKit 1.3.0 */
   export interface ScanDeviceBean {
     /**
-     * id
+     * 设备唯一标识
      * @since PlayNetKit 1.3.0
      */
     id?: string
     /**
-     * name
+     * 设备名称
      * @since PlayNetKit 1.3.0
      */
     name?: string
     /**
-     * providerName
+     * 设备提供商名称
      * @since PlayNetKit 1.3.0
      */
     providerName?: string
     /**
-     * data
+     * 设备原始扫描数据
      * @since PlayNetKit 1.3.0
      */
     data?: string
     /**
-     * configType
+     * 配网配置类型
      * @since PlayNetKit 1.3.0
      */
     configType?: string
     /**
-     * productId
+     * 产品 ID
      * @since PlayNetKit 1.3.0
      */
     productId?: string
     /**
-     * uuid
+     * 设备 UUID
      * @since PlayNetKit 1.3.0
      */
     uuid?: string
     /**
-     * mac
+     * 设备 MAC 地址
      * @since PlayNetKit 1.3.0
      */
     mac?: string
     /**
-     * address
+     * 设备网络地址
      * @since PlayNetKit 1.3.0
      */
     address?: string
     /**
-     * deviceType
+     * 设备类型
      * @since PlayNetKit 1.3.0
      */
     deviceType?: number
     /**
-     * isbind
+     * 是否已绑定
      * @since PlayNetKit 1.3.0
      */
     isbind?: boolean
     /**
-     * flag
+     * 设备标志位
      * @since PlayNetKit 1.3.0
      * @defaultValue 0
      */
     flag?: number
     /**
-     * /**
-     *  isShare
+     * 是否为共享设备
      * @since PlayNetKit 1.3.0
      */
     isShare?: boolean
     /**
-     * isRoam
+     * 是否为漫游设备
      * @since PlayNetKit 1.3.0
      */
     isRoam?: boolean
@@ -2948,7 +3895,7 @@ declare namespace ty.playnet {
      */
     matterPayload?: SetupPayload
     /**
-     * connectResult
+     * Matter 设备连接结果，connectMatterDevice 成功后传入以继续配网
      * @since PlayNetKit 1.3.0
      */
     connectResult?: ConnectResult
@@ -2961,7 +3908,7 @@ declare namespace ty.playnet {
      * 目前 子设备配网是否是通过自发现配网 会添加到内部
      * @since PlayNetKit 1.3.0
      */
-    extensions?: Record<string, {}>
+    extensions?: Record<string, Record<string, any>>
     /**
      * 二维码信息  matter配网使用
      * @since PlayNetKit 1.3.0
@@ -3079,7 +4026,7 @@ declare namespace ty.playnet {
      */
     ssid?: string
     /**
-     * i-Fi信号强度
+     * Wi-Fi 信号强度，单位 dBm，数值越大信号越强
      * @since PlayNetKit 1.3.0
      * @defaultValue 0
      */
@@ -3123,12 +4070,12 @@ declare namespace ty.playnet {
      */
     uuid: string
     /**
-     * 配网阶段
+     * 配网阶段编号，用于标识当前配网流程所处的阶段
      * @since PlayNetKit 1.3.0
      */
     configStage: number
     /**
-     * 状态
+     * 配网中间态状态码，与 configStage 配合表示当前进度或结果
      * @since PlayNetKit 1.3.0
      */
     state: number
@@ -3495,6 +4442,11 @@ declare namespace ty.playnet {
 
   /** @since PlayNetKit 1.1.0 */
   export interface DeviceInfo {
+    /**
+     * uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
     /**
      * 设备id
      * @since PlayNetKit 1.1.0
@@ -3767,6 +4719,53 @@ declare namespace ty.playnet {
     capabilities: string
   }
 
+  /** @since PlayNetKit 7.9.0 */
+  export interface CurrentWifiInfo {
+    /**
+     * 当前连接的Wi-Fi名称
+     * @since PlayNetKit 7.9.0
+     */
+    ssid?: string
+    /**
+     * 当前连接的Wi-Fi BSSID
+     * @since PlayNetKit 7.9.0
+     */
+    bssid?: string
+    /**
+     * 当前Wi-Fi频段
+     * ONLY_24G -> 仅2.4G
+     * ONLY_5G -> 仅5G
+     * BOTH_24G_5G -> 双频同名
+     * UNKNOWN -> 未知
+     * @since PlayNetKit 7.9.0
+     */
+    wifiType?: string
+    /**
+     * 当前Wi-Fi能力串，可用于识别企业网络等
+     * @since PlayNetKit 7.9.0
+     */
+    capabilities?: string
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface CachedWifiPasswordInfo {
+    /**
+     * 当前连接Wi-Fi是否命中已缓存密码
+     * @since PlayNetKit 7.9.0
+     */
+    hit: boolean
+    /**
+     * 命中时返回缓存ssid
+     * @since PlayNetKit 7.9.0
+     */
+    ssid?: string
+    /**
+     * 命中时返回缓存password
+     * @since PlayNetKit 7.9.0
+     */
+    password?: string
+  }
+
   /** @since PlayNetKit 1.3.0 */
   export interface BLEScanMatchParam {
     /**
@@ -3873,4 +4872,389 @@ declare namespace ty.playnet {
      */
     devId?: string
   }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleDeviceDiscoveryParam {
+    /**
+     * 扫描超时时间，单位秒；不填则持续扫描直到调用stopSingleDeviceDiscovery
+     * @since PlayNetKit 7.9.0
+     */
+    timeout?: number
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleBleConnectParam {
+    /**
+     * 设备uuid，来自onSingleDeviceDiscovered事件
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleStopParam {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleDeviceStatusParam {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleDeviceStatusResult {
+    /**
+     * 设备当前状态
+     * pendingPair -> 待配网
+     * pairing -> 配网中
+     * paired -> 已配网
+     * offline -> 离线
+     * @since PlayNetKit 7.9.0
+     */
+    status: string
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleDeviceWifiQueryParam {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /**
+     * 配网token。needActive=true时必须传，用于PlugPlay预激活
+     * @since PlayNetKit 7.9.0
+     */
+    token?: string
+    /**
+     * 是否允许在查询WiFi列表前触发PlugPlay预激活
+     * true -> 触发预激活并同时查询WiFi列表
+     * false/不传 -> 仅查询WiFi列表
+     * @since PlayNetKit 7.9.0
+     */
+    needActive?: boolean
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleActivationWifiParam {
+    /**
+     * 主节点(那台已激活、在线的 Beacon+Wi-Fi 设备)的 devId
+     * @since PlayNetKit 7.9.0
+     */
+    relayId?: string
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 配网token，通过getPairConfigToken获取
+     * @since PlayNetKit 7.9.0
+     */
+    token: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /**
+     * WiFi名称，有线模式（dualGateway）时不填
+     * @since PlayNetKit 7.9.0
+     */
+    ssid?: string
+    /**
+     * WiFi密码，有线模式（dualGateway）时不填
+     * @since PlayNetKit 7.9.0
+     */
+    pwd?: string
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleActivation4GParam {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 配网token，通过getPairConfigToken获取
+     * @since PlayNetKit 7.9.0
+     */
+    token: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleActivationPlugPlayParam {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 配网token，通过getPairConfigToken获取
+     * @since PlayNetKit 7.9.0
+     */
+    token: string
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleActivationResultEvent {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 是否配网成功
+     * @since PlayNetKit 7.9.0
+     */
+    success: boolean
+    /**
+     * 配网成功后的设备id，success为true时有值
+     * @since PlayNetKit 7.9.0
+     */
+    deviceId?: string
+    /**
+     * 错误码，success为false时有值
+     * @since PlayNetKit 7.9.0
+     */
+    errorCode?: number
+    /**
+     * 失败所处阶段（D/E/F/G），success为false时有值
+     * @since PlayNetKit 7.9.0
+     */
+    errorStage?: string
+    /**
+     * 是否可以重试，G阶段账号绑定限制类为false
+     * @since PlayNetKit 7.9.0
+     */
+    canRetry?: boolean
+    /**
+     * 是否可以自动重置设备救回，D/F阶段兜底类为true
+     * @since PlayNetKit 7.9.0
+     */
+    canAutoReset?: boolean
+    /**
+     * 设备名称
+     * @since PlayNetKit 7.9.0
+     */
+    name?: string
+    /**
+     * 设备图标URL
+     * @since PlayNetKit 7.9.0
+     */
+    iconUrl?: string
+    /**
+     * 房间ID
+     * @since PlayNetKit 7.9.0
+     */
+    roomId?: string
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface DistributionNodeInfo {
+    /**
+     * 家庭id
+     * @since PlayNetKit 7.9.0
+     */
+    homeId: number
+    /**
+     * ssid
+     * @since PlayNetKit 7.9.0
+     */
+    ssid?: string
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleDeviceDiscoveredEvent {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 设备mac地址
+     * @since PlayNetKit 7.9.0
+     */
+    mac: string
+    /**
+     * 产品id
+     * @since PlayNetKit 7.9.0
+     */
+    productId: string
+    /**
+     * 设备名称
+     * @since PlayNetKit 7.9.0
+     */
+    name: string
+    /**
+     * 设备类型，用于上层分发配网路径
+     * @since PlayNetKit 7.9.0
+     */
+    deviceType: number
+    /**
+     * 信号强度
+     * @since PlayNetKit 7.9.0
+     */
+    rssi: number
+    /**
+     * 配网类型
+     * @since PlayNetKit 7.9.0
+     */
+    configType: string
+    /**
+     * 设备蓝牙地址
+     * @since PlayNetKit 7.9.0
+     */
+    address: string
+    /**
+     * 归一化后的设备能力集合，供小程序做path分发
+     * CELLULAR_4G_PREFER -> 4G优先
+     * WIFI_LIST_SCAN -> 支持设备端扫描WiFi列表
+     * PLUG_PLAY -> 支持PlugPlay兜底
+     * DUAL_GATEWAY -> 支持双联网关
+     * SUPPORT_5G -> 支持5G
+     * @since PlayNetKit 7.9.0
+     */
+    caps?: string[]
+    /**
+     * 是否支持PlugPlay
+     * @since PlayNetKit 7.9.0
+     */
+    supportPlugPlay?: boolean
+    /**
+     * 是否支持5G
+     * @since PlayNetKit 7.9.0
+     */
+    support5G?: boolean
+    /**
+     * 是否支持4G优先激活
+     * @since PlayNetKit 7.9.0
+     */
+    support4G?: boolean
+    /**
+     * 是否支持双联网关
+     * @since PlayNetKit 7.9.0
+     */
+    supportDualGateway?: boolean
+    /**
+     * 是否支持 Beacon+Wi-Fi（闪电分发），供上层判定是否走 WiFi+Beacon 设备配网路径
+     * @since PlayNetKit 7.9.0
+     */
+    isBeaconWifi?: boolean
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleBleConnectionEvent {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 连接状态
+     * connecting -> 连接中
+     * connected -> 已连接
+     * disconnected -> 已断开
+     * failed -> 连接失败
+     * @since PlayNetKit 7.9.0
+     */
+    state: string
+    /**
+     * 错误码，仅在state为failed时有值
+     * @since PlayNetKit 7.9.0
+     */
+    errorCode?: number
+    /**
+     * 强绑定（DEVICE_ALREADY_BIND）失败时，服务端回带的云端真实设备 devId。
+     * 小程序「提交解绑申请」(goUnbindFeedback) 需要它作为 hdId 拉起解绑反馈页。
+     * 仅在 state 为 failed 且 errorCode 为 207228 时有值。
+     * 注：TUNI 错误通道只透传 errorCode/errorMsg，模型无法随 reject 下发，故挂在本事件上。
+     * @since PlayNetKit 7.9.0
+     */
+    boundDeviceId?: string
+    /**
+     * 强绑定失败时云端真实设备名称（展示用，可空）。
+     * @since PlayNetKit 7.9.0
+     */
+    boundDeviceName?: string
+    /**
+     * 强绑定失败时云端真实设备图标 URL（展示用，可空）。
+     * @since PlayNetKit 7.9.0
+     */
+    boundDeviceIconUrl?: string
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleDeviceWifiListEvent {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 设备可见的WiFi列表
+     * @since PlayNetKit 7.9.0
+     */
+    wifiList: WiFiInfo[]
+  }
+
+  /** @since PlayNetKit 7.9.0 */
+  export interface SingleActivationProgressEvent {
+    /**
+     * 设备uuid
+     * @since PlayNetKit 7.9.0
+     */
+    uuid: string
+    /**
+     * 配网阶段标识
+     * A -> 设备发现
+     * B -> 蓝牙连接
+     * C -> 鉴权
+     * D -> 下发WiFi凭证
+     * E -> 设备联网
+     * F -> 云端激活
+     * G -> 绑定限制
+     * @since PlayNetKit 7.9.0
+     */
+    stage: string
+    /**
+     * 阶段状态描述
+     * @since PlayNetKit 7.9.0
+     */
+    status: string
+    /**
+     * 标准化进度百分比，取值范围0-100；无明确百分比时可不传
+     * @since PlayNetKit 7.9.0
+     */
+    percent?: number
+  }
 }