@ray-js/api 1.7.70 → 1.7.72

package/@types/HomeKit.d.ts

@@ -1,85 +1,173 @@
 /**
  * HomeKit
  *
- * @version 3.1.4
+ * @version 3.17.3
  */
 declare namespace ty.home {
-  // /**
-  //  * 请求接口，获取本地设备时区信息，并写入缓存
-  //  */
-  // export function getLocalDeviceConfigWithDevId(params: {
-  //   /** 设备ID */
-  //   devId: string
-  //   complete?: () => void
-  //   success?: (params: null) => void
-  //   fail?: (params: {
-  //     errorMsg: string
-  //     errorCode: string | number
-  //     innerError: {
-  //       errorCode: string | number
-  //       errorMsg: string
-  //     }
-  //   }) => void
-  // }): void
-
-  // /**
-  //  * 修改家庭信息
-  //  */
-  // export function updateHomeInfoData(params: {
-  //   /** 家庭名称 */
-  //   homeName: string
-  //   /** 家庭id */
-  //   homeId: string
-  //   /** 经度 */
-  //   longitude: string
-  //   /** 维度 */
-  //   latitude: string
-  //   /** 详细地址 */
-  //   address: string
-  //   /**
-  //    * 是否是管理员
-  //    * true 是管理员; false 非管理员
-  //    */
-  //   admin: boolean
-  //   complete?: () => void
-  //   success?: (params: null) => void
-  //   fail?: (params: {
-  //     errorMsg: string
-  //     errorCode: string | number
-  //     innerError: {
-  //       errorCode: string | number
-  //       errorMsg: string
-  //     }
-  //   }) => void
-  // }): void
+  /**
+   * 获取本地设备的时区配置信息
+   * @public
+   * @since HomeKit 2.0.4
+   * @platform iOS Android
+   */
+  export function getLocalDeviceConfigWithDevId(params: {
+    /**
+     * 设备ID
+     * @since HomeKit 2.0.4
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 修改家庭信息
+   * @public
+   * @since HomeKit 1.0.4
+   * @platform iOS Android
+   */
+  export function updateHomeInfoData(params: {
+    /**
+     * 家庭名称
+     * @since HomeKit 3.0.1
+     */
+    homeName: string
+    /**
+     * 家庭id
+     * @since HomeKit 1.0.4
+     */
+    homeId: string
+    /**
+     * 经度
+     * @since HomeKit 1.0.4
+     */
+    longitude: string
+    /**
+     * 维度
+     * @since HomeKit 1.0.4
+     */
+    latitude: string
+    /**
+     * 详细地址
+     * @since HomeKit 1.0.4
+     */
+    address: string
+    /**
+     * 是否是管理员
+     * true 是管理员; false 非管理员
+     * @since HomeKit 1.0.4
+     */
+    admin: boolean
+    /**
+     * 家庭模式，取值自 ThingSmartHomeMode
+     * @since HomeKit 3.7.8
+     */
+    mode: number
+    /**
+     * 家庭角色，取值自 ThingSmartHomeRole
+     * @since HomeKit 3.7.12
+     */
+    role: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
   /**
    * 获取当前家庭信息
+   * @public
+   * @since HomeKit 1.0.4
+   * @platform iOS Android
    */
   export function getCurrentHomeInfo(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 家庭名称 */
+      /**
+       * 家庭名称
+       * @since HomeKit 3.0.3
+       */
       homeName: string
-      /** 家庭id */
+      /**
+       * 家庭id
+       * @since HomeKit 3.0.3
+       */
       homeId: string
-      /** 经度 */
+      /**
+       * 经度
+       * @since HomeKit 3.0.3
+       */
       longitude: string
-      /** 维度 */
+      /**
+       * 维度
+       * @since HomeKit 3.0.3
+       */
       latitude: string
-      /** 详细地址 */
+      /**
+       * 详细地址
+       * @since HomeKit 3.0.3
+       */
       address: string
       /**
        * 是否是管理员
        * true 是管理员; false 非管理员
+       * @since HomeKit 3.0.3
        */
       admin: boolean
+      /**
+       * 家庭模式，取值自 ThingSmartHomeMode
+       * @since HomeKit 3.7.8
+       */
+      mode: number
+      /**
+       * 家庭角色，取值自 ThingSmartHomeRole
+       * @since HomeKit 3.7.12
+       */
+      role: number
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
@@ -87,198 +175,3996 @@ declare namespace ty.home {
 
   /**
    * 获取设备房间信息
+   * @public
+   * @since HomeKit 3.0.1
+   * @platform iOS Android
    */
   export function getDeviceRoomInfo(params: {
     /**
-     * deviceId
-     * 设备 id
+     * 设备 ID
+     * @since HomeKit 3.0.1
      */
     deviceId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** The room ID. */
+      /**
+       * 房间 ID
+       * @since HomeKit 3.0.3
+       */
       roomId: number
-      /** The room name. */
+      /**
+       * 房间名称
+       * @since HomeKit 3.0.3
+       */
       name: string
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
-  // /**
-  //  * 获取群组房间信息
-  //  */
-  // export function getGroupRoomInfo(params: {
-  //   /**
-  //    * groupId
-  //    * 群组 id
-  //    */
-  //   groupId: string
-  //   complete?: () => void
-  //   success?: (params: {
-  //     /** The room ID. */
-  //     roomId: number
-  //     /** The room name. */
-  //     name: string
-  //   }) => void
-  //   fail?: (params: {
-  //     errorMsg: string
-  //     errorCode: string | number
-  //     innerError: {
-  //       errorCode: string | number
-  //       errorMsg: string
-  //     }
-  //   }) => void
-  // }): void
-
   /**
-   * 获取当前维度下的设备id列表
+   * 获取群组房间信息
+   * @public
+   * @since HomeKit 3.1.4
+   * @platform iOS Android
    */
-  export function getDeviceIdList(params: {
-    /** 维度id */
-    ownerId: number
+  export function getGroupRoomInfo(params: {
+    /**
+     * 群组 ID
+     * @since HomeKit 3.1.4
+     */
+    groupId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 设备id列表 */
-      devIds: string[]
+      /**
+       * 房间 ID
+       * @since HomeKit 3.1.4
+       */
+      roomId: number
+      /**
+       * 房间名称
+       * @since HomeKit 3.1.4
+       */
+      name: string
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 获取当前维度下的设备id列表
+   * 展示切换家庭浮层,注: iOS下非Tab小程序使用时切换家庭后会自动跳转到首页
+   * @public
+   * @since HomeKit 3.2.0
+   * @platform iOS Android
    */
-  export function getRoomList(params: {
-    /** 维度id */
-    ownerId: number
+  export function switchHome(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
-    success?: (params: {
-      /** 房间列表 */
-      roomDatas: RoomData[]
-    }) => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
-  export type RoomData = {
-    /** 房间id */
-    roomId: number
-    /** 房间名称 */
-    name: string
-    /** 房间下的设备id */
-    deviceIds: string[]
-  }
+  /**
+   * 切换家庭
+   * @public
+   * @since HomeKit 3.7.15
+   * @platform iOS Android
+   */
+  export function switchHomeWithHomeId(params: {
+    /**
+     * 家庭id
+     * @since HomeKit 3.7.15
+     */
+    homeId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
-  export type HomeInfoData = {
-    /** 家庭名称 */
+  /**
+   * 新建家庭
+   * @public
+   * @since HomeKit 3.7.15
+   * @platform iOS Android
+   */
+  export function createHome(params: {
+    /**
+     * 家庭名称，必填
+     * @since HomeKit 3.7.15
+     */
     homeName: string
-    /** 家庭id */
-    homeId: string
-    /** 经度 */
-    longitude: string
-    /** 维度 */
-    latitude: string
-    /** 详细地址 */
-    address: string
     /**
-     * 是否是管理员
-     * true 是管理员; false 非管理员
+     * 家庭模式，取值自 ThingSmartHomeMode, default: 0
+     * @since HomeKit 3.7.15
      */
-    admin: boolean
-  }
-
-  export type GetDeviceRoomInfoParams = {
+    mode: number
     /**
-     * deviceId
-     * 设备 id
+     * 经度，可选
+     * @since HomeKit 3.7.15
      */
-    deviceId: string
-  }
-
-  export type GetDeviceRoomInfoResponse = {
-    /** The room ID. */
-    roomId: number
-    /** The room name. */
-    name: string
-  }
-
-  export type GroupRoomInfoParams = {
+    longitude?: string
     /**
-     * groupId
-     * 群组 id
+     * 维度，可选
+     * @since HomeKit 3.7.15
      */
-    groupId: string
-  }
-
-  export type GroupRoomInfoResponse = {
-    /** The room ID. */
-    roomId: number
-    /** The room name. */
-    name: string
-  }
-
-  export type OwnerId = {
-    /** 维度id */
-    ownerId: number
-  }
+    latitude?: string
+    /**
+     * 详细地址，可选
+     * @since HomeKit 3.7.15
+     */
+    address?: string
+    /**
+     * 房间列表，可选
+     * @since HomeKit 3.7.15
+     */
+    rooms?: string[]
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 家庭id
+       * @since HomeKit 3.7.15
+       */
+      homeId: string
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
-  export type DeviceIdList = {
-    /** 设备id列表 */
-    devIds: string[]
-  }
+  /**
+   * 切换家庭dialog,注: iOS下非Tab小程序使用时切换家庭后会自动跳转到首页
+   * @public
+   * @since HomeKit 3.7.14
+   * @platform iOS Android
+   */
+  export function switchHomeDialog(params: {
+    /**
+     * 是否需要隐藏家庭管理
+     * @since HomeKit 3.7.14
+     */
+    hiddenHouseManager: boolean
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
-  export type RoomList = {
-    /** 房间列表 */
-    roomDatas: RoomData[]
-  }
+  /**
+   * 获取家庭列表信息
+   * @public
+   * @since HomeKit 3.5.4
+   * @platform iOS Android
+   */
+  export function getHomeListInfo(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 家庭列表信息
+       * @since HomeKit 3.5.4
+       */
+      homeList: HomeInfoData[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
-  export type TicketModel = {
-    /** ticket */
-    map?: Record<string, string>
-  }
+  /**
+   * 注册家庭变换监听
+   * @public
+   * @since HomeKit 3.5.4
+   * @platform iOS Android
+   */
+  export function registerHomeChangeListener(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
-  export type RecommendSceneParams = {
-    /** 来源 */
-    source: string
-    /** 场景模型 */
-    sceneModel: Record<string, any>
-  }
+  /**
+   * 解除注册家庭变换监听
+   * @public
+   * @since HomeKit 3.5.4
+   * @platform iOS Android
+   */
+  export function unregisterHomeChangeListener(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
-  export type RecommendSceneCallBack = {
-    /** 返回状态，默认返回 true */
-    status?: boolean
-    /** 成功返回的类型。0-未操作，1-保存成功，2-点击不感兴趣 */
-    type: number
-    /** 返回的场景数据，可能为空 */
-    data?: Record<string, any>
-  }
+  /**
+   * 刷新当前家庭下的数据
+   * @public
+   * @since HomeKit 3.5.4
+   * @platform iOS Android
+   */
+  export function refreshCurrentHome(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
 
-  export type OpenDeviceExecutionAndAnutomationParams = {
+  /**
+   * 获取分享邀请信息
+   * @public
+   * @since HomeKit 3.7.2
+   * @platform iOS Android
+   */
+  export function inviteMember(params: {
     /**
-     * deviceId
-     * 设备 id
+     * 家庭 ID
+     * @since HomeKit 3.7.2
+     */
+    homeId: number
+    /**
+     * 成员角色
+     * 0 - 普通成员
+     * 1 - 管理员
+     * 2 - 家庭所有者
+     * -1 - 自定义成员角色
+     * -999 - 非法成员
+     * @since HomeKit 3.7.2
+     */
+    role?: number
+    /**
+     * only use role == MemberRole.ROLE_CUSTOM
+     * @since HomeKit 3.7.2
+     */
+    customRoleId?: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 邀请信息
+       * @since HomeKit 3.7.2
+       */
+      invitationMsgContent: string
+      /**
+       * 邀请码
+       * @since HomeKit 3.7.2
+       */
+      invitationCode: string
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 入口管控业务
+   * @public
+   * @since HomeKit 3.7.5
+   * @platform iOS Android
+   */
+  export function paymentControlEntry(params: {
+    /**
+     * 入口标识
+     * @since HomeKit 3.7.5
+     */
+    entryID: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 入口标识
+       * @since HomeKit 3.7.5
+       */
+      entryID: string
+      /**
+       * true：显示入口
+       * @since HomeKit 3.7.5
+       */
+      isDisplayed: boolean
+      /**
+       * 入口携带的扩展信息
+       * @since HomeKit 3.7.5
+       */
+      entryExtensionInfo?: Record<string, any>
+      /**
+       * 入口名称
+       * @since HomeKit 3.7.5
+       */
+      entryName: string
+      /**
+       * true：当前入口必须要有 IAP 开启
+       * @since HomeKit 3.7.5
+       */
+      isIAPForced: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 注册家庭成员管理监听
+   * @public
+   * @since HomeKit 3.10.1
+   * @platform iOS Android
+   */
+  export function registerHomeMemberManagerListener(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 解除注册家庭成员管理监听
+   * @public
+   * @since HomeKit 3.10.1
+   * @platform iOS Android
+   */
+  export function unregisterHomeMemberManagerListener(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 判断卡片是否可以显示到首页
+   * @public
+   * @since HomeKit 3.11.0
+   * @platform iOS Android
+   */
+  export function canDisplayDIYHomeCard(params: {
+    /**
+     * 卡片
+     * @since HomeKit 3.11.0
+     */
+    card: DIYHomeCard
+    /**
+     * 家庭id
+     * @since HomeKit 3.11.0
+     */
+    gid: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否可以展示
+       * @since HomeKit 3.11.0
+       */
+      result: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 判断卡片是否已经显示到首页
+   * @public
+   * @since HomeKit 3.11.0
+   * @platform iOS Android
+   */
+  export function didDisplayDIYHomeCard(params: {
+    /**
+     * 卡片
+     * @since HomeKit 3.11.0
+     */
+    card: DIYHomeCard
+    /**
+     * 家庭id
+     * @since HomeKit 3.11.0
+     */
+    gid: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否可以展示
+       * @since HomeKit 3.11.0
+       */
+      result: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 添加卡片到首页
+   * @public
+   * @since HomeKit 3.11.0
+   * @platform iOS Android
+   */
+  export function addDIYHomeCard(params: {
+    /**
+     * 卡片
+     * @since HomeKit 3.11.0
+     */
+    card: DIYHomeCardWithStyle
+    /**
+     * 家庭id
+     * @since HomeKit 3.11.0
+     */
+    gid: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 从首页移除卡片
+   * @public
+   * @since HomeKit 3.11.0
+   * @platform iOS Android
+   */
+  export function removeDIYHomeCard(params: {
+    /**
+     * 卡片
+     * @since HomeKit 3.11.0
+     */
+    card: DIYHomeCard
+    /**
+     * 家庭id
+     * @since HomeKit 3.11.0
+     */
+    gid: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 播放控制
+   * @public
+   * @since HomeKit 3.12.0
+   * @platform iOS Android
+   */
+  export function mediaPlayerControl(params: {
+    /**
+     * 控制类型
+     * 播放：PLAY
+     * 暂停：PAUSE
+     * 恢复：RESUME
+     * 释放：RELEASE
+     * @since HomeKit 3.12.0
+     */
+    op: string
+    /**
+     * 额外参数，json格式字符串
+     * @since HomeKit 3.12.0
+     */
+    data: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 注册播放器状态监听
+   * @public
+   * @since HomeKit 3.12.0
+   * @platform iOS Android
+   */
+  export function registerStateChangeListener(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 解除播放器状态监听
+   * @public
+   * @since HomeKit 3.12.0
+   * @platform iOS Android
+   */
+  export function unregisterStateChangeListener(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 控制浮窗显隐
+   * @public
+   * @since HomeKit 3.12.0
+   * @platform iOS Android
+   */
+  export function setupFloatWindow(params: {
+    /**
+     * 是否显示悬浮窗
+     * @since HomeKit 3.12.0
+     */
+    visible: boolean
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 设置AIBar属性
+   * 配置AIBar的路由参数等属性
+   * @public
+   * @since HomeKit 3.15.0
+   * @platform iOS Android
+   */
+  export function setAIBarParams(params: {
+    /**
+     * 打开AI的路由参数（键值对形式）
+     * @since HomeKit 3.15.0
+     */
+    routeParams: Record<string, string>
+    /**
+     * 埋点事件名
+     * @since HomeKit 3.15.0
+     */
+    eventName?: string
+    /**
+     * 埋点事件对应的参数（键值对形式）
+     * @since HomeKit 3.15.0
+     */
+    eventParams?: Record<string, string>
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 判断是否需要显示AIBar
+   * @public
+   * @since HomeKit 3.15.0
+   * @platform iOS Android
+   */
+  export function shouldShowAIBar(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 显示模式：0=不支持显示、1=以拼接在容器底部显示AIBar、2=以悬浮在容器上显示AIBar
+       * 取值自 ShouldShowAIBarDisplayMode
+       * @since HomeKit 3.15.0
+       */
+      displayMode: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取AIBar的尺寸
+   * @public
+   * @since HomeKit 3.15.0
+   * @platform iOS Android
+   */
+  export function AIBarSize(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 宽度
+       * @since HomeKit 3.15.0
+       */
+      width: number
+      /**
+       * 高度
+       * @since HomeKit 3.15.0
+       */
+      height: number
+      /**
+       * 非透明区域宽度
+       * @since HomeKit 3.15.0
+       */
+      opaqueWidth: number
+      /**
+       * 非透明区域高度
+       * @since HomeKit 3.15.0
+       */
+      opaqueHeight: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 显示AIBar
+   * @public
+   * @since HomeKit 3.15.0
+   * @platform iOS Android
+   */
+  export function showAIBar(params: {
+    /**
+     * AIBar的背景色 #123456
+     * @since HomeKit 3.15.0
+     */
+    backgroundColor: string
+    /**
+     * 主题模式，默认 FollowSystem(0)。见 AIBarThemeMode
+     * @since HomeKit 3.15.4
+     */
+    themeMode?: number
+    /**
+     * AIBar配置参数（路由参数、埋点等）
+     * @since HomeKit 3.15.0
+     */
+    aiBarParams?: AIBarParams
+    /**
+     * 小程序页面级 id
+     * @since HomeKit 3.15.0
+     */
+    id: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否显示成功
+       * @since HomeKit 3.15.0
+       */
+      success: boolean
+      /**
+       * AIBar 尺寸（width、height）
+       * @since HomeKit 3.15.0
+       */
+      aiBarSize: AIBarSizeResult
+      /**
+       * 当前显示的页面 id
+       * @since HomeKit 3.15.0
+       */
+      pageId: string
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 隐藏AIBar
+   * @public
+   * @since HomeKit 3.15.0
+   * @platform iOS Android
+   */
+  export function hideAIBar(params: {
+    /**
+     * 需要隐藏的页面 id
+     * @since HomeKit 3.15.0
+     */
+    pageId: string
+    /**
+     * 小程序页面级 id
+     * @since HomeKit 3.15.0
+     */
+    id: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取AI助手开关状态
+   * @public
+   * @since HomeKit 3.11.1
+   * @platform iOS Android
+   */
+  export function getAIAssistantSwitch(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 开关状态
+       * @since HomeKit 3.11.1
+       */
+      open: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 无障碍小程序初始化
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function containerInitialize(params: {
+    /**
+     * 所属家庭
+     * @since HomeKit 3.15.3
+     */
+    homeId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * tab选中
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function selectTab(params: {
+    /**
+     * 所属家庭
+     * @since HomeKit 3.15.3
+     */
+    homeId: string
+    /**
+     * 选中Tab索引
+     * - 首页: home
+     * - 场景: scene
+     * - 设置: setting
+     * @since HomeKit 3.15.3
+     */
+    tabKey: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 场景操作
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function sceneOperate(params: {
+    /**
+     * 场景id
+     * @since HomeKit 3.15.3
+     */
+    sceneId: string
+    /**
+     * 操作类型
+     * - 执行: 2
+     * - 启用: 1
+     * - 禁用: 0
+     * @since HomeKit 3.15.3
+     */
+    operationType: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 配置无障碍模式
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function configA11yMode(params: {
+    /**
+     * 是否开启无障碍模式
+     * @since HomeKit 3.15.3
+     */
+    enable: boolean
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否开启无障碍模式
+       * @since HomeKit 3.15.3
+       */
+      enable: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 是否支持homekit
+   * @public
+   * @since HomeKit 3.16.0
+   * @platform iOS Android
+   */
+  export function isSupportedHomeKit(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否支持 HomeKit
+       * @since HomeKit 3.16.0
+       */
+      support: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 是否支持home assistant
+   * @public
+   * @since HomeKit 3.16.0
+   * @platform iOS Android
+   */
+  export function isSupportedHomeAssistant(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否支持 Home Assistant
+       * @since HomeKit 3.16.0
+       */
+      support: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 是否开启设备自动添加至首页
+   * @public
+   * @since HomeKit 3.16.0
+   * @platform iOS Android
+   */
+  export function addDeviceToHomeEnabled(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否开启设备自动添加至首页
+       * @since HomeKit 3.16.0
+       */
+      enabled: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 是否支持GoogleHome
+   * @public
+   * @since HomeKit 3.16.0
+   * @platform iOS Android
+   */
+  export function isSupportedGoogleHome(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否支持 Google Home
+       * @since HomeKit 3.16.0
+       */
+      support: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取当前家庭下的设备列表
+   * @public
+   * @since HomeKit 3.16.0
+   * @platform iOS Android
+   */
+  export function getDeviceList(params: {
+    /**
+     * 家庭id
+     * @since HomeKit 3.16.0
+     */
+    homeId: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 设备IDs列表
+       * @since HomeKit 3.16.0
+       */
+      deviceIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 批量添加卡片到首页
+   * @public
+   * @since HomeKit 3.16.0
+   * @platform iOS Android
+   */
+  export function addDIYHomeDeviceCards(params: {
+    /**
+     * 设备id列表
+     * @since HomeKit 3.16.0
+     */
+    cards: DIYHomeCardWithStyle[]
+    /**
+     * 家庭id
+     * @since HomeKit 3.16.0
+     */
+    gid: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 从本地缓存中获取当前维度下的设备id列表
+   * @public
+   * @since HomeKit 3.1.0
+   * @platform iOS Android
+   */
+  export function getDeviceIdList(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.1.0
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 设备id列表
+       * @since HomeKit 3.1.0
+       */
+      devIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 从本地缓存中获取当前维度下的房间列表，包含房间下的设备id列表
+   * @public
+   * @since HomeKit 3.1.0
+   * @platform iOS Android
+   */
+  export function getRoomList(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.1.0
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 房间列表
+       * @since HomeKit 3.1.0
+       */
+      roomDatas: RoomData[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 从本地缓存中获取当前维度下的群组id列表
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function getGroupIdList(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.5.3
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 群组id列表
+       * @since HomeKit 3.5.3
+       */
+      groupIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 从本地缓存中获取当前维度下的分享设备id列表
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function getShareDeviceIdList(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.5.3
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 设备id列表
+       * @since HomeKit 3.5.3
+       */
+      devIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 从本地缓存中获取当前维度下的分享群组id列表
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function getShareGroupIdList(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.5.3
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 群组id列表
+       * @since HomeKit 3.5.3
+       */
+      groupIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 从本地缓存中获取当前维度下的本地设备id列表
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function getLocalDeviceIdList(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.15.3
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.15.3
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.15.3
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 设备id列表
+       * @since HomeKit 3.15.3
+       */
+      devIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 监听当前家庭下设备、群组的添加与删除，以及分享设备、分享群组列表的变化
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function registerHomeListListener(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.5.3
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 注销当前家庭下设备、群组的添加与删除，以及分享设备、分享群组列表的变化
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function unregisterHomeListListener(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.5.3
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取某个家庭房间下的设备id列表
+   * @public
+   * @since HomeKit 3.7.10
+   * @platform iOS Android
+   */
+  export function getDeviceIdsInRoom(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.7.10
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 设备id列表
+       * @since HomeKit 3.7.10
+       */
+      devIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取某个家庭房间下的群组id列表
+   * @public
+   * @since HomeKit 3.7.10
+   * @platform iOS Android
+   */
+  export function getGroupIdsInRoom(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.7.10
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 群组id列表
+       * @since HomeKit 3.7.10
+       */
+      groupIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 从本地缓存中获取与指定设备 ID 同维度下的设备 ID 列表
+   * @public
+   * @since HomeKit 3.8.0
+   * @platform iOS Android
+   */
+  export function getDeviceIdListWithDevId(params: {
+    /**
+     * 维度id
+     * @since HomeKit 3.8.0
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.8.0
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 设备id列表
+       * @since HomeKit 3.8.0
+       */
+      devIds: string[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 将设备移动到指定房间
+   * @public
+   * @since HomeKit 3.10.0
+   * @platform iOS Android
+   */
+  export function switchDeviceRoom(params: {
+    /**
+     * 设备id
+     * @since HomeKit 3.10.0
+     */
+    deviceId: string
+    /**
+     * 房间id
+     * @since HomeKit 3.10.0
+     */
+    roomId: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 图形验证码校验通过后触发，传入验证码凭证并在回调中返回凭证数据
+   * @public
+   * @since HomeKit 3.1.3
+   * @platform iOS Android
+   */
+  export function onTicketSuccess(params?: {
+    /**
+     * 验证码凭证键值对，key 为参数名，value 为对应值
+     * @since HomeKit 3.1.3
+     */
+    map?: Record<string, string>
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 验证码凭证键值对，key 为参数名，value 为对应值
+       * @since HomeKit 3.1.3
+       */
+      map?: Record<string, string>
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 退出登录
+   * @public
+   * @since HomeKit 3.6.1
+   * @platform iOS Android
+   */
+  export function logout(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 能否显示手机号绑定弹窗
+   * @public
+   * @since HomeKit 3.14.0
+   * @platform iOS Android
+   */
+  export function canShowMobileBindView(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 是否展示手机号绑定弹窗
+       * @since HomeKit 3.14.0
+       */
+      show: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 显示手机号绑定弹窗
+   * @public
+   * @since HomeKit 3.14.0
+   * @platform iOS Android
+   */
+  export function showMobileBindView(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 【废弃】打开推荐场景详情页面
+   * 请用deviceKit包下同名方法替代
+   * @public
+   * @since HomeKit 1.0.4
+   * @platform iOS Android
+   */
+  export function openRecommendSceneDetail(params: {
+    /**
+     * 来源
+     * @since HomeKit 1.0.4
+     */
+    source: string
+    /**
+     * 场景模型
+     * @since HomeKit 1.0.4
+     */
+    sceneModel: Record<string, any>
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 返回状态，默认返回 true
+       * @since HomeKit 3.0.3
+       * @defaultValue true
+       */
+      status?: boolean
+      /**
+       * 成功返回的类型。0-未操作，1-保存成功，2-点击不感兴趣
+       * @since HomeKit 3.0.3
+       */
+      type: number
+      /**
+       * 返回的场景数据，可能为空
+       * @since HomeKit 3.0.3
+       */
+      data?: Record<string, any>
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 【废弃】跳转一键执行和自动化页面
+   * 请用deviceKit包下同名方法替代
+   * @public
+   * @since HomeKit 2.1.0
+   * @platform iOS Android
+   */
+  export function openDeviceExecutionAndAnutomation(params: {
+    /**
+     * 设备 ID
+     * @since HomeKit 2.1.0
+     */
+    deviceId: string
+    /**
+     * 页面标题，Android 需要
+     * @since HomeKit 2.1.0
+     */
+    title?: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 家庭变换 完成 事件
+   * @public
+   * @since HomeKit 3.5.4
+   * @platform iOS Android
+   */
+  export function onHomeChangeComplete(
+    listener: (params: HomeInfoData) => void
+  ): void
+
+  /**
+   * 家庭变换 完成 事件
+   * @public
+   * @since HomeKit 3.5.4
+   * @platform iOS Android
+   */
+  export function offHomeChangeComplete(
+    listener: (params: HomeInfoData) => void
+  ): void
+
+  /**
+   * 移除家庭成员事件
+   * @public
+   * @since HomeKit 3.10.1
+   * @platform iOS Android
+   */
+  export function onRemoveMemberHandler(
+    listener: (params: MemberHandlerResponse) => void
+  ): void
+
+  /**
+   * 移除家庭成员事件
+   * @public
+   * @since HomeKit 3.10.1
+   * @platform iOS Android
+   */
+  export function offRemoveMemberHandler(
+    listener: (params: MemberHandlerResponse) => void
+  ): void
+
+  /**
+   * 重置家庭成员昵称事件
+   * @public
+   * @since HomeKit 3.10.1
+   * @platform iOS Android
+   */
+  export function onResetMemberNameHandler(
+    listener: (params: MemberHandlerResponse) => void
+  ): void
+
+  /**
+   * 重置家庭成员昵称事件
+   * @public
+   * @since HomeKit 3.10.1
+   * @platform iOS Android
+   */
+  export function offResetMemberNameHandler(
+    listener: (params: MemberHandlerResponse) => void
+  ): void
+
+  /**
+   * 重置家庭成员角色事件
+   * @public
+   * @since HomeKit 3.10.1
+   * @platform iOS Android
+   */
+  export function onResetMemberRoleHandler(
+    listener: (params: MemberHandlerResponse) => void
+  ): void
+
+  /**
+   * 重置家庭成员角色事件
+   * @public
+   * @since HomeKit 3.10.1
+   * @platform iOS Android
+   */
+  export function offResetMemberRoleHandler(
+    listener: (params: MemberHandlerResponse) => void
+  ): void
+
+  /**
+   * 播放器状态变化事件
+   * @public
+   * @since HomeKit 3.12.0
+   * @platform iOS Android
+   */
+  export function onPlayerStateChangeHander(
+    listener: (params: ThingPlayerStateHandlerResponse) => void
+  ): void
+
+  /**
+   * 播放器状态变化事件
+   * @public
+   * @since HomeKit 3.12.0
+   * @platform iOS Android
+   */
+  export function offPlayerStateChangeHander(
+    listener: (params: ThingPlayerStateHandlerResponse) => void
+  ): void
+
+  /**
+   * AIBar 输入入口点击事件
+   * @public
+   * @since HomeKit 3.15.0
+   * @platform iOS Android
+   */
+  export function onAIBarInputClick(
+    listener: (params: AIBarInputClickEvent) => void
+  ): void
+
+  /**
+   * AIBar 输入入口点击事件
+   * @public
+   * @since HomeKit 3.15.0
+   * @platform iOS Android
+   */
+  export function offAIBarInputClick(
+    listener: (params: AIBarInputClickEvent) => void
+  ): void
+
+  /**
+   * 首页展示相关数据缓存发生变更事件，需要触发首页刷新
+   * 注意：需要通过'containerInitialize' 或 ‘registerHomeChangeListener’ 注册监听才能收到事件
+   * 数据变更包含：
+   *  1.家庭相关：切换家庭、当前家庭改名
+   *  2.房间相关：新增、删除、排序、改名、新增设备、删除设备、设备排序
+   *  3.设备群组相关：新增、删除、排序
+   *  4.分享设备群组相关：新增、删除
+   *  5.本地设备相关：新增、删除
+   *  6.页面刷新：下拉刷新
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function onHomePageDataChanged(
+    listener: (params: HomeInfoData) => void
+  ): void
+
+  /**
+   * 首页展示相关数据缓存发生变更事件，需要触发首页刷新
+   * 注意：需要通过'containerInitialize' 或 ‘registerHomeChangeListener’ 注册监听才能收到事件
+   * 数据变更包含：
+   *  1.家庭相关：切换家庭、当前家庭改名
+   *  2.房间相关：新增、删除、排序、改名、新增设备、删除设备、设备排序
+   *  3.设备群组相关：新增、删除、排序
+   *  4.分享设备群组相关：新增、删除
+   *  5.本地设备相关：新增、删除
+   *  6.页面刷新：下拉刷新
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function offHomePageDataChanged(
+    listener: (params: HomeInfoData) => void
+  ): void
+
+  /**
+   * 场景页展示相关数据缓存发生变更事件，需要触发场景页刷新
+   * 注意：需要通过'containerInitialize'注册监听才能收到事件
+   * 数据变更包含：
+   *  1.场景相关：新增、删除
+   *  2.页面刷新：下拉刷新
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function onScenePageDataChanged(
+    listener: (params: SceneListData) => void
+  ): void
+
+  /**
+   * 场景页展示相关数据缓存发生变更事件，需要触发场景页刷新
+   * 注意：需要通过'containerInitialize'注册监听才能收到事件
+   * 数据变更包含：
+   *  1.场景相关：新增、删除
+   *  2.页面刷新：下拉刷新
+   * @public
+   * @since HomeKit 3.15.3
+   * @platform iOS Android
+   */
+  export function offScenePageDataChanged(
+    listener: (params: SceneListData) => void
+  ): void
+
+  /**
+   * 设备移除事件
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function onHomeDeviceRemoved(
+    listener: (params: OnDeviceRemovedBody) => void
+  ): void
+
+  /**
+   * 设备移除事件
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function offHomeDeviceRemoved(
+    listener: (params: OnDeviceRemovedBody) => void
+  ): void
+
+  /**
+   * 设备添加事件
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function onHomeDeviceAdd(
+    listener: (params: OnDeviceAddBody) => void
+  ): void
+
+  /**
+   * 设备添加事件
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function offHomeDeviceAdd(
+    listener: (params: OnDeviceAddBody) => void
+  ): void
+
+  /**
+   * 群组移除事件
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function onHomeGroupRemoved(
+    listener: (params: OnGroupRemovedBody) => void
+  ): void
+
+  /**
+   * 群组移除事件
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function offHomeGroupRemoved(
+    listener: (params: OnGroupRemovedBody) => void
+  ): void
+
+  /**
+   * 群组添加事件
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function onHomeGroupAdd(
+    listener: (params: OnGroupAddBody) => void
+  ): void
+
+  /**
+   * 群组添加事件
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function offHomeGroupAdd(
+    listener: (params: OnGroupAddBody) => void
+  ): void
+
+  /**
+   * 分享列表(设备、群组)发生变化
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function onShareListChange(
+    listener: (params: OnShareListChangeBody) => void
+  ): void
+
+  /**
+   * 分享列表(设备、群组)发生变化
+   * @public
+   * @since HomeKit 3.5.3
+   * @platform iOS Android
+   */
+  export function offShareListChange(
+    listener: (params: OnShareListChangeBody) => void
+  ): void
+
+  /**
+   * 注册家庭切换通知
+   * @public
+   * @since HomeKit 3.2.0
+   * @platform iOS Android
+   */
+  export function onHomeChanged(
+    listener: (params: {
+      /**
+       * 家庭名称
+       * @since HomeKit 3.5.4
+       */
+      homeName: string
+      /**
+       * 家庭id
+       * @since HomeKit 3.5.4
+       */
+      homeId: string
+      /**
+       * 经度
+       * @since HomeKit 3.5.4
+       */
+      longitude: string
+      /**
+       * 维度
+       * @since HomeKit 3.5.4
+       */
+      latitude: string
+      /**
+       * 详细地址
+       * @since HomeKit 3.5.4
+       */
+      address: string
+      /**
+       * 是否是管理员
+       * true 是管理员; false 非管理员
+       * @since HomeKit 3.5.4
+       */
+      admin: boolean
+      /**
+       * 家庭模式，取值自 ThingSmartHomeMode
+       * @since HomeKit 3.7.8
+       */
+      mode: number
+      /**
+       * 家庭角色，取值自 ThingSmartHomeRole
+       * @since HomeKit 3.7.12
+       */
+      role: number
+    }) => void
+  ): void
+
+  /**
+   * 解除注册家庭切换通知
+   * @public
+   * @since HomeKit 3.2.0
+   * @platform iOS Android
+   */
+  export function offHomeChanged(
+    listener: (params: {
+      /**
+       * 家庭名称
+       * @since HomeKit 3.5.4
+       */
+      homeName: string
+      /**
+       * 家庭id
+       * @since HomeKit 3.5.4
+       */
+      homeId: string
+      /**
+       * 经度
+       * @since HomeKit 3.5.4
+       */
+      longitude: string
+      /**
+       * 维度
+       * @since HomeKit 3.5.4
+       */
+      latitude: string
+      /**
+       * 详细地址
+       * @since HomeKit 3.5.4
+       */
+      address: string
+      /**
+       * 是否是管理员
+       * true 是管理员; false 非管理员
+       * @since HomeKit 3.5.4
+       */
+      admin: boolean
+      /**
+       * 家庭模式，取值自 ThingSmartHomeMode
+       * @since HomeKit 3.7.8
+       */
+      mode: number
+      /**
+       * 家庭角色，取值自 ThingSmartHomeRole
+       * @since HomeKit 3.7.12
+       */
+      role: number
+    }) => void
+  ): void
+
+  /**
+   * `getLocalDeviceConfigWithDevId` 的请求参数
+   * @since HomeKit 2.0.4
+   */
+  export interface Param {
+    /**
+     * 设备ID
+     * @since HomeKit 2.0.4
+     */
+    devId: string
+  }
+
+  /** @since HomeKit 1.0.4 */
+  export interface HomeInfoData {
+    /**
+     * 家庭名称
+     * @since HomeKit 3.5.4
+     */
+    homeName: string
+    /**
+     * 家庭id
+     * @since HomeKit 3.5.4
+     */
+    homeId: string
+    /**
+     * 经度
+     * @since HomeKit 3.5.4
+     */
+    longitude: string
+    /**
+     * 维度
+     * @since HomeKit 3.5.4
+     */
+    latitude: string
+    /**
+     * 详细地址
+     * @since HomeKit 3.5.4
+     */
+    address: string
+    /**
+     * 是否是管理员
+     * true 是管理员; false 非管理员
+     * @since HomeKit 3.5.4
+     */
+    admin: boolean
+    /**
+     * 家庭模式，取值自 ThingSmartHomeMode
+     * @since HomeKit 3.7.8
+     */
+    mode: number
+    /**
+     * 家庭角色，取值自 ThingSmartHomeRole
+     * @since HomeKit 3.7.12
+     */
+    role: number
+  }
+
+  /**
+   * getDeviceRoomInfo 的请求参数
+   * @since HomeKit 3.0.1
+   */
+  export interface GetDeviceRoomInfoParams {
+    /**
+     * 设备 ID
+     * @since HomeKit 3.0.1
+     */
+    deviceId: string
+  }
+
+  /**
+   * 获取设备房间信息的返回结果
+   * @since HomeKit 3.0.1
+   */
+  export interface GetDeviceRoomInfoResponse {
+    /**
+     * 房间 ID
+     * @since HomeKit 3.0.1
+     */
+    roomId: number
+    /**
+     * 房间名称
+     * @since HomeKit 3.0.1
+     */
+    name: string
+  }
+
+  /**
+   * getGroupRoomInfo 的请求参数
+   * @since HomeKit 3.1.4
+   */
+  export interface GroupRoomInfoParams {
+    /**
+     * 群组 ID
+     * @since HomeKit 3.1.4
+     */
+    groupId: string
+  }
+
+  /**
+   * 获取群组房间信息的返回结果
+   * @since HomeKit 3.1.4
+   */
+  export interface GroupRoomInfoResponse {
+    /**
+     * 房间 ID
+     * @since HomeKit 3.1.4
+     */
+    roomId: number
+    /**
+     * 房间名称
+     * @since HomeKit 3.1.4
+     */
+    name: string
+  }
+
+  /** @since HomeKit 3.7.15 */
+  export interface HomeIdBean {
+    /**
+     * 家庭id
+     * @since HomeKit 3.7.15
+     */
+    homeId: string
+  }
+
+  /** @since HomeKit 3.7.15 */
+  export interface CreateHomeParams {
+    /**
+     * 家庭名称，必填
+     * @since HomeKit 3.7.15
+     */
+    homeName: string
+    /**
+     * 家庭模式，取值自 ThingSmartHomeMode, default: 0
+     * @since HomeKit 3.7.15
+     */
+    mode: number
+    /**
+     * 经度，可选
+     * @since HomeKit 3.7.15
+     */
+    longitude?: string
+    /**
+     * 维度，可选
+     * @since HomeKit 3.7.15
+     */
+    latitude?: string
+    /**
+     * 详细地址，可选
+     * @since HomeKit 3.7.15
+     */
+    address?: string
+    /**
+     * 房间列表，可选
+     * @since HomeKit 3.7.15
+     */
+    rooms?: string[]
+  }
+
+  /** @since HomeKit 3.7.14 */
+  export interface SwitchHomeData {
+    /**
+     * 是否需要隐藏家庭管理
+     * @since HomeKit 3.7.14
+     */
+    hiddenHouseManager: boolean
+  }
+
+  /** @since HomeKit 3.5.4 */
+  export interface HomeListData {
+    /**
+     * 家庭列表信息
+     * @since HomeKit 3.5.4
+     */
+    homeList: HomeInfoData[]
+  }
+
+  /** @since HomeKit 3.7.2 */
+  export interface InviteParams {
+    /**
+     * 家庭 ID
+     * @since HomeKit 3.7.2
+     */
+    homeId: number
+    /**
+     * 成员角色
+     * 0 - 普通成员
+     * 1 - 管理员
+     * 2 - 家庭所有者
+     * -1 - 自定义成员角色
+     * -999 - 非法成员
+     * @since HomeKit 3.7.2
+     */
+    role?: number
+    /**
+     * only use role == MemberRole.ROLE_CUSTOM
+     * @since HomeKit 3.7.2
+     */
+    customRoleId?: number
+  }
+
+  /** @since HomeKit 3.7.2 */
+  export interface InvitationMessageBean {
+    /**
+     * 邀请信息
+     * @since HomeKit 3.7.2
+     */
+    invitationMsgContent: string
+    /**
+     * 邀请码
+     * @since HomeKit 3.7.2
+     */
+    invitationCode: string
+  }
+
+  /** @since HomeKit 3.7.5 */
+  export interface ThingPaymentControlEntryRequest {
+    /**
+     * 入口标识
+     * @since HomeKit 3.7.5
+     */
+    entryID: string
+  }
+
+  /** @since HomeKit 3.7.5 */
+  export interface ThingPaymentEntryData {
+    /**
+     * 入口标识
+     * @since HomeKit 3.7.5
+     */
+    entryID: string
+    /**
+     * true：显示入口
+     * @since HomeKit 3.7.5
+     */
+    isDisplayed: boolean
+    /**
+     * 入口携带的扩展信息
+     * @since HomeKit 3.7.5
+     */
+    entryExtensionInfo?: Record<string, any>
+    /**
+     * 入口名称
+     * @since HomeKit 3.7.5
+     */
+    entryName: string
+    /**
+     * true：当前入口必须要有 IAP 开启
+     * @since HomeKit 3.7.5
+     */
+    isIAPForced: boolean
+  }
+
+  /**
+   * 家庭成员操作事件体
+   * @since HomeKit 3.10.1
+   */
+  export interface MemberHandlerResponse {
+    /**
+     * 家庭成员ID
+     * @since HomeKit 3.10.1
+     */
+    memberId: string
+    /**
+     * 是否成功
+     * @since HomeKit 3.10.1
+     */
+    success: boolean
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export interface DIYHomeCard {
+    /**
+     * 卡片类型 DIYHomeCardType
+     * @since HomeKit 3.11.0
+     */
+    type: number
+    /**
+     * 内容id, 当type为设备、房间、场景、小程序时, 需要传
+     * @since HomeKit 3.11.0
+     */
+    contentId?: string
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export interface CanDisplayDIYHomeCardParams {
+    /**
+     * 卡片
+     * @since HomeKit 3.11.0
+     */
+    card: DIYHomeCard
+    /**
+     * 家庭id
+     * @since HomeKit 3.11.0
+     */
+    gid: number
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export interface CanDisplayDIYHomeCardResult {
+    /**
+     * 是否可以展示
+     * @since HomeKit 3.11.0
+     */
+    result: boolean
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export interface DidDisplayDIYHomeCardParams {
+    /**
+     * 卡片
+     * @since HomeKit 3.11.0
+     */
+    card: DIYHomeCard
+    /**
+     * 家庭id
+     * @since HomeKit 3.11.0
+     */
+    gid: number
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export interface DidDisplayDIYHomeCardResult {
+    /**
+     * 是否可以展示
+     * @since HomeKit 3.11.0
+     */
+    result: boolean
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export interface DIYHomeCardWithStyle {
+    /**
+     * 卡片类型 DIYHomeCardType
+     * @since HomeKit 3.11.0
+     */
+    type: number
+    /**
+     * 卡片样式 DIYHomeCardStyle
+     * @since HomeKit 3.11.0
+     */
+    style?: number
+    /**
+     * 内容id, 当type为设备、房间、场景、小程序时, 需要传
+     * @since HomeKit 3.11.0
+     */
+    contentId?: string
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export interface AddDIYHomeCardParams {
+    /**
+     * 卡片
+     * @since HomeKit 3.11.0
+     */
+    card: DIYHomeCardWithStyle
+    /**
+     * 家庭id
+     * @since HomeKit 3.11.0
+     */
+    gid: number
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export interface RemoveDIYHomeCardParams {
+    /**
+     * 卡片
+     * @since HomeKit 3.11.0
+     */
+    card: DIYHomeCard
+    /**
+     * 家庭id
+     * @since HomeKit 3.11.0
+     */
+    gid: number
+  }
+
+  /** @since HomeKit 3.12.0 */
+  export interface ThingMediaControlParams {
+    /**
+     * 控制类型
+     * 播放：PLAY
+     * 暂停：PAUSE
+     * 恢复：RESUME
+     * 释放：RELEASE
+     * @since HomeKit 3.12.0
+     */
+    op: string
+    /**
+     * 额外参数，json格式字符串
+     * @since HomeKit 3.12.0
+     */
+    data: string
+  }
+
+  /** @since HomeKit 3.12.0 */
+  export interface ThingPlayerStateHandlerResponse {
+    /**
+     * 播放状态
+     * @since HomeKit 3.12.0
+     */
+    status: number
+    /**
+     * 参数，json格式字符串
+     * @since HomeKit 3.12.0
+     */
+    data: string
+  }
+
+  /** @since HomeKit 3.12.0 */
+  export interface ThingSetupFloatWindowParams {
+    /**
+     * 是否显示悬浮窗
+     * @since HomeKit 3.12.0
+     */
+    visible: boolean
+  }
+
+  /**
+   * AIBar配置参数
+   * @since HomeKit 3.15.0
+   */
+  export interface AIBarParams {
+    /**
+     * 打开AI的路由参数（键值对形式）
+     * @since HomeKit 3.15.0
+     */
+    routeParams: Record<string, string>
+    /**
+     * 埋点事件名
+     * @since HomeKit 3.15.0
+     */
+    eventName?: string
+    /**
+     * 埋点事件对应的参数（键值对形式）
+     * @since HomeKit 3.15.0
+     */
+    eventParams?: Record<string, string>
+  }
+
+  /**
+   * 判断是否显示AIBar的返回结果
+   * @since HomeKit 3.15.0
+   */
+  export interface ShouldShowAIBarResult {
+    /**
+     * 显示模式：0=不支持显示、1=以拼接在容器底部显示AIBar、2=以悬浮在容器上显示AIBar
+     * 取值自 ShouldShowAIBarDisplayMode
+     * @since HomeKit 3.15.0
+     */
+    displayMode: number
+  }
+
+  /**
+   * AIBar尺寸返回结果
+   * @since HomeKit 3.15.0
+   */
+  export interface AIBarSizeResult {
+    /**
+     * 宽度
+     * @since HomeKit 3.15.0
+     */
+    width: number
+    /**
+     * 高度
+     * @since HomeKit 3.15.0
+     */
+    height: number
+    /**
+     * 非透明区域宽度
+     * @since HomeKit 3.15.0
+     */
+    opaqueWidth: number
+    /**
+     * 非透明区域高度
+     * @since HomeKit 3.15.0
+     */
+    opaqueHeight: number
+  }
+
+  /**
+   * 显示AIBar入参
+   * @since HomeKit 3.15.0
+   */
+  export interface ShowAIBarParams {
+    /**
+     * AIBar的背景色 #123456
+     * @since HomeKit 3.15.0
+     */
+    backgroundColor: string
+    /**
+     * 主题模式，默认 FollowSystem(0)。见 AIBarThemeMode
+     * @since HomeKit 3.15.4
+     */
+    themeMode?: number
+    /**
+     * AIBar配置参数（路由参数、埋点等）
+     * @since HomeKit 3.15.0
+     */
+    aiBarParams?: AIBarParams
+    /**
+     * 小程序页面级 id
+     * @since HomeKit 3.15.0
+     */
+    id: string
+  }
+
+  /**
+   * 显示AIBar返回结果
+   * @since HomeKit 3.15.0
+   */
+  export interface ShowAIBarResult {
+    /**
+     * 是否显示成功
+     * @since HomeKit 3.15.0
+     */
+    success: boolean
+    /**
+     * AIBar 尺寸（width、height）
+     * @since HomeKit 3.15.0
+     */
+    aiBarSize: AIBarSizeResult
+    /**
+     * 当前显示的页面 id
+     * @since HomeKit 3.15.0
+     */
+    pageId: string
+  }
+
+  /**
+   * 隐藏AIBar入参
+   * @since HomeKit 3.15.0
+   */
+  export interface HideAIBarParams {
+    /**
+     * 需要隐藏的页面 id
+     * @since HomeKit 3.15.0
+     */
+    pageId: string
+    /**
+     * 小程序页面级 id
+     * @since HomeKit 3.15.0
+     */
+    id: string
+  }
+
+  /**
+   * AIBar 输入入口点击事件体
+   * @since HomeKit 3.15.0
+   */
+  export interface AIBarInputClickEvent {
+    /**
+     * 输入类型，取值自 AIBarInputType
+     * @since HomeKit 3.15.0
+     */
+    inputType: string
+  }
+
+  /** @since HomeKit 3.11.1 */
+  export interface AIAssistantSwitchResponse {
+    /**
+     * 开关状态
+     * @since HomeKit 3.11.1
+     */
+    open: boolean
+  }
+
+  /** @since HomeKit 3.15.3 */
+  export interface ContainerInitializeParams {
+    /**
+     * 所属家庭
+     * @since HomeKit 3.15.3
+     */
+    homeId: string
+  }
+
+  /** @since HomeKit 3.15.3 */
+  export interface TabSelectParams {
+    /**
+     * 所属家庭
+     * @since HomeKit 3.15.3
+     */
+    homeId: string
+    /**
+     * 选中Tab索引
+     * - 首页: home
+     * - 场景: scene
+     * - 设置: setting
+     * @since HomeKit 3.15.3
+     */
+    tabKey: string
+  }
+
+  /** @since HomeKit 3.15.3 */
+  export interface SceneIcon {
+    /**
+     * 前景图
+     * @since HomeKit 3.15.3
+     */
+    fgIcon: string
+    /**
+     * 背景色
+     * @since HomeKit 3.15.3
+     */
+    bgColor: string
+  }
+
+  /** @since HomeKit 3.15.3 */
+  export interface SceneInfoData {
+    /**
+     * 场景id
+     * @since HomeKit 3.15.3
+     */
+    sceneId: string
+    /**
+     * 场景名称
+     * @since HomeKit 3.15.3
+     */
+    sceneName: string
+    /**
+     * 场景类型:1.一键执行 2.自动化
+     * @since HomeKit 3.15.3
+     */
+    type: number
+    /**
+     * 家庭id
+     * @since HomeKit 3.15.3
+     */
+    homeId: number
+    /**
+     * 自动化条件图标列表
+     * @since HomeKit 3.15.3
+     */
+    conditionIcons: SceneIcon[]
+    /**
+     * 自动化动作图标列表
+     * @since HomeKit 3.15.3
+     */
+    actionIcons: SceneIcon[]
+    /**
+     * 一键执行的图标
+     * @since HomeKit 3.15.3
+     */
+    fgIcon: string
+    /**
+     * 一键执行的背景
+     * @since HomeKit 3.15.3
+     */
+    bgColor: string
+    /**
+     * 是否启用（仅自动化有效）
+     * @since HomeKit 3.15.3
+     */
+    enable: boolean
+  }
+
+  /** @since HomeKit 3.15.3 */
+  export interface SceneListData {
+    /**
+     * 场景列表信息
+     * @since HomeKit 3.15.3
+     */
+    sceneList: SceneInfoData[]
+  }
+
+  /** @since HomeKit 3.15.3 */
+  export interface SceneOperationParams {
+    /**
+     * 场景id
+     * @since HomeKit 3.15.3
+     */
+    sceneId: string
+    /**
+     * 操作类型
+     * - 执行: 2
+     * - 启用: 1
+     * - 禁用: 0
+     * @since HomeKit 3.15.3
+     */
+    operationType: string
+  }
+
+  /** @since HomeKit 3.15.3 */
+  export interface ConfigA11yParams {
+    /**
+     * 是否开启无障碍模式
+     * @since HomeKit 3.15.3
+     */
+    enable: boolean
+  }
+
+  /** @since HomeKit 3.15.3 */
+  export interface A11yStatusResponse {
+    /**
+     * 是否开启无障碍模式
+     * @since HomeKit 3.15.3
+     */
+    enable: boolean
+  }
+
+  /** @since HomeKit 3.16.0 */
+  export interface SupportHomeKitResponse {
+    /**
+     * 是否支持 HomeKit
+     * @since HomeKit 3.16.0
+     */
+    support: boolean
+  }
+
+  /** @since HomeKit 3.16.0 */
+  export interface SupportHomeAssistantResponse {
+    /**
+     * 是否支持 Home Assistant
+     * @since HomeKit 3.16.0
+     */
+    support: boolean
+  }
+
+  /** @since HomeKit 3.16.0 */
+  export interface AddDeviceToHomeEnabledResponse {
+    /**
+     * 是否开启设备自动添加至首页
+     * @since HomeKit 3.16.0
+     */
+    enabled: boolean
+  }
+
+  /** @since HomeKit 3.16.0 */
+  export interface SupportGoogleHomeResponse {
+    /**
+     * 是否支持 Google Home
+     * @since HomeKit 3.16.0
+     */
+    support: boolean
+  }
+
+  /** @since HomeKit 3.16.0 */
+  export interface GetDeviceListParams {
+    /**
+     * 家庭id
+     * @since HomeKit 3.16.0
+     */
+    homeId: number
+  }
+
+  /** @since HomeKit 3.16.0 */
+  export interface GetDeviceListResponse {
+    /**
+     * 设备IDs列表
+     * @since HomeKit 3.16.0
+     */
+    deviceIds: string[]
+  }
+
+  /** @since HomeKit 3.16.0 */
+  export interface AddDIYHomeDeviceCardsParams {
+    /**
+     * 设备id列表
+     * @since HomeKit 3.16.0
+     */
+    cards: DIYHomeCardWithStyle[]
+    /**
+     * 家庭id
+     * @since HomeKit 3.16.0
+     */
+    gid: number
+  }
+
+  /**
+   * AIBar 显示模式枚举（0=不支持显示，1=底部拼接，2=悬浮）
+   * @since HomeKit 3.15.0
+   */
+  export enum ShouldShowAIBarDisplayMode {
+    /**
+     * 不支持显示
+     * @since HomeKit 3.15.0
+     */
+    None = 0,
+
+    /**
+     * 以拼接在容器底部显示AIBar
+     * @since HomeKit 3.15.0
+     */
+    Bottom = 1,
+
+    /**
+     * 以悬浮在容器上显示AIBar
+     * @since HomeKit 3.15.0
+     */
+    Float = 2,
+  }
+
+  /**
+   * AIBar 输入类型枚举
+   * @since HomeKit 3.15.0
+   */
+  export enum AIBarInputType {
+    /**
+     * 文本输入
+     * @since HomeKit 3.15.0
+     */
+    Text = "text",
+
+    /**
+     * 语音输入
+     * @since HomeKit 3.15.0
+     */
+    Voice = "voice",
+  }
+
+  /**
+   * AIBar 主题模式
+   * @since HomeKit 3.15.4
+   */
+  export enum AIBarThemeMode {
+    /**
+     * 跟随系统
+     * @since HomeKit 3.15.4
+     */
+    FollowSystem = 0,
+
+    /**
+     * 浅色
+     * @since HomeKit 3.15.4
+     */
+    Light = 1,
+
+    /**
+     * 深色
+     * @since HomeKit 3.15.4
+     */
+    Dark = 2,
+  }
+
+  /**
+   * 家庭模式枚举
+   * @since HomeKit 3.7.8
+   */
+  export enum ThingSmartHomeMode {
+    /**
+     * Ordinary standard home
+     * @since HomeKit 3.7.8
+     */
+    Default = 0,
+
+    /**
+     * Spatialized home
+     * @since HomeKit 3.7.8
+     */
+    Space = 1,
+
+    /**
+     * Professional Lighting Space Home
+     * @since HomeKit 3.7.8
+     */
+    SMB = 2,
+  }
+
+  /**
+   * 家庭成员角色枚举
+   * @since HomeKit 3.7.12
+   */
+  export enum ThingSmartHomeRole {
+    /**
+     * custom member role
+     * @since HomeKit 3.7.12
+     */
+    custom = -1,
+
+    /**
+     * common member role
+     * @since HomeKit 3.7.12
+     */
+    member = 0,
+
+    /**
+     * administrator role
+     * @since HomeKit 3.7.12
+     */
+    admin = 1,
+
+    /**
+     * family owner
+     * @since HomeKit 3.7.12
+     */
+    owner = 2,
+
+    /**
+     * illegal role
+     * @since HomeKit 3.7.12
+     */
+    invalid = -999,
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export enum DIYHomeCardType {
+    /**
+     * 天气
+     * @since HomeKit 3.11.0
+     */
+    Weather = 1,
+
+    /**
+     * 设备列表
+     * @since HomeKit 3.11.0
+     */
+    DeviceList = 2,
+
+    /**
+     * 房间列表
+     * @since HomeKit 3.11.0
+     */
+    RoomList = 3,
+
+    /**
+     * 场景
+     * @since HomeKit 3.11.0
+     */
+    Scene = 4,
+
+    /**
+     * 小程序
+     * @since HomeKit 3.11.0
+     */
+    MiniApp = 5,
+
+    /**
+     * 房间
+     * @since HomeKit 3.11.0
+     */
+    Room = 6,
+
+    /**
+     * 设备
+     * @since HomeKit 3.11.0
+     */
+    Device = 7,
+
+    /**
+     * 群组
+     * @since HomeKit 3.11.0
+     */
+    Group = 8,
+
+    /**
+     * 数据卡片
+     * @since HomeKit 3.11.0
+     */
+    Dashboard = 9,
+
+    /**
+     * 设备分类
+     * @since HomeKit 3.11.0
+     */
+    DeviceCategory = 10,
+
+    /**
+     * 照明子系统
+     * @since HomeKit 3.11.0
+     */
+    LightSubSystem = 11,
+
+    /**
+     * 一键隐私
+     * @since HomeKit 3.11.0
+     */
+    PrivateMode = 12,
+
+    /**
+     * 免打扰
+     * @since HomeKit 3.11.0
+     */
+    Disturb = 13,
+
+    /**
+     * 耳机卡片
+     * @since HomeKit 3.11.0
+     */
+    EarPhone = 14,
+
+    /**
+     * AI推荐
+     * @since HomeKit 3.11.0
+     */
+    AIRecom = 15,
+
+    /**
+     * 场景的延时日程
+     * @since HomeKit 3.11.0
+     */
+    SceneSchedule = 16,
+
+    /**
+     * 卡路里
+     * @since HomeKit 3.11.0
+     */
+    AICalories = 17,
+
+    /**
+     * AI翻译
+     * @since HomeKit 3.11.0
+     */
+    AITranslate = 18,
+  }
+
+  /** @since HomeKit 3.11.0 */
+  export enum DIYHomeCardStyle {
+    /**
+     * 小卡片
+     * @since HomeKit 3.11.0
+     */
+    Small = 1,
+
+    /**
+     * 中卡片
+     * @since HomeKit 3.11.0
+     */
+    Medium = 2,
+
+    /**
+     * 大卡片
+     * @since HomeKit 3.11.0
+     */
+    Large = 3,
+
+    /**
+     * 视频设备超大卡片
+     * @since HomeKit 3.11.0
+     */
+    IPC = 4,
+
+    /**
+     * 空间（房间）卡片自适应大小
+     * @since HomeKit 3.11.0
+     */
+    SpacePanel = 5,
+
+    /**
+     * AI玩偶中卡片
+     * @since HomeKit 3.11.0
+     */
+    AIToyMid = 6,
+
+    /**
+     * AI玩偶大卡片
+     * @since HomeKit 3.11.0
+     */
+    AIToyBig = 7,
+
+    /**
+     * 大卡片 自适应高度
+     * @since HomeKit 3.11.0
+     */
+    Fit = 8,
+  }
+
+  /**
+   * 设备类型枚举
+   * @since HomeKit 3.16.0
+   */
+  export enum ThingDeviceType {
+    /**
+     * 全部设备
+     * @since HomeKit 3.16.0
+     */
+    All = -1,
+
+    /**
+     * wifi设备
+     * @since HomeKit 3.16.0
+     */
+    Wifi = 0,
+
+    /**
+     * 蓝牙设备
+     * @since HomeKit 3.16.0
+     */
+    Ble = 1,
+
+    /**
+     * GPRS设备
+     * @since HomeKit 3.16.0
+     */
+    Gprs = 2,
+
+    /**
+     * NB-IoT设备
+     * @since HomeKit 3.16.0
+     */
+    NBIoT = 3,
+
+    /**
+     * Zigbee网关设备
+     * @since HomeKit 3.16.0
+     */
+    ZigbeeGateway = 4,
+
+    /**
+     * Zigbee子设备
+     * @since HomeKit 3.16.0
+     */
+    ZigbeeSubDev = 5,
+
+    /**
+     * Mesh设备
+     * @since HomeKit 3.16.0
+     */
+    MeshBleSubDev = 6,
+
+    /**
+     * 红外网关设备
+     * @since HomeKit 3.16.0
+     */
+    InfraredGateway = 7,
+
+    /**
+     * 红外子设备
+     * @since HomeKit 3.16.0
+     */
+    InfraredSubDev = 8,
+
+    /**
+     * Wi-Fi网关设备
+     * @since HomeKit 3.16.0
+     */
+    WifiGateway = 9,
+
+    /**
+     * Wi-Fi子设备
+     * @since HomeKit 3.16.0
+     */
+    WifiSubDev = 10,
+
+    /**
+     * SIG Mesh网关设备
+     * @since HomeKit 3.16.0
+     */
+    SIGMeshGateway = 11,
+
+    /**
+     * SIG Mesh子设备
+     * @since HomeKit 3.16.0
+     */
+    SIGMeshSubDev = 12,
+
+    /**
+     * 蓝牙Beacon设备
+     * @since HomeKit 3.16.0
+     */
+    Beacon = 13,
+
+    /**
+     * Cat.1设备
+     * @since HomeKit 3.16.0
+     */
+    Cat1 = 14,
+
+    /**
+     * Thread网关设备
+     * @since HomeKit 3.16.0
+     */
+    ThreadGateway = 15,
+
+    /**
+     * Thread子设备
+     * @since HomeKit 3.16.0
+     */
+    ThreadSubDev = 16,
+
+    /**
+     * Fitting设备
+     * @since HomeKit 3.16.0
+     */
+    Fitting = 17,
+  }
+
+  /**
+   * 维度查询参数，包含 ownerId、roomId、devId
+   * @since HomeKit 3.1.0
+   */
+  export interface OwnerId {
+    /**
+     * 维度id
+     * @since HomeKit 3.1.0
+     */
+    ownerId: number
+    /**
+     * 房间ID
+     * @since HomeKit 3.7.10
+     */
+    roomId: number
+    /**
+     * 设备id
+     * @since HomeKit 3.8.0
+     */
+    devId: string
+  }
+
+  /**
+   * 设备 ID 列表返回结果
+   * @since HomeKit 3.1.0
+   */
+  export interface DeviceIdList {
+    /**
+     * 设备id列表
+     * @since HomeKit 3.1.0
+     */
+    devIds: string[]
+  }
+
+  /**
+   * 房间数据，包含房间 ID、名称及房间内设备 ID 列表
+   * @since HomeKit 3.1.0
+   */
+  export interface RoomData {
+    /**
+     * 房间id
+     * @since HomeKit 3.1.0
+     */
+    roomId: number
+    /**
+     * 房间名称
+     * @since HomeKit 3.1.0
+     */
+    name: string
+    /**
+     * 房间下的设备id
+     * @since HomeKit 3.1.0
+     */
+    deviceIds: string[]
+  }
+
+  /**
+   * 房间列表返回结果
+   * @since HomeKit 3.1.0
+   */
+  export interface RoomList {
+    /**
+     * 房间列表
+     * @since HomeKit 3.1.0
+     */
+    roomDatas: RoomData[]
+  }
+
+  /**
+   * 群组 ID 列表返回结果
+   * @since HomeKit 3.5.3
+   */
+  export interface GroupIdList {
+    /**
+     * 群组id列表
+     * @since HomeKit 3.5.3
+     */
+    groupIds: string[]
+  }
+
+  /**
+   * 设备移除事件体
+   * @since HomeKit 3.5.3
+   */
+  export interface OnDeviceRemovedBody {
+    /**
+     * 设备id
+     * @since HomeKit 3.5.3
+     */
+    deviceId: string
+  }
+
+  /**
+   * 设备添加事件体
+   * @since HomeKit 3.5.3
+   */
+  export interface OnDeviceAddBody {
+    /**
+     * 设备id
+     * @since HomeKit 3.5.3
+     */
+    deviceId: string
+  }
+
+  /**
+   * 群组移除事件体
+   * @since HomeKit 3.5.3
+   */
+  export interface OnGroupRemovedBody {
+    /**
+     * 群组 id
+     * @since HomeKit 3.5.3
+     */
+    groupId: string
+  }
+
+  /**
+   * 群组添加事件体
+   * @since HomeKit 3.5.3
+   */
+  export interface OnGroupAddBody {
+    /**
+     * 群组 id
+     * @since HomeKit 3.5.3
+     */
+    groupId: string
+  }
+
+  /**
+   * 分享列表变化事件体
+   * @since HomeKit 3.5.3
+   */
+  export interface OnShareListChangeBody {
+    /**
+     * 是否发生变化
+     * @since HomeKit 3.5.3
+     */
+    change: boolean
+  }
+
+  /**
+   * switchDeviceRoom 的请求参数，包含设备 ID 和目标房间 ID
+   * @since HomeKit 3.10.0
+   */
+  export interface SwitchDeviceBean {
+    /**
+     * 设备id
+     * @since HomeKit 3.10.0
+     */
+    deviceId: string
+    /**
+     * 房间id
+     * @since HomeKit 3.10.0
+     */
+    roomId: number
+  }
+
+  /**
+   * 图形验证码凭证模型，作为 `onTicketSuccess` 方法的入参与回调返回值
+   * @since HomeKit 3.1.3
+   */
+  export interface TicketModel {
+    /**
+     * 验证码凭证键值对，key 为参数名，value 为对应值
+     * @since HomeKit 3.1.3
+     */
+    map?: Record<string, string>
+  }
+
+  /** @since HomeKit 3.14.0 */
+  export interface CanShowMobileBindViewResult {
+    /**
+     * 是否展示手机号绑定弹窗
+     * @since HomeKit 3.14.0
+     */
+    show: boolean
+  }
+
+  /**
+   * 打开推荐场景详情的请求参数
+   * @since HomeKit 1.0.4
+   */
+  export interface RecommendSceneParams {
+    /**
+     * 来源
+     * @since HomeKit 1.0.4
+     */
+    source: string
+    /**
+     * 场景模型
+     * @since HomeKit 1.0.4
+     */
+    sceneModel: Record<string, any>
+  }
+
+  /**
+   * openRecommendSceneDetail 的回调返回数据
+   * @since HomeKit 1.0.4
+   */
+  export interface RecommendSceneCallBack {
+    /**
+     * 返回状态，默认返回 true
+     * @since HomeKit 1.0.4
+     * @defaultValue true
+     */
+    status?: boolean
+    /**
+     * 成功返回的类型。0-未操作，1-保存成功，2-点击不感兴趣
+     * @since HomeKit 1.0.4
+     */
+    type: number
+    /**
+     * 返回的场景数据，可能为空
+     * @since HomeKit 1.0.4
+     */
+    data?: Record<string, any>
+  }
+
+  /**
+   * openDeviceExecutionAndAnutomation 的请求参数
+   * @since HomeKit 2.1.0
+   */
+  export interface OpenDeviceExecutionAndAnutomationParams {
+    /**
+     * 设备 ID
+     * @since HomeKit 2.1.0
+     */
+    deviceId: string
+    /**
+     * 页面标题，Android 需要
+     * @since HomeKit 2.1.0
      */
-    deviceId: string
-    /** 页面标题，Android 需要 */
     title?: string
   }
 }