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

package/resource/knowledge/iot/security-camera/recording-and-snapshot.md

@@ -0,0 +1,182 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: security-camera
+---
+
+本文将介绍安防监控场景下的**录制与截图**功能。录制与截图为纯应用端能力：应用端对正在拉取的监控画面进行截图或本地录制，**设备端无需接入任何工作**。
+
+## 应用端接入
+
+### 截图
+
+在查看监控（startRemoteView 成功）期间，调用 takeSnapshot 对指定通道的当前画面截图，截图结果通过 `onSnapshotComplete` 回调返回。
+
+#### 接口说明
+
+|方法 / 回调|说明|
+|---------|---------|
+|takeSnapshot|对 `channelId` 通道的当前画面发起截图。|
+|`onSnapshotComplete`|截图完成回调，返回 `channelId`、图片对象与错误码。|
+
+#### 调用示例
+
+【Android】
+``` java
+// 发起截图
+session.takeSnapshot(0);
+
+// 在 TXIoTMonitorSessionListener 中接收结果
+@Override
+public void onSnapshotComplete(int channelId, Bitmap image, int errCode) {
+    if (errCode == 0 && image != null) {
+        // 保存或展示截图
+        saveBitmapToAlbum(image);
+    } else {
+        Log.e(TAG, "snapshot failed: " + errCode);
+    }
+}
+```
+
+【iOS】
+``` objectivec
+// 发起截图
+[session takeSnapshot:0];
+
+// 在 TXIoTMonitorSessionDelegate 中接收结果
+- (void)onSnapshotComplete:(int)channelId image:(UIImage *)image errCode:(int)errCode {
+    if (errCode == 0 && image) {
+        // 保存或展示截图
+        UIImageWriteToSavedPhotosAlbum(image, nil, nil, nil);
+    } else {
+        NSLog(@"snapshot failed: %d", errCode);
+    }
+}
+```
+
+【小程序】
+``` typescript
+// 发起截图
+session.takeSnapshot(0);
+
+// 在 TXIoTMonitorSessionListener 中接收结果
+session.addListener({
+  onSnapshotComplete(channelId: number, imagePath?: string) {
+    if (imagePath) {
+      // 截图成功，imagePath 为图片文件路径
+      // 保存或展示截图
+      wx.saveImageToPhotosAlbum({
+        filePath: imagePath,
+        success: () => wx.showToast({ title: '已保存到相册' }),
+        fail: () => wx.showToast({ title: '保存失败', icon: 'none' }),
+      });
+    } else {
+      // 截图失败（imagePath 为空/undefined）
+      console.error(`snapshot failed, channelId=${channelId}`);
+    }
+  },
+});
+```
+
+### 本地录制
+
+在监控查看期间，调用 startLocalRecording 将当前通道画面录制为本地视频文件，调用 stopLocalRecording 结束录制。录制状态通过 `onLocalRecordBegin` / `onLocalRecording` / `onLocalRecordComplete` 三个回调返回。
+
+#### 接口说明
+
+|方法 / 回调|说明|
+|---------|---------|
+|startLocalRecording|开始本地录制，参数为 TXIoTLocalRecordingParams。|
+|stopLocalRecording|结束本地录制。|
+|`onLocalRecordBegin`|录制开始回调，返回 `errCode` 与录制文件路径。|
+|`onLocalRecording`|录制中进度回调，每秒钟回调一次已录制时长 `durationMs` 与文件路径。|
+|`onLocalRecordComplete`|录制结束回调，返回 `errCode` 与最终录制文件路径。|
+
+#### 调用示例
+
+【Android】
+``` java
+// 开始录制
+TXIoTLocalRecordingParams params = new TXIoTLocalRecordingParams();
+params.channelId = 0;
+params.outputPath = getExternalFilesDir(null) + "/record.mp4";
+session.startLocalRecording(params);
+
+// 结束录制
+session.stopLocalRecording();
+
+// 录制状态回调（TXIoTMonitorSessionListener）
+@Override
+public void onLocalRecordBegin(int errCode, String storagePath) { }
+
+@Override
+public void onLocalRecording(long durationMs, String storagePath) { }
+
+@Override
+public void onLocalRecordComplete(int errCode, String storagePath) {
+    if (errCode == 0) {
+        // 录制成功，storagePath 为最终文件路径
+    }
+}
+```
+
+【iOS】
+``` objectivec
+// 开始录制
+TXIoTLocalRecordingParams *params = [[TXIoTLocalRecordingParams alloc] init];
+params.channelId = 0;
+params.outputPath = [NSTemporaryDirectory() stringByAppendingPathComponent:@"record.mp4"];
+[session startLocalRecording:params];
+
+// 结束录制
+[session stopLocalRecording];
+
+// 录制状态回调（TXIoTMonitorSessionDelegate）
+- (void)onLocalRecordBegin:(int)errCode storagePath:(NSString *)storagePath { }
+
+- (void)onLocalRecording:(int64_t)durationMs storagePath:(NSString *)storagePath { }
+
+- (void)onLocalRecordComplete:(int)errCode storagePath:(NSString *)storagePath {
+    if (errCode == 0) {
+        // 录制成功，storagePath 为最终文件路径
+    }
+}
+```
+
+【小程序】
+
+> **说明：**
+> 小程序不支持本地录制
+>
+
+### 错误处理
+
+录制与截图涉及本地文件写入，以下错误码在录制或截图过程中可能返回，完整错误码定义见 TXIoTErrorCode。
+
+【Android】
+
+|错误码|说明|建议处理方式|
+|---------|---------|---------|
+|`ERR_RECORD_DURATION_TOO_SHORT`|录像时长过短。|过短的录像可忽略。|
+|`ERR_FILE_PATH_UNWRITABLE`|文件路径不可写。|确认保存目录存在且有写入权限。|
+|`ERR_FILE_PATH_ALREADY_EXIST`|文件已存在。|使用新的文件路径，避免覆盖已有文件。|
+
+【iOS】
+
+|错误码|数值|说明|建议处理方式|
+|---------|---------|---------|---------|
+|`TXIoTErrorCodeRecordDurationTooShort`|-2007|录像时长过短。|过短的录像可忽略。|
+|`TXIoTErrorCodeFilePathUnwritable`|-2008|文件路径不可写。|确认保存目录存在且有写入权限。|
+|`TXIoTErrorCodeFilePathAlreadyExist`|-2009|文件已存在。|使用新的文件路径，避免覆盖已有文件。|
+
+## 常见问题
+
+|现象|排查建议|
+|---------|---------|
+|`onSnapshotComplete` 返回非 0 错误码。|确认调用 takeSnapshot 时该通道正在拉流（startRemoteView 已成功且画面已渲染），无画面时无法截图。|
+|录制文件无法生成或打开。|确认 `outputPath` 所在目录已存在且应用有写入权限。|
+|录制过程中应用退到后台后录制中断。|本地录制依赖持续拉流，应用退后台被系统回收会中断录制，建议在退后台前自动停止录制。|

