@tencentcloud/sdk-mcp 1.7.7 → 1.7.9-beta.1

package/resource/knowledge/iot/client-api/app/harmonyos/txiotmonitorsession.md

@@ -0,0 +1,252 @@
+---
+product: iot
+framework:
+  - harmonyos
+types:
+  - api
+retrievable_scope: always
+feature_domain: client_api
+---
+
+## 概述
+
+TXIoTMonitorSession 负责拉取设备实时监控画面，包括开始/停止会话、远端拉流与清晰度切换、与设备进行对讲、云台控制、截图与本地录制。TXIoTMonitorSession 通过 TXIoTEngine.getMonitorSession 获取实例，需在登录成功后调用。
+
+> **说明：**
+> 回调模型：所有 Listener 回调在主线程触发，公共类型与错误码定义见 TXIoTEngineDef。渲染视图参数 `TXView` 为 `string` 类型，传 ArkUI `XComponent` 组件的 id（该 XComponent 需设置 `type: XComponentType.SURFACE`、`libraryname: 'liteavsdk'`）。
+>
+
+## 方法列表
+
+|方法签名|描述|
+|---------|---------|
+|`addListener`|添加实时监控事件监听器。|
+|`removeListener`|移除实时监控事件监听器。|
+|`startSession`|开启实时监控。|
+|`stopSession`|停止实时监控。|
+|`startRemoteView`|开始渲染远端视频流。|
+|`stopRemoteView`|停止渲染远端视频流。|
+|`switchRemoteStream`|切换远端视频流类型（高清/标清）。|
+|`muteRemoteAudio`|静音/取消静音单路远端音频。|
+|`muteAllRemoteAudio`|静音/取消静音所有远端音频。|
+|`startLocalAudio`|开启本地音频采集和推送（用于实现对讲功能）。|
+|`stopLocalAudio`|关闭本地音频采集和推送。|
+|`muteLocalAudio`|静音/取消静音本地音频。|
+|`startLocalVideo`|开启本地视频采集和推送。|
+|`stopLocalVideo`|关闭本地视频采集和推送。|
+|`sendPTZCommand`|发送云台控制指令。|
+|`takeSnapshot`|对当前正在观看的通道进行截图。|
+|`startLocalRecording`|开始对当前正在观看的通道进行录像。|
+|`stopLocalRecording`|停止本地录像。|
+
+### addListener
+
+**添加实时监控事件监听器**
+
+|参数|描述|
+|---------|---------|
+|listener|`TXIoTMonitorSessionListener`；监听器实例。|
+
+### removeListener
+
+**移除实时监控事件监听器**
+
+|参数|描述|
+|---------|---------|
+|listener|`TXIoTMonitorSessionListener`；监听器实例。|
+
+### startSession
+
+**开启实时监控**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId；设备标识（含 productId / deviceName）。|
+
+### stopSession
+
+**停止实时监控**
+
+### startRemoteView
+
+**开始渲染远端视频流**
+
+|参数|描述|
+|---------|---------|
+|channelId|`number`；通道 ID，从 0 开始计数；单通道设备填 0。|
+|streamType|`TXIoTStreamType`；视频流类型（高清/标清）。|
+|view|`TXView`（`string`）；视频渲染视图，传 XComponent 组件的 id。|
+
+### stopRemoteView
+
+**停止渲染远端视频流**
+
+|参数|描述|
+|---------|---------|
+|channelId|`number`；通道 ID。|
+
+### switchRemoteStream
+
+**切换远端视频流类型（高清/标清）**
+
+|参数|描述|
+|---------|---------|
+|channelId|`number`；通道 ID。|
+|streamType|`TXIoTStreamType`；视频流类型（高清/标清）。|
+
+### muteRemoteAudio
+
+**静音/取消静音单路远端音频**
+
+|参数|描述|
+|---------|---------|
+|channelId|`number`；通道 ID。|
+|mute|`boolean`；是否静音。|
+
+### muteAllRemoteAudio
+
+**静音/取消静音所有远端音频**
+
+|参数|描述|
+|---------|---------|
+|mute|`boolean`；是否静音。|
+
+### startLocalAudio
+
+**开启本地音频采集和推送（用于实现对讲功能）**
+
+### stopLocalAudio
+
+**停止本地音频采集和推送**
+
+### muteLocalAudio
+
+**静音/取消静音本地音频**
+
+|参数|描述|
+|---------|---------|
+|mute|`boolean`；是否静音。|
+
+### startLocalVideo
+
+**开启本地视频采集和推送**
+
+|参数|描述|
+|---------|---------|
+|view|`TXView`（`string`）；本地预览渲染视图，传 XComponent 组件的 id。|
+|videoEncoderParams|`TXIoTVideoEncoderParams`；视频编码参数。|
+
+### stopLocalVideo
+
+**停止本地视频采集和推送**
+
+### sendPTZCommand
+
+**发送云台控制指令**
+
+|参数|描述|
+|---------|---------|
+|channelId|`number`；通道 ID。|
+|command|`TXIoTPTZCommand`；云台控制指令。|
+|speed|`number`；云台运动速度。|
+
+### takeSnapshot
+
+**对当前正在观看的通道进行截图**
+
+|参数|描述|
+|---------|---------|
+|channelId|`number`；通道 ID。|
+
+> **说明：**
+> 截图结果通过 `onSnapshotComplete` 回调返回，成功时 `image` 为 `image.PixelMap` 对象（`@ohos.multimedia.image`），失败时为 `null`。
+>
+
+### startLocalRecording
+
+**开始对当前正在观看的通道进行录像**
+
+|参数|描述|
+|---------|---------|
+|channelId|`number`；通道 ID。|
+|params|`TXIoTLocalRecordingParams`；本地录像参数。|
+
+### stopLocalRecording
+
+**停止本地录像**
+
+|参数|描述|
+|---------|---------|
+|channelId|`number`；通道 ID。|
+
+## 监控事件回调
+
+`TXIoTMonitorSessionListener` 为 ArkTS 接口，所有回调方法均为可选，调用方可按需实现。
+
+|回调方法|说明|
+|---------|---------|
+|`onError(channelId: number, errCode: TXIoTErrorCode, errMsg: string)`|监控发生错误。|
+|`onSessionEstablished()`|监控会话建立成功。|
+|`onSessionReconnecting()`|会话重连中。|
+|`onSessionRecovery()`|会话恢复成功。|
+|`onRemoteStreamAvailable(channelId: number, available: boolean)`|远端流可用性变化。|
+|`onRenderFirstFrame(channelId: number)`|首帧渲染完成。|
+|`onPlayStateChanged(channelId: number, state: TXIoTPlayState)`|播放状态变化。|
+|`onSnapshotComplete(channelId: number, image: image.PixelMap \| null, errCode: TXIoTErrorCode)`|截图完成，成功时 image 非 null。|
+|`onLocalRecordBegin(channelId: number, errCode: TXIoTErrorCode, storagePath: string)`|本地录像开始。|
+|`onLocalRecording(channelId: number, durationMs: number, storagePath: string)`|本地录像进行中，周期性回调时长（单位：毫秒）。|
+|`onLocalRecordComplete(channelId: number, errCode: TXIoTErrorCode, storagePath: string)`|本地录像完成。|
+
+## 监控相关数据结构与枚举
+
+### TXIoTStreamType
+
+|枚举|说明|
+|---------|---------|
+|HD|高清。|
+|SD|标清。|
+
+### TXIoTPTZCommand
+
+|枚举|说明|
+|---------|---------|
+|UP|上。|
+|DOWN|下。|
+|LEFT|左。|
+|RIGHT|右。|
+|ZOOM_IN|变焦放大。|
+|ZOOM_OUT|变焦缩小。|
+|STOP|停止。|
+
+### TXIoTPlayState
+
+|枚举|说明|
+|---------|---------|
+|PLAYING|正在播放。|
+|LOADING|加载中。|
+|STOPPED|已停止。|
+
+### TXIoTVideoResolution
+
+|枚举|说明|
+|---------|---------|
+|RESOLUTION_640_360|横屏 640×360。|
+|RESOLUTION_960_540|横屏 960×540。|
+|RESOLUTION_1280_720|横屏 1280×720。|
+|RESOLUTION_1920_1080|横屏 1920×1080。|
+|RESOLUTION_360_640|竖屏 360×640。|
+|RESOLUTION_540_960|竖屏 540×960。|
+|RESOLUTION_720_1280|竖屏 720×1280。|
+|RESOLUTION_1080_1920|竖屏 1080×1920。|
+
+### TXIoTVideoEncoderParams
+
+|字段|说明|
+|---------|---------|
+|resolution|视频编码分辨率，见 `TXIoTVideoResolution`，默认为 RESOLUTION_640_360。|
+
+### TXIoTLocalRecordingParams
+
+|字段|说明|
+|---------|---------|
+|filePath|录像文件保存路径。|

