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

package/resource/knowledge/iot/kids-watch/overview.md

@@ -0,0 +1,28 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: kids-watch
+---
+
+## 场景概述
+
+腾讯云物联网视频通话服务基于腾讯实时音视频 TRTC，将腾讯超过20年在网络与音视频技术上的积累与物联网能力深度融合。该服务面向智能手表等低功耗、小体积、算力受限的可穿戴设备，助力厂商快速搭建高可靠、低延时、低功耗的语音与视频通话服务。
+
+## 方案优势
+
+底层复用腾讯云实时音视频（TRTC）的媒体网络与音频处理能力：应用端与设备分别就近接入 TRTC 媒体网络，在同一房间内互相推流与订阅，不依赖手机与设备之间的端到端直连。对通话这类强交互场景，这一架构选择带来的差异尤为明显。
+
+## 核心功能
+
+|**功能**|**功能描述**|
+|---------|---------|
+|视频通话|手表与家长 App 之间可发起高清双向视频通话，在手表端确认接听后，家长可通过 App 与孩子进行高清双向视频通话。|
+|语音通话|支持手表与 App 之间的实时语音通话与对讲，低功耗、低延时。|
+|弱网抗丢包|自适应码率与抗丢包恢复，在电梯、地下室等弱网环境下保持通话稳定，降低卡顿率。|
+|实时字幕|基于 TRTC-ASR 将通话语音实时转写为文字并回传，嘈杂环境下也能看清对方内容。|
+|全球调度|全球实时传输网络跨区域高质量调度，保障海外及跨运营商场景下的通话质量。|
+

package/resource/knowledge/iot/security-camera/activate-service.md