package/resource/knowledge/iot/security-camera/voice-intercom.md

@@ -0,0 +1,174 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: security-camera
+---
+
+本文将介绍设备如何实现实时监控场景下的**语音对讲**功能（设备端与 APP 进行语音对话）。
+
+## 应用端接入
+
+语音对讲需要设备端与应用端协同：设备端负责音频的采集与播放（见下文 设备端接入），应用端则在查看监控期间开启本地麦克风采集，将 APP 语音传输给设备端。如需双向画面，还可同时开启本地摄像头。
+
+> **注意：**
+> 开启本地麦克风与摄像头前，请确保已在工程中申请并获取麦克风、摄像头权限，否则 startLocalAudio / startLocalVideo 会返回 `ERR_MIC_NOT_AUTHORIZED` / `ERR_CAMERA_NOT_AUTHORIZED` 等错误码。
+>
+
+### 接口说明
+
+|方法|说明|
+|---------|---------|
+|startLocalAudio|开始采集、传输本地麦克风音频。|
+|stopLocalAudio|停止采集、传输本地麦克风音频。|
+|muteLocalAudio|`mute` 为 `true` 时静音本地麦克风。|
+|startLocalVideo|开始采集、传输本地摄像头画面，`view` 为本地渲染视图，编码参数为 TXIoTVideoEncoderParams。|
+|stopLocalVideo|停止采集、传输本地摄像头画面。|
+
+### 调用示例
+
+【Android】
+``` java
+// 本地麦克风（对讲）
+session.startLocalAudio();
+session.muteLocalAudio(false);
+// session.stopLocalAudio();
+
+// 本地摄像头（可选，用于双向视频）
+TXCloudVideoView localView = findViewById(R.id.local_view);
+TXIoTVideoEncoderParams params = new TXIoTVideoEncoderParams();
+params.resolution = TXIoTVideoResolution.RESOLUTION_640_360;
+session.startLocalVideo(localView, params);
+// session.stopLocalVideo();
+```
+
+【iOS】
+``` objectivec
+// 本地麦克风（对讲）
+[session startLocalAudio];
+[session muteLocalAudio:NO];
+// [session stopLocalAudio];
+
+// 本地摄像头（可选，用于双向视频）
+UIView *localView = self.localVideoView;
+TXIoTVideoEncoderParams *params = [[TXIoTVideoEncoderParams alloc] init];
+params.resolution = TXIoTVideoResolution_640_360;
+[session startLocalVideo:localView videoEncoderParams:params];
+// [session stopLocalVideo];
+```
+
+【小程序】
+``` typescript
+// ---- 本地麦克风（对讲）----
+session.startLocalAudio();
+session.muteLocalAudio(false);
+// session.stopLocalAudio();
+
+// ---- 本地摄像头（可选，用于双向视频）----
+// WXML: <iot-pusher component-id="local-pusher" />  由 SDK 自动渲染，
+const params = new TXIoTVideoEncoderParams(TXIoTVideoResolution.RESOLUTION_640_360);
+session.startLocalVideo(params);
+// session.stopLocalVideo();
+```
+
+### 错误处理
+
+语音对讲需开启本地麦克风与摄像头，以下错误码在对讲过程中可能返回，完整错误码定义见 TXIoTErrorCode。
+
+【Android】
+
+|错误码|说明|建议处理方式|
+|---------|---------|---------|
+|`ERR_CAMERA_START_FAIL`|摄像头启动失败。|检查设备摄像头是否被占用或硬件异常。|
+|`ERR_CAMERA_NOT_AUTHORIZED`|摄像头权限未授权。|在工程中申请并获取摄像头权限。|
+|`ERR_CAMERA_OCCUPY`|摄像头被占用。|停止其他占用摄像头的功能后再试。|
+|`ERR_MIC_START_FAIL`|麦克风启动失败。|检查麦克风是否被占用或硬件异常。|
+|`ERR_MIC_NOT_AUTHORIZED`|麦克风权限未授权。|在工程中申请并获取麦克风权限。|
+|`ERR_MIC_OCCUPY`|麦克风被占用。|停止其他占用麦克风的功能后再试。|
+
+【iOS】
+
+|错误码|数值|说明|建议处理方式|
+|---------|---------|---------|---------|
+|`TXIoTErrorCodeCameraStartFail`|-2000|摄像头启动失败。|检查设备摄像头是否被占用或硬件异常。|
+|`TXIoTErrorCodeCameraNotAuthorized`|-2001|摄像头权限未授权。|在工程中申请并获取摄像头权限。|
+|`TXIoTErrorCodeCameraOccupy`|-2002|摄像头被占用。|停止其他占用摄像头的功能后再试。|
+|`TXIoTErrorCodeMicStartFail`|-2003|麦克风启动失败。|检查麦克风是否被占用或硬件异常。|
+|`TXIoTErrorCodeMicNotAuthorized`|-2004|麦克风权限未授权。|在工程中申请并获取麦克风权限。|
+|`TXIoTErrorCodeMicOccupy`|-2005|麦克风被占用。|停止其他占用麦克风的功能后再试。|
+
+【小程序】
+
+|错误码|数值|说明|建议处理方式|
+|---------|---------|---------|---------|
+|`CameraStartFail`|-2000|摄像头启动失败。|检查设备摄像头是否被占用或硬件异常。|
+|`CameraNotAuthorized`|-2001|摄像头权限未授权。|在工程中申请并获取摄像头权限。|
+|`CameraOccupy`|-2002|摄像头被占用。|停止其他占用摄像头的功能后再试。|
+|`MicStartFail`|-2003|麦克风启动失败。|检查麦克风是否被占用或硬件异常。|
+|`MicNotAuthorized`|-2004|麦克风权限未授权。|在工程中申请并获取麦克风权限。|
+|`MicOccupy`|-2005|麦克风被占用。|停止其他占用麦克风的功能后再试。|
+
+## 设备端接入
+
+### 接入步骤
+
+#### 步骤 1：注册 on_audio_frame_received 回调
+
+调用 `tc_iot_av_init` 注册 `tc_iot_av_observer_s` 时，为 `on_audio_frame_received` 赋值。APP 端在查看监控期间发起语音对讲时，设备端会通过该回调持续收到音频帧：
+``` c
+#include "tc_iot_av.h"
+
+static void on_audio_frame_received(const tc_iot_audio_frame *frame);
+
+tc_iot_av_observer_s observer;
+memset(&observer, 0, sizeof(observer));
+observer.on_audio_frame_received = on_audio_frame_received;
+
+tc_iot_error_e av_rc = tc_iot_av_init(&observer);
+if (av_rc != TC_IOT_ERR_SUCCESS) {
+    printf("tc_iot_av_init failed: %d\n", av_rc);
+}
+```
+
+#### 步骤 2：解析音频帧
+
+`on_audio_frame_received` 回调携带的 `tc_iot_audio_frame` 结构体字段如下：
+
+|字段|说明|
+|---------|---------|
+|`codec`|音频编码格式，固定为 `TC_IOT_AUDIO_CODEC_PCM`。|
+|`sample_rate`|采样率，如 `TC_IOT_AUDIO_SAMPLE_RATE_16000`。|
+|`channels`|声道数，`TC_IOT_AUDIO_CHANNEL_MONO`（单声道）或 `TC_IOT_AUDIO_CHANNEL_STEREO`（双声道）。|
+|`frame_duration_ms`|单帧时长（毫秒）。|
+|`data` / `data_size`|PCM 音频数据指针与长度，可直接送入播放器。|
+|`pts_ms`|帧时间戳（毫秒）。|
+
+> **说明：**
+> 目前 `codec` 固定为 `TC_IOT_AUDIO_CODEC_PCM`，无需考虑其他编码格式。
+>
+
+#### 步骤 3：将音频数据送入播放器
+
+将 `data` 指向的 PCM 数据写入设备的本地播放器（扬声器）完成播放。播放器接口由具体硬件平台提供，以下以自定义 `speaker_play_pcm` 函数表示，请替换为您设备实际的音频输出接口：
+``` c
+// speaker_play_pcm 由业务自行实现，对接具体硬件平台的音频输出接口
+extern void speaker_play_pcm(const uint8_t *pcm_data, size_t pcm_size);
+
+static void on_audio_frame_received(const tc_iot_audio_frame *frame) {
+    if (!frame || !frame->data || frame->data_size == 0) {
+        return;
+    }
+    speaker_play_pcm(frame->data, frame->data_size);
+}
+```
+
+### 常见问题
+
+|现象|排查建议|
+|---------|---------|
+|开启语音对讲后，设备端未收到 `on_audio_frame_received`。|确认设备已成功登录且 `tc_iot_av_init` 调用成功；确认 `on_audio_frame_received` 已正确赋值（未被 `memset` 清零覆盖）；确认监控会话已建立（`on_monitor_begin` 已触发）。|
+|设备端收到回调但播放无声音。|确认已正确对接本地音频播放硬件接口；检查 `sample_rate`、`channels` 与播放器初始化参数是否一致。|
+|播放声音卡顿或有杂音。|检查 `on_audio_frame_received` 内是否有耗时阻塞操作（如同步写文件、网络请求等），建议将数据快速拷贝到缓冲队列后异步播放，避免阻塞回调影响后续帧接收。|