package/resource/knowledge/iot/client-api/app/ios/txiotcallsession.md

@@ -0,0 +1,199 @@
+---
+product: iot
+framework:
+  - ios
+types:
+  - api
+retrievable_scope: always
+feature_domain: client_api
+---
+
+## 概述
+
+TXIoTCallSession 负责与设备之间的音视频通话，包括发起呼叫、挂断、远端画面渲染、麦克风/摄像头控制及音频输出设备选择。TXIoTCallSession 通过 TXIoTEngine.getCallSession 获取实例，需在 TXIoTEngine 登录成功后调用。
+
+> **说明：**
+> 回调模型：通话事件通过 `TXIoTCallDelegate` 协议回调，所有 Delegate 回调在主线程触发。公共类型与错误码定义见 TXIoTEngineDef。
+>
+
+## 方法列表
+
+|方法签名|描述|
+|---------|---------|
+|addDelegate:|添加通话事件代理。|
+|removeDelegate:|移除通话事件代理。|
+|callDevice:callType:|向设备发起音视频通话。|
+|hangup|挂断当前通话。|
+|startRemoteView:view:|开始远端画面渲染。|
+|stopRemoteView:|停止远端画面渲染。|
+|openMicrophone|打开麦克风。|
+|closeMicrophone|关闭麦克风。|
+|openCamera:view:|打开摄像头。|
+|closeCamera|关闭摄像头。|
+|switchCamera:|切换摄像头。|
+|selectAudioPlaybackDevice:|选择音频播放设备。|
+
+### addDelegate:
+
+**添加通话事件代理**
+
+|参数|描述|
+|---------|---------|
+|delegate|`id<TXIoTCallDelegate>`；通话事件代理对象。|
+
+### removeDelegate:
+
+**移除通话事件代理**
+
+|参数|描述|
+|---------|---------|
+|delegate|`id<TXIoTCallDelegate>`；要移除的通话事件代理对象。|
+
+### callDevice:callType:
+
+**向设备发起音视频通话**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；目标设备 ID。|
+|callType|TXIoTCallMediaType；通话类型：音频或视频。|
+
+### hangup
+
+**挂断当前通话**
+
+### startRemoteView:view:
+
+**开始渲染远端画面**
+
+|参数|描述|
+|---------|---------|
+|callUser|TXIoTCallUser*；通话用户对象。|
+|view|`TXView*`；用于渲染远端画面的视图。|
+
+### stopRemoteView:
+
+**停止远端画面渲染**
+
+|参数|描述|
+|---------|---------|
+|callUser|TXIoTCallUser*；参与本次通话的用户对象。|
+
+### openMicrophone
+
+**打开麦克风**
+
+### closeMicrophone
+
+**关闭麦克风**
+
+### openCamera:view:
+
+**打开摄像头**
+
+|参数|描述|
+|---------|---------|
+|camera|TXIoTCamera；摄像头类型：前置或后置。|
+|view|`TXView*`；用于渲染本地画面的视图。|
+
+### closeCamera
+
+**关闭摄像头**
+
+### switchCamera:
+
+**切换摄像头**
+
+|参数|描述|
+|---------|---------|
+|camera|TXIoTCamera；目标摄像头类型：前置或后置。|
+
+### selectAudioPlaybackDevice:
+
+**选择音频播放设备**
+
+|参数|描述|
+|---------|---------|
+|device|TXIoTAudioPlaybackDevice；音频播放设备：扬声器或听筒。|
+
+## 通话事件回调
+
+`TXIoTCallDelegate` 协议定义通话事件回调，所有方法均为 `@optional`。
+
+|回调|说明|
+|---------|---------|
+|onError:errorMessage:|通话过程中发生错误，错误码见 TXIoTErrorCode。|
+|onCallBegin:|通话开始，返回通话类型（音频/视频）。|
+|onCallEnd:reason:|通话结束，返回挂断原因。|
+|onCallRejected:|对方拒绝接听。|
+|onCallNoResponse:|对方无响应。|
+|onCallLineBusy:|对方线路忙。|
+|onCallUserOffline:|对方不在线。|
+|onCallUserAudioAvailable:available:|远端音频可用性变化。|
+|onCallUserVideoAvailable:available:|远端视频可用性变化。|
+|onCallNetworkQualityChanged:remoteQualityList:|网络质量变化通知。|
+
+## 通话相关数据结构与枚举
+
+### TXIoTCallUser
+
+参与通话的用户信息，用于标识通话对端。
+
+|字段|说明|
+|---------|---------|
+|deviceId|通话对端的设备 ID。|
+
+### TXIoTQuality
+
+网络质量信息。
+
+|字段|说明|
+|---------|---------|
+|callUser|网络质量对应的通话用户。|
+|quality|网络质量等级。|
+
+### TXIoTCallMediaType
+
+通话类型枚举。
+
+|枚举|取值|说明|
+|---------|---------|---------|
+|TXIoTCallMediaTypeAudio|0|音频通话。|
+|TXIoTCallMediaTypeVideo|1|视频通话。|
+
+### TXIoTCallEndReason
+
+通话结束原因枚举。
+
+|枚举|取值|说明|
+|---------|---------|---------|
+|TXIoTCallEndReasonUnknown|0|未知原因。|
+|TXIoTCallEndReasonLocalHangup|1|本地挂断。|
+|TXIoTCallEndReasonRemoteHangup|2|远端挂断。|
+|TXIoTCallEndReasonCallPermissionDenied|3|呼叫权限被拒绝。|
+|TXIoTCallEndReasonNetworkError|4|网络错误。|
+
+### TXIoTAudioPlaybackDevice
+
+|枚举|取值|说明|
+|---------|---------|---------|
+|TXIoTAudioPlaybackDeviceSpeakerphone|0|扬声器（外放）。|
+|TXIoTAudioPlaybackDeviceEarpiece|1|听筒。|
+
+### TXIoTCamera
+
+|枚举|取值|说明|
+|---------|---------|---------|
+|TXIoTCameraFront|0|前置摄像头。|
+|TXIoTCameraBack|1|后置摄像头。|
+
+### TXIoTNetworkQuality
+
+|枚举|取值|说明|
+|---------|---------|---------|
+|TXIoTNetworkQualityExcellent|0|极佳|
+|TXIoTNetworkQualityGood|1|良好|
+|TXIoTNetworkQualityPoor|2|较差|
+|TXIoTNetworkQualityBad|3|差|
+|TXIoTNetworkQualityVeryBad|4|很差|
+|TXIoTNetworkQualityDown|5|网络不可用|

