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

package/resource/knowledge/callkit/core-sdk/android/make-call.md

@@ -12,8 +12,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：集成 SDK
 1.  请在您的 **build.gradle** 文件中添加 api `"io.trtc.uikit:atomicx-core:latest.release"` 和 api `"com.tencent.imsdk:imsdk-plus:8.7.7201"` 依赖，然后执行 **Gradle Sync**。
 

package/resource/knowledge/callkit/core-sdk/flutter/answer-call.md

@@ -11,8 +11,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：集成 SDK
 
 **安装组件**：在工程的根目录下，通过命令行执行以下命令安装 [atomic_x_core](https://pub.dev/packages/atomic_x_core) 插件。
@@ -450,8 +448,6 @@ void addListener(BuildContext context) {
 
 当您完成以上 6 步后，"接听一通电话"运行效果如下：
 
-## 接入离线推送
-
 ## 定制页面
 
 **CallCoreView** 提供了完善的 UI 定制能力，支持头像及音量提示等图标的自由替换。**为助力快速集成，您可以直接从** [**Github**](https://github.com/Tencent-RTC/TUIKit_Flutter/tree/main/atomic-x/call_assets) **下载。这些图标由我们的设计师专为 TUICallKit 打造，无版权风险，可放心使用。**

package/resource/knowledge/callkit/core-sdk/flutter/make-call.md

@@ -12,8 +12,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：集成 SDK
 
 **安装组件**：在工程的根目录下，通过命令行执行以下命令安装 [atomic_x_core](https://pub.dev/packages/atomic_x_core) 插件。

package/resource/knowledge/callkit/core-sdk/flutter/offline-push.md

@@ -1,7 +1,5 @@
 本文档将指导您如何基于 [tencent_cloud_chat_push](https://pub.dev/packages/tencent_cloud_chat_push) 插件实现离线推送功能，适用于使用 AtomicXCore 进行无 UI 集成的场景。
 
-## 效果展示
-
 ## 开通服务
 
 进入 [IM 控制台 > 插件市场](https://console.cloud.tencent.com/im/plugin/TIMPush)，单击**立即购买**或**免费试用**。

package/resource/knowledge/callkit/core-sdk/ios/answer-call.md

@@ -12,8 +12,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：集成 SDK
 1. **添加 Pod 依赖：**在您项目的 `Podfile` 文件中添加 `pod 'AtomicXCore'` 依赖。
 

package/resource/knowledge/callkit/core-sdk/ios/make-call.md

@@ -12,8 +12,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：集成 SDK
 1. **添加 Pod 依赖：**在您项目的 `Podfile` 文件中添加 `pod 'AtomicXCore'` 依赖。
 
@@ -1263,8 +1261,6 @@ private func observeSelfCallStatus() {
    }
    ```
 
-### 设置离线推送参数
-
 ## 下一步
 
 恭喜您，已经完成了"拨打一通电话"，接下来，您可参考 接听第一通电话 实现接听电话功能。

package/resource/knowledge/callkit/core-sdk/ios/offline-push.md

@@ -76,8 +76,6 @@
 
 ## 功能接入
 
-### 步骤1：完成工程配置
-
 ### 步骤2: 添加依赖
 1. **添加 Pod 依赖：**在您项目的 `Podfile` 文件中添加 `pod 'TUICore'` 依赖。
 

package/resource/knowledge/callkit/core-sdk/uni-app/answer-call.md

@@ -2,8 +2,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：在当前项目中导入 AtomicXCore
 1. **安装组件**：打开 [AtomicXCore SDK](https://ext.dcloud.net.cn/plugin)，单击**下载插件并导入 HBuilderX**，选择需要集成的项目并单击**确定**。
 

package/resource/knowledge/callkit/core-sdk/uni-app/make-call.md

@@ -2,8 +2,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：在当前项目中导入 AtomicXCore
 1. **安装组件**：打开 [AtomicXCore SDK](https://ext.dcloud.net.cn/plugin)，单击**下载插件并导入 HBuilderX**，选择需要集成的项目并单击**确定**。
 

package/resource/knowledge/callkit/faq/ios.md

@@ -98,8 +98,6 @@ end
 
 **支持**，调用 [setCallingBell](https://cloud.tencent.com/document/product/647/78753#setCallingBell) 即可。
 
-### TUICallKit 是否支持后台运行？
-
 ### 如何查看 TRTC 日志？
 
 TRTC 的日志默认压缩加密，后缀为 .xlog。日志是否加密是可以通过 setLogCompressEnabled 来控制，生成的文件名里面含 C(compressed) 的就是加密压缩的，含 R(raw) 的就是明文的。

package/resource/knowledge/callkit/faq/uniapp-app.md

@@ -2,8 +2,6 @@
 
 建议您结合 [TUIPush 插件](https://cloud.tencent.com/document/product/647/105867) 实现离线唤醒。
 
-### 应用在后台时，不能自动将通话界面拉取到前台？
-
 ### 支持云端打包、本地打包，以及离线打包三种方式
 
 [TUICallKit](https://ext.dcloud.net.cn/plugin) 插件支持以下三种打包方式，前两种在 HBuilderX 开发工具中，适用于前端开发人员；离线打包适用于原生开发人员。

package/resource/knowledge/callkit/preset/miniprogram/integration.md

@@ -19,8 +19,6 @@
 
 ## 小程序开发准备
 
-### 步骤1：开通企业类小程序
-
 ### 步骤2：在小程序控制台开启实时音视频接口
 - 小程序推拉流标签使用权限暂时只开放给有限类目，[具体支持类目参见该地址](https://developers.weixin.qq.com/miniprogram/dev/component/live-pusher.html#%E7%94%B3%E8%AF%B7%E5%BC%80%E9%80%9A)。
 
@@ -143,7 +141,8 @@ xcopy node_modules\@trtc\calls-uikit-wx\ .\TUICallKit /i /e
        "navigationBarTextStyle": "black",
        "navigationStyle": "custom"
      },
-     "style": "v2"
+     "style": "v2",
+     "renderer": "webview"
    }
    ```
 2. 修改 `pages/index` 文件夹下的文件。

package/resource/knowledge/callkit/preset/miniprogram/uniapp-integration.md

@@ -19,8 +19,6 @@
 
 在使用腾讯云提供的音视频服务前，您需要前往控制台，为应用开通音视频服务。具体步骤详见 [开通服务](https://cloud.tencent.com/document/product/647/104662)。开通服务后，请记录 `SDKAppID、SecretKey`，在后续的步骤中会用到。
 
-### 开通企业类小程序
-
 ### 在小程序控制台开启实时音视频接口
 - 小程序推拉流标签使用权限暂时只开放给有限类目，[具体支持类目参见该地址](https://developers.weixin.qq.com/miniprogram/dev/component/live-pusher.html#%E7%94%B3%E8%AF%B7%E5%BC%80%E9%80%9A)。
 

package/resource/knowledge/chat/preset/ios-uikit/integration.md

@@ -297,22 +297,6 @@ func showChat(_ info: ConversationInfo) {
 
 - 如果是群聊通话邀请，被邀请者离线再上线后会自动拉取最近 30 秒内的邀请，TUIKit 会自动唤起群通话界面。
 
-#### 如何移除音视频通话功能？
-
-ChatPage 默认集成了音视频通话功能，如果你不需要音视频通话功能。可以在 步骤 3 创建聊天界面 中关闭音视频通话开关，代码如下所示：
-
-【Swift】
-``` swift
-func showChat(_ info: ConversationInfo) {
-        // 在输入配置中关闭输入面板中的视频通话和音频通话功能
-        let inputConfig = ChatMessageInputConfig(isShowVideoCall: false, isShowAudioCall: false)
-        let chatPage = ChatPage(conversation: info, messageInputConfig: inputConfig, onBack: { [weak self] in
-            self?.navigationController.popViewController(animated: true)
-        })
-        navigationController.pushViewController(chatPage, animated: true)
-    }
-```
-
 ### 上架常见问题
 
 #### 上架 App Store 时打包失败，提示 Unsupported Architectures？

package/resource/knowledge/chat/preset/react/h5/integration.md

@@ -78,7 +78,7 @@ npm create vite@latest
 
 【shell】
 ``` bash
-npm install @tencentcloud/chat-uikit-react @tencentcloud/uikit-base-component-react
+npm install @tencentcloud/chat-uikit-react @tencentcloud/uikit-base-component-react @trtc/calls-uikit-react
 ```
 
 ### 步骤2：引入组件
@@ -163,6 +163,7 @@ npm install @tencentcloud/chat-uikit-react @tencentcloud/uikit-base-component-re
    ``` typescript
    import { useState } from 'react';
    import { LoginStatus, UIKitProvider, useLoginState } from '@tencentcloud/chat-uikit-react';
+   import { TUICallKit } from '@trtc/calls-uikit-react';
    import { LoginView } from './LoginView';
    import { ChatLayout } from './ChatLayout';
    import { languageResources } from './i18n';
@@ -177,9 +178,14 @@ npm install @tencentcloud/chat-uikit-react @tencentcloud/uikit-base-component-re
      const [language, setLanguage] = useState('zh-CN');
 
      return (
-       <UIKitProvider language={language} languageResources={languageResources}>
+       <UIKitProvider theme="light" language={language} languageResources={languageResources}>
          {isLogined
-           ? <ChatLayout onChangeLanguage={setLanguage} />
+           ? (
+             <>
+               <ChatLayout onChangeLanguage={setLanguage} />
+               <TUICallKit className="call-kit" />
+             </>
+           )
            : <LoginView language={language} onChangeLanguage={setLanguage} />}
        </UIKitProvider>
      );
@@ -833,10 +839,10 @@ npm run dev
 ### 音视频通话
 
 > **说明：**
-> TUICallKit 是腾讯云推出的一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
->
+> - TUICallKit 是腾讯云推出的一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
 > 更多详细信息可参考：音视频通话-开通服务。
 >
+> - 在上面的过程中已经集成了 TUICallKit，若不需要音视频通话功能，可参考以下过程移除集成代码。
 
 1. 安装 `@trtc/calls-uikit-react` 依赖
 
@@ -882,6 +888,11 @@ npm run dev
 
    export default App;
    ```
+3. 如果不需要集成音视频通话，可以通过移除 `<TUICallKit />`、修改 MessageInputH5 组件的 `actions` 属性，来移除音视频通话的能力。
+
+   ``` typescript
+   <MessageInputH5 actions={['EmojiPicker', 'ImagePicker', 'VideoPicker', 'FilePicker']} />
+   ```
 
 ### 云端搜索
 

package/resource/knowledge/chat/preset/vue/features/conversation-list.md

@@ -274,8 +274,11 @@ const handleFilterClick = (filterType: FilterType) => {
 |PlaceholderLoadError|Component|<PlaceHolder type={PlaceHolderTypes.WRONG} />|自定义会话列表加载错误时的占位元素。|
 |filter|(conversationList: ConversationInfo[]) => ConversationInfo[]|-|用于筛选会话列表的函数。|
 |sort|(conversationList: ConversationModel[]) => ConversationModel[]|-|用于排序会话列表的函数。|
-|onConversationSelect|(conversation: ConversationInfo) => void;|-|点击会话后的回调函数，参数为所点击的会话对象。|
-|onBeforeCreateConversation|(params: CreateParams) => CreateParams;|-|创建会话前执行的自定义操作，参数为创建会话所需的参数。|
-|onConversationCreate|(conversation: ConversationInfo)  => void;|-|会话创建后的回调函数，参数为创建的会话对象。|
 |className|String|-|指定根元素类的 CSS 自定义名称。|
 |style|CSSProperties|-|指定根元素样式的自定义样式。|
+
+## Emits
+| conversation-select | (conversation: ConversationInfo) => void; | - | 点击会话后的回调函数，参数为所点击的会话对象。 |
+| --- | --- | --- | --- |
+| before-create-conversation | (params: CreateParams) => CreateParams; | - | 创建会话前执行的自定义操作，参数为创建会话所需的参数。 |
+| conversation-created | (conversation: ConversationInfo)  => void; | - | 会话创建后的回调函数，参数为创建的会话对象。 |

package/resource/knowledge/chat/preset/vue/h5/integration.md

@@ -80,7 +80,7 @@ npm create vite@latest
 
 【shell】
 ``` bash
-npm install @tencentcloud/chat-uikit-vue3 @tencentcloud/uikit-base-component-vue3
+npm install @tencentcloud/chat-uikit-vue3 @tencentcloud/uikit-base-component-vue3 @trtc/calls-uikit-vue
 ```
 
 ### 步骤2：引入组件
@@ -163,6 +163,7 @@ npm install @tencentcloud/chat-uikit-vue3 @tencentcloud/uikit-base-component-vue
    <script setup lang="ts">
    import { ref, watch } from 'vue';
    import { UIKitProvider, useLoginState } from '@tencentcloud/chat-uikit-vue3';
+   import { TUICallKit } from '@trtc/calls-uikit-vue';
    import LoginView from './LoginView.vue';
    import ChatLayout from './ChatLayout.vue';
    import { languageResources } from './i18n';
@@ -184,8 +185,10 @@ npm install @tencentcloud/chat-uikit-vue3 @tencentcloud/uikit-base-component-vue
      <UIKitProvider theme="light" :language="language" :language-resources="languageResources">
        <LoginView v-if="loginStatus !== LoginStatus.LOGINED" />
        <ChatLayout v-else />
+       <TUICallKit class="call-kit" />
      </UIKitProvider>
    </template>
+
    ```
 4. 配置登录页和聊天页面。
 
@@ -580,10 +583,10 @@ npm run dev
 ### 音视频通话
 
 > **说明：**
-> TUICallKit 是腾讯云推出的一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
->
+> - TUICallKit 是腾讯云推出的一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
 > 更多详细信息可参考：音视频通话-开通服务。
 >
+> - 在上面的过程中已经集成了 TUICallKit，若不需要音视频通话功能，可参考以下过程移除集成代码。
 
 1. 安装 @trtc/calls-uikit-vue 依赖。
 
@@ -631,7 +634,7 @@ npm run dev
    </template>
 
    ```
-3. 如果不需要集成音视频通话，可以修改 MessageInputH5 组件 actions 属性，来隐藏语音通话和视频通话的入口。
+3. 如果不需要集成音视频通话，可以通过移除 `<TUICallKit />`、修改 MessageInputH5 组件的 `actions` 属性，来移除音视频通话的能力。
 
    ``` typescript
    <MessageInputH5 class="chat-pane__input" :actions="['EmojiPicker', 'ImagePicker', 'VideoPicker', 'FilePicker']" />

package/resource/knowledge/iot/app/activate-service.md

@@ -0,0 +1,95 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: app
+---
+
+本文将介绍使用 IoT 通用功能（应用端）所需开通的服务。
+
+## 开通设备接入服务
+
+### 购买设备激活码
+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. 服务类型：若您的智能设备涉及音视频功能，请选择“**音视频设备接入服务**”；否则，请选择“**基础设备接入服务**”。
+
+4. 生效地域：国内设备选择广州区域，出海设备选择新加坡；有效期默认规格5年。
+
+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 对操作该产品无权限”。
+>
+
+## 激活服务
+1. 为音视频设备激活微信通话服务（TWeCall），请使用 [激活 TWeCall](https://cloud.tencent.com/document/product/1081/106587) 云 API
+
+   激活 Voip 的参数 SN 设置为 productID_deviceName. 注意使用英文下划线。
+
+2. 查询音视频设备的微信通话服务（TWeCall）剩余可用时长，请使用 [查询 TWeCall 激活状态](https://cloud.tencent.com/document/product/1081/106583) 云 API。
+
+## 小程序授权
+
+小程序需与物联网开发平台的应用进行关联，才能为音视频设备激活微信通话（TWeCall）的激活码。
+1. 创建应用完成后，单击应用名称进入应用详情。在应用详情页面的**腾讯云微通话**中，单击**去授权**。
+
+2. 在小程序授权弹窗内，单击**开始授权**，系统将自动生成授权二维码。
+
+3. 请小程序的管理员扫码完成授权。
+
+## 小程序申请硬件能力
+
+如果要使用设备呼叫微信的能力 (TWeCall)，需要在小程序后台配置硬件。
+
+在 [小程序管理后台](https://mp.weixin.qq.com/wxamp/deviceList)，找到**行业能力** > **硬件设备**页面，单击**添加设备**， 申请小程序的硬件能力。
+
+按照页面提示，填写对应的信息。审核通过后，小程序具备音视频能力，可以和设备调试 VoIP 功能。
+
+设备和小程序调试完成后，按照微信要求，寄送设备至微信，完成认证，小程序音视频能力才可以线上运行。

package/resource/knowledge/iot/app/demo/android.md

@@ -0,0 +1,93 @@
+---
+product: iot
+framework:
+  - android
+types:
+  - feature
+retrievable_scope: always
+feature_domain: app_demo
+---
+
+本文将为您介绍如何快速跑通 Android Demo。跟随本文档，您可以快速跑通 Demo，并最终体验一个包含完备 UI 界面的物联网 App。
+
+## 前提条件
+
+### 环境准备
+- 安装 [Android Studio](https://developer.android.com/studio) 2025 以后的版本。
+
+- 一台 Android 10 以上的设备。
+
+### 开通服务
+- 。
+
+- 并参见 开通服务，创建设备获取设备的 ProductId、DeviceName，在后续绑定设备步骤中会用到。
+
+## 下载 Demo 隐私与安全性
+1. 从 GitHub 下载 [IoT App Demo](https://github.com/Tencent-RTC/Tencent_IoT_App) 源码，或者直接在命令行运行以下命令：
+
+   ``` bash
+   git clone https://github.com/Tencent-RTC/Tencent_IoT_App.git
+   ```
+2. 通过 Android Studio 打开 `Tencent_IoT_App/android` 目录：
+
+   > **提示：**
+   >
+   > **Android Studio 的推荐方案：**将 Android Studio 的 Java 版本改为17。
+   >
+   > 1. 打开 Android Studio 设置。
+   > - **Windows**：File > Settings
+   > - **Mac**：Android Studio > Preferences
+   > 2. 修改 Java 编译器设置。
+   > - 路径：Build, Execution, Deployment > Build Tools > Gradle
+   > - 将 Gradle JDK 改为17（如果已安装）或 Use project JDK
+
+## 跑通 Demo
+
+按照 开通服务，创建设备和应用，并通过 Android Studio 运行 App，将设备绑定到 App。
+
+### **步骤1：运行** **Demo**
+1. 开启手机开发者选项与 USB 调试（设置 > 关于手机 > 连续单击版本号7次），连接后允许调试授权。
+
+2. 等待 Gradle 首次同步完成再运行。
+
+3. 选择设备并编译和运行 Demo。
+
+   > **说明：**
+   >
+   > 本 Demo 默认集成了音视频通话功能，由于该功能依赖的音视频 SDK 暂不支持模拟器，因此建议使用真机调试、运行 Demo。
+   >
+
+### **步骤2：登录和注册**
+
+Demo 启动后，在 UserId 输入框中输入自定义 ID，并在 AppKey、AppSecret 输入框中输入从 开通服务 获取的对应信息。
+
+> **提示：**
+> 建议您尽量避免将您的 UserId 设置成 “1”、“123”、“111” 等简单字符串，在多人协作开发时，此类 UserId 容易被同事占用导致登录失败，建议在调试时设置辨识度高的 UserId。
+>
+
+### 步骤3：绑定设备
+
+绑定设备时需要设备绑定签名（DeviceSignature），通过 API Explorer 在线调试获取。
+1. 打开 [GenSingleDeviceSignatureOfPublic 接口](https://console.cloud.tencent.com/api/explorer)，填入从 [开通服务](https://cloud.tencent.com/document/product/1081/135242) 文档获取的 ProductId、DeviceName（Expire 为签名过期时间，按需填写即可，例如设置为当前时间 24 小时后），单击**发送请求**，从返回结果的 Response.DeviceSignature 中获取签名值。
+
+2. 将获取到的签名值，填写到 “添加设备” 页面的签名输入框，然后单击**添加设备**。
+
+### 步骤4：通过物模型操作设备属性
+
+在 `DeviceHardwareType.kt` 添加您的产品 ID，Demo 会将该列表中的产品类型当做 “智能吸顶灯”，其他的产品当做安防摄像头。
+``` java
+object DeviceHardwareRegistry {
+    // Demo 会将该列表中的产品类型当做 “智能吸顶灯”，其他的产品当做安防摄像头
+    private val ceilingLampProductIds = setOf(
+        "XXXXXXXXXX"
+    )
+}
+```
+
+> **注意：**
+> 若未将 ProductId 加入列表，设备将被识别为安防摄像头。设备详情页与预期不符时，请检查该配置。
+>
+
+在绑定设备后，设备列表中就能看到对应智能吸顶灯设备，单击进去，就能看到智能吸顶灯的操作界面。
+
+接下来还需要参考 设备端的跑通 Demo 文档将设备端的 Demo 跑通，就可以通过 App Demo 操作智能吸顶灯了。

package/resource/knowledge/iot/app/demo/ios.md

@@ -0,0 +1,87 @@
+---
+product: iot
+framework:
+  - ios
+types:
+  - feature
+retrievable_scope: always
+feature_domain: app_demo
+---
+
+本文将为您介绍如何快速跑通 iOS Demo。跟随本文档，您可以快速跑通 Demo，并最终体验一个包含完备 UI 界面的物联网 App。
+
+## 前提条件
+
+### 环境准备
+
+在开始之前，请确保您已满足下列要求：
+- Xcode 16.0 及以上版本。
+
+- 一部 iOS 15.6 及以上真机。
+
+- 确保您已注册 Apple 开发者账号。
+
+### 开通服务
+1. 。
+
+2. 并参见 开通服务，创建设备获取设备的 ProductId、DeviceName，在后续绑定设备步骤中会用到。
+
+## 下载 Demo
+
+从 GitHub 下载 [IoT App Demo](https://github.com/Tencent-RTC/Tencent_IoT_App) 源码，或者直接在命令行运行以下命令：
+``` bash
+git clone https://github.com/Tencent-RTC/Tencent_IoT_App.git
+```
+
+## 跑通 Demo
+
+按照 开通服务，创建设备和应用，然后通过 Xcode 打开 `Tencent_IoT_App/ios/TXIoTDemo.xcodeproj` 项目：
+
+### **步骤1：运行** **Demo**
+1. 将 iOS 设备连接至电脑，在设备上选择**设置** > **隐私与安全性** > **开发者模式**，打开开发者模式。
+
+2. 在 Xcode 界面顶部的 iOS Device 选项中选择您用来测试的 iOS 设备。
+
+3. 在项目 TARGETS 的 **Signing & Capabilities** 界面勾选 **Automatically manage signing**，然后在每一个 Target 下配置您的苹果开发者账号和 Bundle Identifier。如果尚未在 Xcode 中登录 Apple ID，请先在 **Xcode > Settings > Apple Accounts** 中添加您的开发者账号或 Apple ID。
+
+4. 单击运行开始编译。编译成功后，您的设备上会自动安装好腾讯云 TXIoTDemo App。
+
+   > **说明：**
+   >
+   > 本 Demo 默认集成了音视频通话功能，由于该功能依赖的音视频 SDK 暂不支持模拟器，因此建议使用真机调试、运行 Demo。
+   >
+
+### **步骤2：登录和注册**
+
+Demo 启动后，在 UserId 输入框中输入自定义 ID，并在 AppKey、AppSecret 输入框中输入从 开通服务 获取的对应信息。
+
+> **提示：**
+> 建议您尽量避免将您的 UserId 设置成 “1”、“123”、“111” 等简单字符串，在多人协作开发时，此类 UserId 容易被同事占用导致登录失败，建议在调试时设置辨识度高的 UserId。
+>
+
+### 步骤3：绑定设备
+
+绑定设备时需要设备绑定签名（DeviceSignature），通过 API Explorer 在线调试获取。
+1. 打开 [GenSingleDeviceSignatureOfPublic 接口](https://console.cloud.tencent.com/api/explorer)，填入从 [开通服务](https://cloud.tencent.com/document/product/1081/135242) 文档获取的 ProductId、DeviceName（Expire 为签名过期时间，按需填写即可，例如设置为当前时间 24 小时后），单击**发起请求**，从返回结果的 Response.DeviceSignature 中获取签名值。
+
+2. 将获取到的签名值，填写到 “添加设备” 页面的签名输入框，然后单击**添加设备**。
+
+### 步骤4：通过物模型操作设备属性
+
+在 `DeviceHardwareType.swift` 添加您的产品 ID，Demo 会将该列表中的产品类型当做 “智能吸顶灯”，其他的产品当做安防摄像头。
+``` swift
+enum DeviceHardwareRegistry {
+    // Demo 会将该列表中的产品类型当做 “智能吸顶灯”，其他的产品当做安防摄像头
+    private static let ceilingLampProductIds: Set<String> = [
+        "XXXXXXXXXX"
+    ]
+}
+```
+
+> **注意：**
+> 若未将 ProductId 加入列表，设备将被识别为安防摄像头。设备详情页与预期不符时，请检查该配置。
+>
+
+在绑定设备后，设备列表中就能看到对应智能吸顶灯设备，单击进去，就能看到智能吸顶灯的操作界面。
+
+接下来还需要参考 设备端的跑通 Demo 文档将设备端的 Demo 跑通，就可以通过 App Demo 操作智能吸顶灯了。

package/resource/knowledge/iot/app/demo/miniprogram.md

@@ -0,0 +1,79 @@
+---
+product: iot
+framework:
+  - minprogram
+types:
+  - feature
+retrievable_scope: always
+feature_domain: app_demo
+---
+
+本文将为您介绍如何快速跑通小程序 Demo。跟随本文档，您可以快速跑通 Demo，并最终体验一个包含完备 UI 界面的物联网 App。
+
+## 前提条件
+
+### 环境准备
+
+在开始之前，请确保您已满足下列要求：
+- 安装微信开发者工具。
+
+- 一部 iPhone 或安卓真机，安装并登录微信。模拟器不支持原生组件（即 <live-pusher> 和 <live-player> 标签），需要在真机上进行运行体验。
+
+- 申请小程序 AppID. 并且申请 live-pusher, live-player 和双人音视频对话权限。
+
+### 开通服务
+- 。
+
+- 并参见 开通服务，创建设备获取设备的 ProductId、DeviceName，在后续绑定设备步骤中会用到。
+
+## 下载 Demo
+1. 从 GitHub 下载 [IoT App Demo](https://github.com/Tencent-RTC/Tencent_IoT_App) 源码，或者直接在命令行运行以下命令：
+
+   ``` bash
+   git clone https://github.com/Tencent-RTC/Tencent_IoT_App.git
+   ```
+2. 通过微信开发者工具打开 `Tencent_IoT_App/miniprogram` 目录
+
+## 跑通 Demo
+
+按照 开通服务，创建设备和应用，通过微信开发者工具运行 App, 将设备绑定到 App。
+
+### **步骤1：运行** **Demo**
+
+修改 project.config.json 中的 appid, 改为自己申请的小程序 AppID。
+
+> **说明：**
+> 模拟器不支持原生组件（即 <live-pusher> 和 <live-player> 标签），需要在真机上进行运行体验。
+>
+
+### **步骤2：登录和注册**
+
+Demo 启动后，在 UserId 输入框中输入自定义 ID，并在 AppKey、AppSecret 输入框中输入从 开通服务 获取的对应信息。
+
+> **提示：**
+> 建议您尽量避免将您的 UserId 设置成 “1”、“123”、“111” 等简单字符串，在多人协作开发时，此类 UserId 容易被同事占用导致登录失败，建议在调试时设置辨识度高的 UserId。
+>
+
+### 步骤3：绑定设备
+
+绑定设备时需要设备绑定签名（DeviceSignature），通过 API Explorer 在线调试获取。
+
+打开 [GenSingleDeviceSignatureOfPublic 接口](https://console.cloud.tencent.com/api/explorer)，填入从 [开通服务](https://cloud.tencent.com/document/product/1081/135242) 文档获取的 ProductId、DeviceName（Expire 为签名过期时间，按需填写即可，例如设置为当前时间 24 小时后），单击**发送请求**，从返回结果的 Response.DeviceSignature 中获取签名值。
+
+将获取到的签名值，填写到 “添加设备” 页面的签名输入框，然后单击**添加设备**。
+
+### 步骤4：通过物模型操作设备属性
+
+在 `device.ts` 文件中添加您的产品 ID，Demo 会将该列表中的产品类型当做 “智能吸顶灯”，其他的产品当做安防摄像头。
+``` typescript
+// Demo 会将该列表中的产品类型当做 “智能吸顶灯”，其他的产品当做安防摄像头
+const CEILING_LAMP_PRODUCT_IDS = ['XXXXXXXXXX'];
+```
+
+> **注意：**
+> 若未将 ProductId 加入列表，设备将被识别为安防摄像头。设备详情页与预期不符时，请检查该配置。
+>
+
+在绑定设备后，设备列表中就能看到对应智能吸顶灯设备，单击进去，就能看到智能吸顶灯的操作界面。
+
+接下来还需要参考 设备端的跑通 Demo 文档将设备端的 Demo 跑通，就可以通过 App Demo 操作智能吸顶灯了。