package/resource/knowledge/iot/smart-vision/serviceoverview.md

@@ -0,0 +1,114 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: smart-vision
+---
+
+## 服务概述
+
+TWeSee AI 视觉引擎是腾讯云面向消费电子与泛安防行业推出的端到端智能视觉解决方案。产品基于腾讯自研的消费电子行业模型，通过深度场景化微调，为智能摄像头、智能门锁、宠物看护、老人陪伴、儿童看护等终端设备提供从“看见”到“看懂”的深度内容理解能力。
+
+**服务对象**：TWeSee 主要面向消费电子品牌商、物联网设备制造商、智能硬件开发者，帮助客户快速集成 AI 视觉能力，实现产品智能化升级与 C 端增值服务变现。
+
+**核心价值**：开箱即用地提供目标检测、事件识别、视频摘要、智能搜索、视频浓缩等核心能力，相比通用大模型在垂直场景的准确率更高，开发集成周期缩短为1-3天，适合中国市场及海外市场。
+
+## 产品功能
+
+### TWeSee 的核心三大功能
+
+视觉理解、智能搜索和视频浓缩的介绍如下：
+| 功能 | 功能分类 | 介绍 |  |
+| --- | --- | --- | --- |
+| 视觉理解 | 视频理解 | 视频摘要 | 对视频进行 AI 分析，生成自然语言描述（如“快递员在门口放下包裹”）。<br>支持同时检测关键目标（人、车、猫、狗、包裹、火焰等）及标签事件（有人吸烟、老人跌倒、明火燃烧等），并把检测结果融入描述。 |
+| 视频事件检测 | 支持单独对视频进行关键目标和事件检测，并输出检测结果。 |  |  |
+| 图片理解 | 图片摘要 | 对图片进行 AI 分析，生成自然语言描述。<br>支持同时检测关键目标及标签事件，并把检测结果融入描述。 |  |
+| 图片事件检测 | 支持单独对图片进行关键目标和事件检测，并输出检测结果。 |  |  |
+| 人脸检测 | 人脸识别 | 客户可以开启人脸识别开关，导入人脸图像及配置对应的名称，后续可输出含有相关人脸的结果。 |  |
+| 总结 | 摘要日总结 | 每日对前一天的摘要、检测文字内容进行总结，输出前一天的完整总结。 |  |
+| 智能搜索 | - | - | 支持用户用自然语言直接搜索海量云存内容（如“昨天穿红衣服的女人”、“猫咪捣乱”），快速定位相关视频/图片片段。 |
+| 视频浓缩 | - | - | 把每天海量视频信息进行 AI 处理，自动剪辑和倍速处理，浓缩成1-2分钟的精彩短视频，用户可自定义需要浓缩成短视频的的目标，如：人、车、宠物。 |
+
+以上功能全都包含在 TWeSee 包月套餐中。部分内容，如视频摘要、图片摘要、人脸识别等服务，可按调用次数收费。接入方式。
+
+图片/视频增强、图片生成视频等更多 AI 功能即将推出，敬请关注。
+
+### 应用场景
+
+|场景|视觉理解|智能搜索|视频浓缩|
+|---------|---------|---------|---------|
+|看家护院|陌生人/车辆/翻越实时检测；按人/车/事件生成摘要。|"昨天上午谁在门口逗留"一键定位。|将全天监控浓缩为3-5分钟，过滤无动静时段。|
+|宠物看护|抓挠/进食/破坏等行为检测；区分猫/狗动作摘要。|"上周哪天吐了"关键词直达片段。|自动剪辑宠物活跃片段，轻松查看所有爱宠精彩瞬间。|
+|婴幼儿看护|睡姿/爬行/跌倒立刻识别；实时推送防止危险。|"宝宝昨晚几点哭的"秒级回溯。|将24小时浓缩为喂养/哭闹/活动精华。|
+|老人看护|摔倒/久坐/离床/静姿等检测；可自定义事件更贴心关注老人。|"上周几次摔倒"一搜索即出结果。|滤除日常起居，仅保留异常/互动片段。|
+|商铺安防|斗殴/徘徊/吸烟/无人值守等行为检测。|"穿红衣服的顾客什么时候来的"跨天检索。|营业时段浓缩为顾客动线、高峰时段的精华。|
+|区域安全监测|越界/轨迹追踪检测；生成告警摘要。|"前天 E 区有车进入吗"跨设备搜索。|多点位视频合并浓缩，只看有人/车入侵的时段。|
+|厨房安全|烟火/燃气/明火检测；可按事故类型出摘要。|"上周哪天有明火"快速定位取证。|滤除无人时段，保留操作/异常画面精华。|
+
+### 视觉理解事件标签列表
+| 事件分类 | 标签列表 |
+| --- | --- |
+| 通用事件 | - person_enter：有人进入<br>- vehicle_entering：车辆进入<br>- vehicle_parking：车辆停靠<br>- pet：有宠物<br>- no_signal：视频画面异常（无信号等）<br>- camera_angle_abnormal：相机画面视角异常<br>- using_mobile_phone：看手机<br>- vehicle_exiting：车辆驶出 |
+| 婴儿看护 | - baby：有婴儿<br>- baby_dropping：婴儿跌落床铺<br>- person_holding_baby：有人抱起婴儿<br>- baby_rolling：婴儿翻滚<br>- baby_crying：婴儿哭闹 |
+| 儿童看护 | - child：有小孩<br>- child_falling：小孩摔倒<br>- child_entering_kitchen：小孩进入厨房<br>- child_climbing_window：小孩攀爬室内窗户<br>- child_near_water：小孩靠近水域<br>- child_playing_danger_item：小孩玩火、玩刀<br>- child_writing：小孩写作业 |
+| 老人看护 | - elderly：有老人<br>- elderly_falling：老人摔倒<br>- elderly_eating：老人用餐<br>- elderly_using_stove：老人使用灶具 |
+| 宠物看护 | - pet_eating：宠物进食<br>- pet_damaging：宠物损坏家具<br>- pet_barking：宠物吠叫<br>- pet_scratching_door：宠物挠门<br>- person_playing_with_pet：人宠互动玩耍<br>- pet_close_to_camera：宠物靠近摄像头 |
+| 看家护院 | - person_climbing_fence：有人翻围墙<br>- door_window_open：门窗被开启<br>- person_carrying_object：有人搬运物品 |
+| 商铺看管 | - person_at_cashier：有人在收银台<br>- person_taking_goods：有人拿商品<br>- person_night_moving：夜间有人移动<br>- person_entering_store：有人进入商铺<br>- staff_absent：人员离岗<br>- uniform_abnormal：工服异常 |
+| 公共安全 | - person_stealing：有人偷盗<br>- crowd：多人聚集<br>- smoking：有人吸烟<br>- safety_fire：明火<br>- safety_smoke：浓烟<br>- fireworks：有人燃放烟花爆竹<br>- knife：有人持刀具<br>- gun：有人持枪<br>- fight：有人打架<br>- hurt：有人受伤流血<br>- person_falling：人员跌倒 |
+| 养殖看护 | - person_feeding_animal：有人投喂牲畜<br>- animal_lying：有动物躺地上<br>- animal_wild_intrusion：野生动物入侵 |
+| 果园农田 | - person_picking_fruit：有人采摘果实<br>- person_carrying_bag：有人携带包裹<br>- person_entering_farm：有人进入田地 |
+| 鱼塘看管 | - fishing：有人钓鱼<br>- net_fishing：有人撒网<br>- person_carrying_fishing_gear：有人携带渔具<br>- loitering_near_water：有人岸边逗留<br>- throwing_into_water：有人投掷物品 |
+
+## 产品优势
+
+### **开箱即用**
+
+提供端到端场景化解决方案，从视频接入到结果交付的完整闭环，客户无需进行复杂二次开发，典型功能集成周期仅需1-3天，开发周期相比传统方案大幅缩短。
+
+### **垂直场景深度优化**
+
+TWeSee 针对消费物联网场景进行海量数据微调，相比通用大模型在垂直场景的准确率更高，误报率更低。
+
+### **多模态语义理解**
+
+支持图像、视频、文本多模态融合分析，实现从“看见”到“看懂”的跨越，用户可通过自然语言进行视频搜索与内容理解，交互体验显著优于传统视觉引擎。
+
+### **MoE 大模型架构**
+
+采用混合专家模型架构，支持持续迭代更新，可灵活扩展新场景、新事件类别，在保证推理速度的同时实现更高的识别准确率。
+
+### **计费方式灵活多样**
+
+有按次及包月的两种付费模式，详见 [智能视觉（TWeSee）计费说明](https://cloud.tencent.com/document/product/1081/131556)。
+
+## 使用**智能视觉服务（TWeSee）**的特别说明
+1. **本服务不得用于未经授权的大规模人群监控、侵犯个人隐私等违规用途。**
+
+2. **使用智能视觉服务（TWeSee）时，您应：**
+
+   1. **遵守《互联网信息服务深度合成管理规定》、《生成式人工智能服务管理暂行办法》等相关法律法规。**
+
+   2. **对 AI 生成的内容（如视频摘要、图片描述等）进行显著标识。**
+
+   3. **确保使用本服务处理的数据已获得相关主体的合法授权。**
+
+   4. **不得利用本服务生成违反法律法规或侵犯第三方合法权益的内容。**
+
+   5. **智能视觉服务（TWeSee）提供的视频理解、图片理解等功能，基于人工智能技术实现。我们致力于提供安全、稳定、持续的服务，以保障您的正常使用，但由于大模型技术发展的局限性，我们无法完全保证：**
+
+      1. **本服务或算法模型将符合您的实际或特定需求或目的；**
+
+      2. **本服务或算法模型百分百准确可靠、功能可用、持续稳定、不存在故障；**
+
+3. **AI 生成的内容（包括但不限于视频摘要、图片描述、事件检测结果等）仅供参考，实际结果可能因场景复杂性、数据质量、环境因素等原因而存在偏差。您不应将 AI 识别结果作为唯一决策依据，尤其是在涉及人身安全、财产保护等重要场景时，请结合其他方式进行验证。**
+
+## 相关文档
+- TWeSee 计费说明
+
+- TWeSee 接入指引
+
+- [Demo 体验链接](https://console.cloud.tencent.com/iotexplorer/v2/goto-twesee-demo)

package/resource/knowledge/iot/voice-recorder/app-demo.md

@@ -0,0 +1,99 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: voice-recorder
+---
+
+本文介绍如何编译并运行录音卡 Android Demo。完成本文步骤后，您可以验证 Demo 的基础界面、BLE 录音卡绑定、实时录音、离线文件同步，以及云端语音识别能力。
+
+## 前提条件
+
+### 环境准备
+- 安装 [Android Studio](https://developer.android.com/studio) 2025 及之后的版本。
+
+- 准备一台 Android 8.0 及以上、支持 BLE 的 arm64-v8a 真机。
+
+- 准备已实名认证的腾讯云账号，用于开通 ASR 服务。
+
+- 手机需开启蓝牙，并授予 App 蓝牙与定位权限（Android 12 及以上为「附近的设备」权限），用于扫描和绑定录音卡。
+
+### 开通 ASR 服务
+
+请参见 [TRTC AI 智能语音](https://cloud.tencent.com/document/product/647/131288)，创建应用并获取 TRTC SDKAppID 和 SDK 密钥，在后续运行时需要。
+
+控制台创建应用并获取 SDKAppID 与密钥
+
+## 下载并配置 Demo
+1. 从 GitHub 下载 [录音卡 Demo](https://github.com/Tencent-RTC/IoT_VoiceRecordingCard) 源码，或者直接在命令行运行以下命令：
+
+   ``` bash
+   git clone https://github.com/Tencent-RTC/IoT_VoiceRecordingCard.git
+   ```
+2. 通过 Android Studio 打开 `IoT_VoiceRecordingCard/android` 目录：
+
+   > **提示：**
+   >
+   > **Android Studio 推荐配置：**Demo 的 Gradle 构建要求 JDK 17，请按下述步骤将 Gradle JDK 改为17，否则首次同步会报错。
+   >
+   > 1. 打开 Android Studio 设置。
+   > - **Windows**：File > Settings
+   > - **Mac**：Android Studio > Preferences
+   > 2. 修改 Java 编译器设置。
+   > - 路径：Build, Execution, Deployment > Build Tools > Gradle
+   > - 将 Gradle JDK 改为 17（未安装时可直接选择 Android Studio 内嵌的 JetBrains Runtime 17）
+
+3. 将开通服务时获取的 SDKAppID 和 SDK 密钥填入 `android/app/src/main/java/com/recorder/client/trtc/TrtcUserSigConfig.java`：
+
+   ``` java
+   // 填入开通服务时获取的 SDKAppID 和 SDK 密钥
+   private static final int SDK_APP_ID = 0;
+   private static final String SECRET_KEY = "";
+   ```
+
+## 跑通 Demo
+
+### 步骤1：运行 Demo
+1. 开启手机开发者选项与 USB 调试（设置 > 关于手机 > 连续单击版本号7次），连接后允许调试授权。
+
+2. 等待 Gradle 首次同步完成再运行。
+
+3. 选择设备并编译和运行 Demo。
+
+   > **说明：**
+   >
+   > 本 Demo 默认集成了蓝牙能力，因此建议使用真机调试、运行 Demo。
+   >
+
+### 步骤2：扫描并绑定设备
+
+打开 App 扫描周边的录音卡设备，选择目标设备完成绑定：
+
+### 步骤3：实时 ASR 识别
+
+单击设备主页“轻点开始录音”右侧的录音按钮，进入实时 ASR 识别页面：
+
+### 步骤4：导出录音文件并转录
+
+结束录音后，先将录音文件从录音卡导出到 App，再发起云端非实时 ASR 识别，获得整段录音的完整转写结果：
+
+## 常见问题
+
+### 扫描不到录音卡设备
+
+请确认手机蓝牙已开启、App 已获得蓝牙与定位权限（Android 12 及以上为「附近的设备」权限），且录音卡已开机并处于可被发现状态。
+
+### Gradle 同步失败
+
+请确认 Gradle JDK 已设置为17（见 [下载并配置 Demo](#e8e5a4f6-bfbc-4a5e-80b5-abef26928915) 中的提示），并检查网络与代理配置后重新同步。
+
+### ASR 无识别结果
+
+请确认 `TrtcUserSigConfig.java` 中的 SDKAppID 与 SDK 密钥填写正确，且对应的应用已在控制台开通 ASR 服务。
+
+## 后续步骤
+
+跑通 Demo 后，如需将录音与语音识别能力集成到自有 App，请参见 [录音卡 Demo 源码仓库](https://github.com/Tencent-RTC/IoT_VoiceRecordingCard) 中的集成说明。