package/resource/knowledge/iot/client-api/app/ios/txiotcloudstorage.md

@@ -0,0 +1,76 @@
+---
+product: iot
+framework:
+  - ios
+types:
+  - api
+retrievable_scope: always
+feature_domain: client_api
+---
+
+## 概述
+
+`TXIoTCloudStorage` 是云存功能模块，通过 `TXIoTEngine` 的 `getCloudStorage`获取（未登录时返回`nil`，提供设备云端录像的日期列表与事件列表查询能力。
+
+> **说明：**
+> 线程模型：SDK 接口可在任意线程调用；回调均在主线程（UI 线程）触发，调用方可在回调中直接操作 UI。查询结果通过 `TXIoTCallback` 对象的 `onSuccess` / `onError` block 返回。
+>
+
+## 方法列表
+
+|方法签名|描述|
+|---------|---------|
+|`getDayList:timeZone:callback:`|查询指定通道有云端录像的日期列表。|
+|`getEventList:timeZone:date:nextPageToken:callback:`|分页查询指定日期的云存事件列表。|
+
+### getDayList
+
+**查询有云端录像的日期列表**
+
+|参数|描述|
+|---------|---------|
+|channelId|通道 ID，从 0 开始计数；单通道设备填 0。|
+|timeZone|按天统计录像所用的时区，如 `[NSTimeZone localTimeZone]`。传 `nil` 时使用系统默认时区。|
+|callback|结果回调。`onSuccess` 返回有云端录像的日期字符串数组，格式为 `yyyy-MM-dd`（如 `2026-08-20`）；`onError` 返回错误码与错误描述。|
+
+### getEventList
+
+**分页查询指定日期的云存事件列表**
+
+|参数|描述|
+|---------|---------|
+|channelId|通道 ID，从 0 开始计数；单通道设备填 0。|
+|timeZone|按天统计事件所用的时区，如 `[NSTimeZone localTimeZone]`。传 `nil` 时使用系统默认时区。|
+|date|要查询的日期，格式为 `yyyy-MM-dd`（如 `2026-08-20`），通常取自 `getDayList` 的返回结果。|
+|nextPageToken|分页标记。首次查询传空字符串 `@""`；翻页时传入上一次回调返回的 `TXIoTPageResult.nextPageToken`。|
+|callback|结果回调。`onSuccess` 返回分页结果，`dataList` 为本页事件数组，`nextPageToken` 为空字符串表示没有更多数据；`onError` 返回错误码与错误描述。|
+
+> **注意：**
+> - `date` 不能为空字符串，否则回调 `onError` 并返回参数错误。
+
+## 云存相关数据结构
+
+### TXIoTEvent
+
+**云存事件，包含事件类型、缩略图、发生时间及关联录像文件**
+
+|字段|说明|
+|---------|---------|
+|eventType|事件类型标识，可能为空字符串，调用方可按需过滤。|
+|thumbnailUrl|事件缩略图 URL。|
+|eventTimeMs|事件发生时间，Unix 毫秒级时间戳。|
+|durationMs|事件时长，单位毫秒。|
+|videoFiles|事件关联的录像文件数组。|
+
+### TXIoTVideoFile
+
+**云存录像文件，包含播放地址与云点播（VOD）播放信息**
+
+|字段|说明|
+|---------|---------|
+|videoUrl|录像文件播放地址。|
+|vodAppId|云点播应用 ID，用于通过 VOD 播放器播放。|
+|vodFileId|云点播文件 ID，用于通过 VOD 播放器播放。|
+|vodPlaySign|云点播播放签名。|
+|startTimeMs|录像片段起始时间，Unix 毫秒级时间戳。|
+|durationMs|录像片段时长，单位毫秒。|