@@ -0,0 +1,74 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: security-camera
+---
+
+## 开通音视频设备接入服务
+
+### 购买设备激活码
+
+音视频设备接入必须要有对应的音视频设备激活码额度，购买激活码成功后即表示开通了正式版。具体购买流程如下：
+1. 在购买音视频设备接入服务之前，您需要先 [注册腾讯云](https://cloud.tencent.com/document/product/378/17985) 账号，并完成 [实名认证](https://cloud.tencent.com/document/product/378/3629)。
+
+2. 进入 [物联网开发平台购买页](https://buy.cloud.tencent.com/iotexplorer)，实例类型选择**消费实例**，服务类型选择“音视频设备接入服务”。
+
+3. 生效地域：国内设备选择广州区域，出海设备选择新加坡；有效期默认规格5年。
+
+4. 激活码数量：输入您要量产的设备数量，一个物理设备默认烧录一个激活码。
+
+5. 勾选我已阅读并同意《腾讯云服务协议》，单击**立即购买**。
+
+6. 单击立即购买后进入订单确认，音视频设备接入服务分别对应“音视频设备接入服务”和“音视频设备通信服务”。
+
+7. 确认后单击**去支付**进行付款，支付成功后系统将您支付订单的激活码数量累加到对应激活码规格的总可用量数。
+
+### 查看激活码用量
+
+支付完音视频设备接入服务后，用户可进入 [物联网开发平台控制台](https://console.cloud.tencent.com/iotexplorer) 的**消费实例**，选择左侧导航栏的**用量统计** > **激活码概览**页面，可查看支付成功的订单对应的音视频设备激活码用量。
+
+## 创建产品
+1.  登录[物联网开发平台](https://console.cloud.tencent.com/iotexplorer)，进入**实例管理**页面，单击**消费实例**的卡片进入详情页。
+
+2. 选择消费实例左侧导航栏的**产品**，然后单击**创建产品**。
+
+3. 在创建产品页面中，输入“产品名称”，设备类型必须是“**音视频设备**”、认证方式为“密钥认证”、数据协议选择“物模型”。信息配置好后，单击**创建**。
+
+   > **注意：**
+   >
+   > 创建产品时若码率规格显示为“不可选”，表示您的账号未购买该规格码率。码率决定了使用该款产品的用户切换清晰度的上限。
+   >
+
+## 创建设备
+1. 选择消费实例左侧导航栏的**设备**，然后单击**新建设备**。
+
+2. 所属产品选择前述步骤已创建成功的产品，输入设备名称并单击**新建**。
+
+3. 单击创建成功的设备，进入设备详情页获取设备三元组信息。
+
+   > **注意：**
+   >
+   > 产品 ID、设备名称、设备密钥三元组信息作为后续实时监控的设备身份凭证。
+   >
+
+## 创建应用
+1. 选择消费实例左侧导航栏的**应用**，单击**新建应用**。
+
+2. 输入应用名称，单击**保存**创建应用。
+
+3. 单击创建的应用，可获取应用的 App Key 及 App Secret。
+
+   > **注意：**
+   >
+   > App Key 与 App Secret 会在后续 App SDK 开发时使用，可直接使用 Android 应用的 App Key 与 App Secret。
+   >
+
+## 应用关联产品
+
+> **注意：**
+> 若应用未关联产品，APP 在绑定产品下的设备时会提示“APP对操作该产品无权限”。
+>

package/resource/knowledge/iot/security-camera/monitor-playback/app-integration.md

@@ -0,0 +1,302 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: security-camera
+---
+
+本文介绍腾讯云物联网（IoT）应用端 SDK 中实时监控（`TXIoTMonitorSession`）的使用方法。完成 快速接入 并登录 SDK 后，您可以获取监控会话对象，对已绑定的设备发起实时监控，播放设备实时音视频，并监听会话状态与错误回调。您还可以进一步使用云台控制、录制与截图、语音对讲等功能，详情参见 下一步：高级功能。
+
+## 前提条件
+
+在调用本文 API 前，请确保已完成以下准备工作：
+- 已开通腾讯云物联网相关服务，并在控制台完成实例、应用和设备的准备工作（可参见 开通服务）。
+
+- 已在客户端工程中集成 IoT 应用端 SDK。
+
+- 已通过业务后台生成登录签名，并调用 `TXIoTEngine.login` 完成登录。
+
+- 目标设备已绑定到当前登录账户名下（。
+
+- 使用本地麦克风/摄像头对讲前，确保已在工程中申请并获取相应系统权限。
+
+## 使用建议
+- 调用顺序：获取监控会话对象 → 注册监听 → 尽早 startRemoteView 设置渲染视图（可在 startSession 之前调用）→ startSession → 会话建立后自动播放画面；结束时调用 stopSession 停止会话。
+
+- 提前绑定设备：确保目标设备已绑定到当前账户，否则相关调用会返回权限类错误。
+
+- 尽早注册监听：在 startSession 之前完成 addListener，避免错过 `onSessionEstablished` 等早期回调。
+
+- 及时释放：不再需要监控时调用 stopSession 并 removeListener，避免资源泄漏与重复回调。
+
+- 统一错误处理：在 `onError` 中集中处理错误码，结合错误码表给出用户可理解的提示。
+
+## 获取监控会话对象
+
+在 Android 和 iOS 上，登录成功后，均可通过 `TXIoTEngine` 单例实例调用 `getMonitorSession()` 获取监控会话对象 `TXIoTMonitorSession`，无需为每个设备单独创建。
+
+> **警告：**
+> 监控会话对象为单例，同一时刻只存在一个监控会话。若已有会话正在运行中（已调用 startSession 且尚未 stopSession），再次调用 startSession 会被直接忽略，不会打断或切换已有会话；无需也不能重复获取多个会话实例。
+>
+
+##### **与视频通话的优先级关系：**
+
+实时监控的优先级低于视频通话。若设备当前正处于实时监控拉流状态，应用端对该设备发起视频通话时，视频通话会打断并抢占实时监控的拉流，监控会话会被中断（。
+
+## **注册**监听回调
+
+监控会话的状态变化与错误均通过监听接口返回。**请在调用** startSession **之前完成监听注册**，避免错过 `onSessionEstablished` 等早期回调。
+
+|方法|说明|
+|---------|---------|
+|addListener|添加监控会话状态与错误监听器，回调接口定义见 监控事件回调（iOS：`addDelegate`）。|
+|removeListener|移除监控会话监听器（iOS：`removeDelegate`）。|
+
+【Android】
+``` java
+TXIoTMonitorSessionListener monitorListener = new TXIoTMonitorSessionListener() {
+    @Override
+    public void onSessionEstablished() {
+        // 会话建立成功，可开始播放画面
+    }
+
+    // 其他回调...
+};
+
+session.addListener(monitorListener);
+```
+
+【iOS】
+``` objectivec
+@interface ViewController () <TXIoTMonitorSessionDelegate>
+@end
+
+@implementation ViewController
+
+- (void)onSessionEstablished {
+    // 会话建立成功
+}
+
+- (void)onError:(NSInteger)channelId
+      errorCode:(TXIoTErrorCode)errorCode
+   errorMessage:(NSString *)errorMessage {
+    // 发生错误，统一处理错误码与提示
+}
+
+@end
+
+// 注册代理
+[session addDelegate:self];
+// 退出时注销
+// [session removeDelegate:self];
+```
+
+## 开始与停止监控
+
+通过 startSession 与目标设备建立监控会话，会话建立成功后即可播放实时画面。结束监控时调用 stopSession 释放资源。
+
+|方法|说明|
+|---------|---------|
+|startSession|与目标设备建立监控会话，`deviceId`（TXIoTDeviceId）为目标设备标识。|
+|stopSession|停止当前监控会话并释放资源。|
+
+【Android】
+``` java
+TXIoTMonitorSession session = TXIoTEngine.getInstance(context).getMonitorSession();
+if (session == null) {
+    // SDK 未登录或登录已过期，请先完成登录
+    return;
+}
+// 监听已在“监听会话状态与错误回调”一节注册，此处直接开始监控
+
+// 构造目标设备标识
+TXIoTDeviceId deviceId = new TXIoTDeviceId();
+deviceId.productId = "已绑定到当前账户的 productId";
+deviceId.deviceName = "已绑定到当前账户的 deviceName";
+
+// 开始监控
+session.startSession(deviceId);
+
+// 结束时停止监控
+session.stopSession();
+```
+
+【iOS】
+``` objectivec
+TXIoTMonitorSession *session = [[TXIoTEngine getInstance] getMonitorSession];
+if (session == nil) {
+    // SDK 未登录或登录已过期，请先完成登录
+    return;
+}
+// 监听已在“监听会话状态与错误回调”一节注册，此处直接开始监控
+
+// 构造目标设备标识
+TXIoTDeviceId *deviceId = [[TXIoTDeviceId alloc] init];
+deviceId.productId = @"已绑定到当前账户的 productId";
+deviceId.deviceName = @"已绑定到当前账户的 deviceName";
+
+// 开始监控
+[session startSession:deviceId];
+
+// 结束时停止监控
+[session stopSession];
+```
+
+## 播放设备实时画面
+
+通过 startRemoteView 为指定通道设置渲染视图并播放实时音视频。您可以**在调用** startSession **之前**就调用 startRemoteView 设置好渲染视图。
+
+|方法|说明|
+|---------|---------|
+|startRemoteView|在指定视图播放 `channelId` 通道的实时画面，`streamType` 为码流类型（取值见「数据结构体」中的 TXIoTStreamType）。`channelId` 表示设备的视频通道，每个通道对应这个设备的一个摄像头，单通道设备使用 `0`。|
+|stopRemoteView|停止播放 `channelId` 通道的实时画面。|
+
+【Android】
+``` java
+// remoteView 为布局中的 TXCloudVideoView
+TXCloudVideoView remoteView = findViewById(R.id.remote_view);
+
+// 开始播放0号通道高清流
+int channelId = 0; // channelId 表示设备的视频通道，需要与设备端的通道 Id 对齐，单通道设备使用 0
+TXIoTStreamType streamType = TXIoTStreamType.HD; // 需要查看的视频清晰度，SDK 会将该信息同步给设备端
+session.startRemoteView(channelId, streamType, remoteView);
+
+// 停止播放0号通道
+session.stopRemoteView(channelId);
+```
+
+【iOS】
+``` objectivec
+// remoteView 为布局中的 UIView
+UIView *remoteView = self.remoteVideoView;
+
+// 开始播放0号通道高清流
+NSInteger channelId = 0; // channelId 表示设备的视频通道，需要与设备端的通道 Id 对齐，单通道设备使用 0
+TXIoTStreamType streamType = TXIoTStreamTypeHD; // 需要查看的视频清晰度，SDK 会将该信息同步给设备端
+// 开始播放高清流
+[session startRemoteView:channelId
+              streamType:streamType
+                    view:remoteView];
+
+// 停止播放
+[session stopRemoteView:0];
+```
+
+## 切换视频清晰度
+
+查看监控期间，应用端可动态切换通道画面的清晰度（高清 HD / 流畅 SD）。切换通过 switchRemoteStream 完成，无需重新建立会话；应用端切换后，设备端会收到 `on_monitor_switch` 回调并推送对应清晰度的视频流（设备端处理逻辑见 切换清晰度）。
+
+> **注意：**
+> 不同清晰度可能对应不同的计费标准，请确保应用端实际调用的清晰度与用户购买的套餐一致，避免因清晰度与计费套餐不匹配引发计费争议。
+>
+
+### 接口说明
+
+|方法|说明|
+|---------|---------|
+|switchRemoteStream|将 `channelId` 通道的视频流切换为指定清晰度，`streamType` 取值见枚举类型 TXIoTStreamType。|
+
+### 调用示例
+
+【Android】
+``` java
+// 切换为流畅流
+session.switchRemoteStream(0, TXIoTMonitorSession.TXIoTStreamType.SD);
+// 切换为高清流
+session.switchRemoteStream(0, TXIoTMonitorSession.TXIoTStreamType.HD);
+```
+
+【iOS】
+``` objectivec
+// 切换为流畅流
+[session switchRemoteStream:0 streamType:TXIoTStreamTypeSD];
+// 切换为高清流
+[session switchRemoteStream:0 streamType:TXIoTStreamTypeHD];
+```
+
+## 音频控制
+
+监控过程中可静音远端音频。通过 muteRemoteAudio（单通道）与 muteAllRemoteAudio（全部通道）控制远端音频播放。
+
+|方法|说明|
+|---------|---------|
+|muteRemoteAudio|`mute` 为 `true` 时静音指定通道的远端音频。|
+|muteAllRemoteAudio|一键静音/恢复所有通道的远端音频。|
+
+【Android】
+``` java
+// 远端音频控制
+session.muteRemoteAudio(0, true);
+session.muteAllRemoteAudio(false);
+
+```
+
+【iOS】
+``` objectivec
+// 远端音频控制
+[session muteRemoteAudio:0 mute:YES];
+[session muteAllRemoteAudio:NO];
+
+```
+
+## 状态与回调通知
+
+监控会话通过监听接口（Android：`TXIoTMonitorSessionListener，`iOS：`TXIoTMonitorSessionDelegate`）回调状态与错误，回调接口如下：
+
+|回调|触发时机|关键参数|
+|---------|---------|---------|
+|`onSessionEstablished`|监控会话建立成功。|无。|
+|`onSessionReconnecting`|会话中断，正在重连。|无。|
+|`onSessionRecovery`|会话重连成功。|无。|
+|`onRemoteStreamAvailable`|远端音视频流可用状态变化。|`channelId, available`|
+|`onRenderFirstFrame`|指定通道首帧已渲染。|`channelId`|
+|`onPlayStateChanged`|播放状态变化。|`channelId, state`（PLAYING / LOADING / STOPPED）|
+|`onError`|会话或某通道发生错误。|`channelId, errCode, errMsg`|
+
+> **注意：**
+> 会话连接中断时会触发 `onSessionReconnecting`，SDK 会自动尝试重连；重连成功触发 `onSessionRecovery`，无需业务层主动重建会话。若重连持续失败，最终会通过 `onError` 回调错误。
+>
+
+## 错误处理
+
+监控会话的所有错误均通过 `onError` 回调错误码与错误信息。常见错误码如下，Android 与 iOS 命名不同，请按所用平台查看：
+
+完整错误码定义见 TXIoTErrorCode。
+
+【Android】
+
+|错误码|说明|建议处理方式|
+|---------|---------|---------|
+|`ERR_INVALID_PARAMETER`|参数不合法|检查 `deviceId`、`channelId`、路径等参数是否为空或格式错误。|
+|`ERR_INVALID_ACCESS_TOKEN`|登录凭证无效|重新登录 SDK 后再发起监控。|
+|`ERR_RATE_LIMITED`|请求被限频|降低调用频率后重试。|
+|`ERR_UNAUTHORIZED_OPERATION`|当前用户无权限|确认目标设备已绑定到当前账户（见前提条件）。|
+|`ERR_DEVICE_NOT_EXIST`|设备不存在|确认 `deviceId` 是否正确、设备是否已绑定。|
+|`ERR_DEVICE_OFFLINE`|设备离线|确认设备在线后重试。|
+|`ERR_SPEAKER_START_FAIL`|扬声器启动失败|检查音频输出设备是否正常。|
+|`ERR_DEVICE_SWITCH_TO_VOIP`|设备已切换到 VoIP 通话|结束通话或等待通话结束后再发起监控。|
+
+【iOS】
+
+|错误码|数值|说明|建议处理方式|
+|---------|---------|---------|---------|
+|`TXIoTErrorCodeInvalidParameter`|-2|参数不合法。|检查 `deviceId`、`channelId`、路径等参数是否为空或格式错误。|
+|`TXIoTErrorCodeInvalidAccessToken`|-3|登录凭证无效。|重新登录 SDK 后再发起监控。|
+|`TXIoTErrorCodeRateLimited`|-4|请求被限频。|降低调用频率后重试。|
+|`TXIoTErrorCodeUnauthorizedOperation`|-5|当前用户无权限。|确认目标设备已绑定到当前账户（见 前提条件）。|
+|`TXIoTErrorCodeDeviceNotExist`|-1009|设备不存在。|确认 `deviceId` 是否正确、设备是否已绑定。|
+|`TXIoTErrorCodeDeviceOffline`|-1010|设备离线。|确认设备在线后重试。|
+|`TXIoTErrorCodeSpeakerStartFail`|-2006|扬声器启动失败。|检查音频输出设备是否正常。|
+|`TXIoTErrorCodeDeviceSwitchToVoIP`|-2010|设备已切换到 VoIP 通话。|结束通话或等待通话结束后再发起监控。|
+
+## 下一步：高级功能
+
+完成基础接入后，您可以进一步接入以下高级功能，丰富实时监控的使用场景：
+- 云台控制： 通过 PTZ 指令控制摄像头转动、变焦，调整监控视角。
+
+- 录制与截图：本地录制监控画面，并抓取实时截图保存。
+
+- 语音对讲 ： 与设备端进行双向语音对讲。

package/resource/knowledge/iot/security-camera/monitor-playback/device-integration/android.md

@@ -0,0 +1,237 @@
+---
+product: iot
+framework:
+  - android
+types:
+  - feature
+retrievable_scope: always
+feature_domain: security-camera
+---
+
+本文将介绍设备如何在 Android 平台实现响应 APP 发起的**监控请求**、**采集并推送音视频画面**、**切换清晰度**，帮助您快速了解实时监控的功能。
+
+## 前提条件
+
+在开始之前，请您先完成 登录与注册 文档中跑通 login 登录功能。如果您已经完成，可以跳过该操作。
+
+> **说明：**
+> 监控推流依赖摄像头与麦克风采集，请确保已在 `AndroidManifest.xml` 中声明 `android.permission.CAMERA`、`android.permission.RECORD_AUDIO` 权限，并在运行时向用户申请授权。
+>
+
+## 接入步骤
+
+### 步骤 1：注册监控事件回调
+
+登录成功后，通过 `TXIoTMonitorSession.getInstance().addListener` 注册 TXIoTMonitorSession.Listener，实时监控相关的回调如下：
+
+|回调|说明|
+|---------|---------|
+|`onMonitorBegin`|APP 发起监控查看请求时触发，携带 option（清晰度等）与 `customData`（自定义数据）。|
+|`onMonitorEnd`|对端结束监控查看时触发。|
+|`onMonitorSwitch`|APP 在监控查看期间切换清晰度时触发，携带切换后的 quality（可选实现。|
+|`onPTZCommandReceived`|APP 下发云台控制指令时触发，携带 `command`（方向/变焦等）与 `speed`（速度），仅支持云台的设备需实现。|
+
+``` java
+import com.tencent.liteav.iot.TXIoTMonitorSession;
+
+TXIoTMonitorSession monitorSession = TXIoTMonitorSession.getInstance();
+
+TXIoTMonitorSession.Listener listener = new TXIoTMonitorSession.Listener() {
+    @Override
+    public void onMonitorBegin(TXIoTMonitorSession.Option option, String customData) {
+        // APP 发起监控，开启摄像头/麦克风采集推流（详见步骤 2、步骤 3）
+    }
+
+    @Override
+    public void onMonitorEnd() {
+        // APP 结束监控，关闭采集推流（详见步骤 5）
+    }
+
+    @Override
+    public void onMonitorSwitch(TXIoTMonitorSession.VideoQuality quality) {
+        // APP 切换清晰度（详见步骤 4）
+    }
+
+    @Override
+    public void onPTZCommandReceived(TXIoTMonitorSession.PTZCommand command, int speed) {
+        // 云台控制指令（可选实现）
+    }
+};
+
+monitorSession.addListener(listener);
+```
+
+### 步骤 2：响应 onMonitorBegin，开启摄像头推流
+
+在 `onMonitorBegin` 回调中，**必须**调用 openCamera 开启摄像头采集并推流，只需传入 `Option` 与用于本地预览的 `TXCloudVideoView` 即可：
+
+|接口|说明|
+|---------|---------|
+|`openCamera(Option option, TXCloudVideoView view)`|开启摄像头采集并推流，`option` 指定视频清晰度（可复用回调传入的 `option`）；`view` 为本地预览渲染控件，若无需本地预览可传 `null，`返回 `0`（`TXIoTError.SUCCESS`）表示调用成功。|
+|`closeCamera`|关闭摄像头采集与推流（。|
+
+``` java
+private TXCloudVideoView mVideoView; // 在布局中放置 <com.tencent.rtmp.ui.TXCloudVideoView/> 并获取实例
+
+@Override
+public void onMonitorBegin(TXIoTMonitorSession.Option option, String customData) {
+    // 开启摄像头采集并推流，同时在 mVideoView 上本地预览
+    int ret = TXIoTMonitorSession.getInstance().openCamera(option, mVideoView);
+    if (ret != TXIoTError.SUCCESS) {
+        Log.e(TAG, "openCamera failed: " + ret);
+    }
+
+    // 若需要音频，继续开启麦克风推流（详见步骤 3）
+    TXIoTMonitorSession.getInstance().openMicrophone();
+}
+```
+
+### 步骤 3：开启麦克风推流
+
+若监控需要音频，调用 openMicrophone 开启麦克风就可实现音频采集并推流。
+
+|接口|说明|
+|---------|---------|
+|`openMicrophone()`|开启麦克风采集并推流。|
+|`closeMicrophone`|关闭麦克风采集与推流（。|
+
+> **注意：**
+> 开启摄像头与麦克风前，请确保已获得 `CAMERA` 与 `RECORD_AUDIO` 运行时权限，否则采集会失败导致对端无画面或无声音。
+>
+
+``` java
+int ret = TXIoTMonitorSession.getInstance().openMicrophone();
+if (ret != TXIoTError.SUCCESS) {
+    Log.e(TAG, "openMicrophone failed: " + ret);
+}
+```
+
+### 步骤 4：响应 onMonitorSwitch，切换视频清晰度（可选）
+
+APP 端在监控查看期间切换清晰度时，设备端会通过 `onMonitorSwitch` 回调收到通知，携带切换后的 `quality`，在 `onMonitorSwitch` 回调中调用 switchVideoQuality 传入新的清晰度即可完成清晰度切换。`quality` 的可选取值（`TXIoTMonitorSession.VideoQuality`）如下：
+
+|取值|说明|
+|---------|---------|
+|`VideoQuality.UNKNOWN`|未知/未设置。|
+|`VideoQuality.LD`|流畅（低清晰度）。|
+|`VideoQuality.SD`|标清。|
+|`VideoQuality.HD`|高清。|
+|`VideoQuality.FHD`|超清（全高清）。|
+
+``` java
+@Override
+public void onMonitorSwitch(TXIoTMonitorSession.VideoQuality quality) {
+    int ret = TXIoTMonitorSession.getInstance().switchVideoQuality(quality);
+    if (ret != TXIoTError.SUCCESS) {
+        Log.e(TAG, "switchVideoQuality failed: " + ret);
+    }
+}
+```
+
+### 步骤 5：响应 onMonitorEnd，关闭采集推流
+
+对端结束监控查看时触发 `onMonitorEnd`，此时应关闭摄像头与麦克风，停止采集推流：
+``` java
+@Override
+public void onMonitorEnd() {
+    TXIoTMonitorSession.getInstance().closeCamera();
+    TXIoTMonitorSession.getInstance().closeMicrophone();
+}
+```
+
+## 示例代码
+
+以下示例展示在一个 Activity 中完成监听注册与监控推流的完整流程，设备登录与初始化。
+``` java
+package com.example.iotdemo;
+
+import android.os.Bundle;
+import android.util.Log;
+import androidx.annotation.Nullable;
+import androidx.appcompat.app.AppCompatActivity;
+
+import com.tencent.liteav.iot.TXIoTError;
+import com.tencent.liteav.iot.TXIoTMonitorSession;
+import com.tencent.rtmp.ui.TXCloudVideoView;
+
+public class MonitorActivity extends AppCompatActivity {
+
+    private static final String TAG = "MonitorActivity";
+
+    private TXIoTMonitorSession mMonitorSession;
+    private TXCloudVideoView mVideoView;
+
+    private final TXIoTMonitorSession.Listener mListener = new TXIoTMonitorSession.Listener() {
+        @Override
+        public void onMonitorBegin(TXIoTMonitorSession.Option option, String customData) {
+            Log.i(TAG, "onMonitorBegin, customData=" + customData);
+            // 开启摄像头采集并推流，同时本地预览
+            int ret = mMonitorSession.openCamera(option, mVideoView);
+            if (ret != TXIoTError.SUCCESS) {
+                Log.e(TAG, "openCamera failed: " + ret);
+            }
+            // 开启麦克风采集并推流
+            ret = mMonitorSession.openMicrophone();
+            if (ret != TXIoTError.SUCCESS) {
+                Log.e(TAG, "openMicrophone failed: " + ret);
+            }
+        }
+
+        @Override
+        public void onMonitorSwitch(TXIoTMonitorSession.VideoQuality quality) {
+            Log.i(TAG, "onMonitorSwitch, quality=" + quality);
+            int ret = mMonitorSession.switchVideoQuality(quality);
+            if (ret != TXIoTError.SUCCESS) {
+                Log.e(TAG, "switchVideoQuality failed: " + ret);
+            }
+        }
+
+        @Override
+        public void onMonitorEnd() {
+            Log.i(TAG, "onMonitorEnd");
+            mMonitorSession.closeCamera();
+            mMonitorSession.closeMicrophone();
+        }
+
+        @Override
+        public void onPTZCommandReceived(TXIoTMonitorSession.PTZCommand command, int speed) {
+            Log.i(TAG, "onPTZCommandReceived, command=" + command + ", speed=" + speed);
+            // 仅支持云台的设备需实现，驱动云台电机执行对应动作
+        }
+    };
+
+    @Override
+    protected void onCreate(@Nullable Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_monitor);
+        mVideoView = findViewById(R.id.video_view);
+
+        // 前提：SDK 已完成初始化并登录成功（参见「登录与注册」）
+        mMonitorSession = TXIoTMonitorSession.getInstance();
+        mMonitorSession.addListener(mListener);
+
+        Log.i(TAG, "monitor session ready, waiting for monitor request from app...");
+    }
+
+    @Override
+    protected void onDestroy() {
+        // 释放资源
+        mMonitorSession.closeCamera();
+        mMonitorSession.closeMicrophone();
+        mMonitorSession.removeListener(mListener);
+        super.onDestroy();
+    }
+}
+```
+
+## 常见问题
+
+|现象|排查建议|
+|---------|---------|
+|发起监控查看后，设备端未收到 `onMonitorBegin`|确认设备已成功登录；确认已通过 `addListener` 注册监听器且未在收到回调前被 `removeListener` 移除。|
+|APP 端看不到监控画面|确认已在 `onMonitorBegin` 中调用 `openCamera` 且返回 `TXIoTError.SUCCESS`；确认已获得 `CAMERA` 运行时权限；确认摄像头未被其他应用占用。|
+|APP 端听不到声音|确认已调用 `openMicrophone` 且返回 `TXIoTError.SUCCESS`；确认已获得 `RECORD_AUDIO` 运行时权限。|
+|切换清晰度后，设备端未收到 `onMonitorSwitch`|确认设备已成功登录且监听器已注册；确认监控会话已建立（`onMonitorBegin` 已触发）。|
+|收到 `onMonitorSwitch` 回调但画面清晰度未变化|确认在回调中调用了 `switchVideoQuality` 且返回 `TXIoTError.SUCCESS`；确认传入的 `quality` 与回调携带的值一致。|
+|监控结束后摄像头/麦克风仍被占用|确认在 `onMonitorEnd` 回调及页面销毁（`onDestroy`）时调用了 `closeCamera` 与 `closeMicrophone` 释放采集资源。|
+