package/resource/knowledge/iot/client-api/app/ios/txiotdevicemanager.md

@@ -0,0 +1,173 @@
+---
+product: iot
+framework:
+  - ios
+types:
+  - api
+retrievable_scope: always
+feature_domain: client_api
+---
+
+## 概述
+
+TXIoTDeviceManager 负责设备的绑定/解绑、房间归属、设备分享、指令下发、属性查询与别名修改等。TXIoTDeviceManager 通过 TXIoTEngine.getDeviceManager 获取实例，需在 TXIoTEngine 登录成功后调用。
+
+> **说明：**
+> 回调模型：所有接口为异步操作，通过 TXIoTCallback / TXIoTVoidCallback 回调返回结果，回调在主线程触发。公共类型定义见 TXIoTEngineDef。
+>
+
+## 方法列表
+
+|方法签名|描述|
+|---------|---------|
+|bindDevice:deviceBindSignature:callback:|绑定设备到指定家庭。|
+|unbindDevice:deviceId:callback:|从家庭解绑设备。|
+|addDeviceToRoom:familyId:roomId:callback:|将设备加入房间。|
+|removeDeviceFromRoom:familyId:callback:|将设备移出房间。|
+|getDeviceList:nextPageToken:callback:|获取家庭下的设备列表（支持分页）。|
+|createDeviceSharingToken:deviceId:callback:|创建设备分享令牌。|
+|bindDeviceSharedWithMe:shareToken:callback:|绑定他人分享给我的设备。|
+|unbindDeviceSharedWithMe:callback:|解绑他人分享给我的设备。|
+|getDeviceSharedUsers:callback:|获取设备被分享的用户列表。|
+|removeDeviceSharedUser:userId:callback:|移除设备的某个被分享用户。|
+|getDeviceListSharedWithMe:callback:|获取分享给我的设备列表（支持分页）。|
+|sendCommand:jsonData:callback:|向设备下发控制指令。|
+|getProperties:callback:|获取设备属性。|
+|modifyAliasName:aliasName:callback:|修改设备别名。|
+
+### bindDevice:deviceBindSignature:callback:
+
+**绑定设备到指定家庭**
+
+|参数|描述|
+|---------|---------|
+|familyId|`NSString*`；家庭 ID。|
+|deviceBindSignature|`NSString*`；设备绑定签名。|
+|callback|TXIoTCallback<TXIoTDeviceInfo*>*；异步回调，通过 onSuccess / onError 通知结果，成功时返回设备信息。|
+
+### unbindDevice:deviceId:callback:
+
+**从家庭解绑设备**
+
+|参数|描述|
+|---------|---------|
+|familyId|`NSString*`；家庭 ID。|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|callback|TXIoTVoidCallback*；异步回调，通过 onSuccess / onError 通知结果。|
+
+### addDeviceToRoom:familyId:roomId:callback:
+
+**将设备加入房间**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|familyId|`NSString*`；家庭 ID。|
+|roomId|`NSString*`；房间 ID。|
+|callback|TXIoTVoidCallback*；异步回调，通过 onSuccess / onError 通知结果。|
+
+### removeDeviceFromRoom:familyId:callback:
+
+**将设备移出房间**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|familyId|`NSString*`；家庭 ID。|
+|callback|TXIoTVoidCallback*；异步回调，通过 onSuccess / onError 通知结果。|
+
+### getDeviceList:nextPageToken:callback:
+
+**获取家庭下的设备列表（支持分页）**
+
+|参数|描述|
+|---------|---------|
+|familyId|`NSString*`；家庭 ID。|
+|nextPageToken|`NSString* _Nullable`；分页标记，首页传空字符串。|
+|callback|TXIoTCallback<TXIoTPageResult<TXIoTDeviceInfo*>*>*；异步回调，通过 onSuccess / onError 通知结果。|
+
+### createDeviceSharingToken:deviceId:callback:
+
+**创建设备分享令牌**
+
+|参数|描述|
+|---------|---------|
+|familyId|`NSString*`；家庭 ID。|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|callback|TXIoTCallback<NSString*>*；异步回调，通过 onSuccess / onError 通知结果，成功时返回分享令牌字符串。|
+
+### bindDeviceSharedWithMe:shareToken:callback:
+
+**绑定他人分享给我的设备**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|shareToken|`NSString*`；分享令牌。|
+|callback|TXIoTVoidCallback*；异步回调，通过 onSuccess / onError 通知结果。|
+
+### unbindDeviceSharedWithMe:callback:
+
+**解绑他人分享给我的设备**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|callback|TXIoTVoidCallback*；异步回调，通过 onSuccess / onError 通知结果。|
+
+### getDeviceSharedUsers:callback:
+
+**获取设备被分享的用户列表**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|callback|TXIoTCallback<NSArray<TXIoTUserInfo*>*>*；异步回调，通过 onSuccess / onError 通知结果，成功时返回用户列表。|
+
+### removeDeviceSharedUser:userId:callback:
+
+**移除设备的某个被分享用户**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|userId|`NSString\*`；用户 ID。|
+|callback|TXIoTVoidCallback*；异步回调，通过 onSuccess / onError 通知结果。|
+
+### getDeviceListSharedWithMe:callback:
+
+**获取分享给我的设备列表（支持分页）**
+
+|参数|描述|
+|---------|---------|
+|nextPageToken|`NSString\* _Nullable`；分页标记，首页传 nil。|
+|callback|TXIoTCallback<TXIoTPageResult<TXIoTDeviceInfo*>*>*；异步回调，通过 onSuccess / onError 通知结果，成功时返回分页结果。|
+
+### sendCommand:jsonData:callback:
+
+**向设备下发控制指令**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|jsonData|`NSString*`；JSON 格式的控制指令数据。|
+|callback|TXIoTCallback<NSString*>*；异步回调，通过 onSuccess / onError 通知结果，成功时返回设备响应数据。|
+
+### getProperties:callback:
+
+**获取设备属性**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|callback|TXIoTCallback<NSString*>*；异步回调，通过 onSuccess / onError 通知结果，成功时返回 JSON 格式的设备属性。|
+
+### modifyAliasName:aliasName:callback:
+
+**修改设备别名**
+
+|参数|描述|
+|---------|---------|
+|deviceId|TXIoTDeviceId*；设备 ID。|
+|aliasName|`NSString*`；新的别名。|
+|callback|TXIoTVoidCallback*；异步回调，通过 onSuccess / onError 通知结果。|