@tencentcloud/sdk-mcp 1.6.0-beta.3 → 1.6.1

package/resource/integration/chat/preset/uni-app/integration.md

@@ -19,8 +19,8 @@ TUIKit 是一款基于腾讯云 IM SDK 和 UTS 原生渲染技术的 uni-app UI
 
    > H5 和小程序项目，如有需要请参考以下替代方案：
    >
->   - 打包 H5。 可参考：chat-uikit-uniapp。
->   - 打包小程序。可参考：uni-app 完整版（Vue3/Vue2）。
+>   - 打包 H5，可参考：Web H5（Vue3）。
+>   - 打包小程序，可参考：uni-app 完整版（Vue3/Vue2）。
 >   - 接入过程中遇到任何卡点或有改进建议，欢迎通过 [UniApp Atomicx 接入体验反馈](https://wj.qq.com/s2/26120470/621d/) 反馈，官方会及时跟进处理。
 
 ## 集成步骤

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

@@ -13,6 +13,18 @@ TUIKit 是基于腾讯云 Chat SDK 的一款 Vue 3 UI 组件库，它提供了
 > 您的反馈我们会**高度重视**，本问卷填写**仅需要 30 秒**！诚邀您的参与。
 >
 
+> **说明：**
+>
+
+> **⚡ 请根据您的技术栈和目标平台，选择对应的接入文档开始集成：**
+>
+
+|接入需求|桌面端|移动端 H5|
+|---------|---------|---------|
+|全新 Web Vue3 项目|请参考本文|全功能接入/移动端/Vue3|
+|全新 Web React 项目|全功能接入/桌面端/React|全功能接入/移动端/React|
+|Web Vue2 项目|全功能接入/桌面端/Vue2 & 旧版本 Vue3|全功能接入/桌面端/Vue2 & 旧版本 Vue3|
+
 ## 关键概念
 
 chat-uikit-vue3 主要分为 ConversationList、Chat、MessageList、ChatHeader、MessageInput、ChatSetting、Search、Contact 等核心 UI 组件，每个 UI 组件负责展示不同的内容。

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

@@ -106,7 +106,7 @@ TUICallKitServer.getTUICallEngineInstance().callExperimentalAPI(JSON.stringfy(js
 TUICallKit 是腾讯云推出一款新的音视频通话 UI 组件，**是 TUICalling 的升级版本**，支持群组通话、AI 降噪等更多功能特性、支持全平台间互通呼叫，功能更加稳定。 从 TUICalling 升级到 TUICallKit 您可以参考：
 - 微信小程序升级方案
 
-- Web 升级方案
+- [Web 升级方案](https://cloud.tencent.com/document/product/647/78731)
 
 - Android 升级方案
 

package/resource/knowledge/chat/preset/android-view/integration.md

@@ -5,8 +5,6 @@ TUIKit 是基于 IM SDK 的一套 UI 组件库，可通过 UI 组件快速实现
 TUIKit 采用数据驱动的响应式架构与原生 Android View 体系（非 Compose），以源码方式开放集成。它提供会话列表、聊天、联系人、搜索、群组等完整 UI 能力，并内置主题切换与全局配置。
 
 ### 环境要求
-
-> **架构说明**：本文档对应 **Android TUIKit（View 架构 / 传统 XML 布局）**，适用于基于 Android View 体系的项目。如需 Jetpack Compose 架构，请参考 Android TUIKit Compose 集成文档。
 - Android Studio 2022.3.1 及之后的版本，JDK 17。
 
 - Android 6.0 及以上真机或模拟器。
@@ -290,144 +288,6 @@ TUICallEngine.createInstance(context).init(
 )
 ```
 
-## 集成 TUIKit（旧架构）
-
-> **版本说明**
->
-> - TUIKit（旧架构）为历史版本，目前已不再新增功能并逐步停止维护，主要面向存量项目继续使用。若您是新接入的项目，建议优先按上文「集成 TUIKit」章节进行集成，以获得更现代的架构、更低的接入成本与持续的功能更新。
-> - 如您当前仍在使用旧架构 TUIKit，欢迎花 1 分钟填写这份[调研问卷](https://wj.qq.com/s2/27183285/0606/)，帮我们了解您继续沿用旧版的原因，以便提供更合适的迁移支持。
-
-**TUIKit 新架构的主要优势**
-|  | 新架构 | 旧架构 |
-| --- | --- | --- |
-| 开发语言 | 基于 Kotlin，借力协程与空安全，语法更简洁、更易维护 | 以 Java 为主 |
-| 架构与自定义 | 界面与数据解耦，界面自定义更灵活、更安全 | 界面与数据耦合较高 |
-| 主题与语言切换 | 主题、语言支持动态切换，无需重启应用 | 主题、语言切换需重启应用 |
-| 性能与体验 | 动画更流畅，卡顿更少 | 受旧架构限制，流畅性弱于新架构 |
-| 功能演进 | 持续支持新功能 | 仅维护，不再新增功能 |
-
-> **消息引用与回复功能的版本兼容性：**
->
-
-> 自 9.0.7652 版本起：
->
-> - **消息引用（Quote）**改用 IMSDK 原生引用能力实现，与旧版本引用消息格式不兼容。新旧版本互发的引用消息无法正确解析引用内容，请将收发双方统一升级至 9.0.7652 及以上版本。
-> - **消息回复（Reply）**功能已下线，相关接口与 UI 入口不再提供，如业务有相关需求，可参考旧版本 TUIKit 自行实现。
-
-> **两者区别：**引用是发送新消息时附带一条历史消息的摘要卡片，点击可跳转原消息（一问一答）；回复是在某条消息下追加评论并聚合成回复列表（评论区式）。
->
-
-### 集成步骤
-1. 从 GitHub 下载 [Android TUIKit 源码](https://github.com/TencentCloud/TIMSDK/tree/master/Android/TUIKit)，将 `TUIKit` 目录复制到工程目录下。
-
-2. 在 `settings.gradle` 中引入所需模块（模块相互独立，可只引入需要的模块）。核心模块如下，其余可选模块按需引入即可：
-
-   ``` groovy
-   include ':app'
-   include ':tuicore'
-   project(':tuicore').projectDir = new File(settingsDir, '../TUIKit/TUICore/tuicore')
-   include ':timcommon'
-   project(':timcommon').projectDir = new File(settingsDir, '../TUIKit/TIMCommon/timcommon')
-   include ':tuichat'
-   project(':tuichat').projectDir = new File(settingsDir, '../TUIKit/TUIChat/tuichat')
-   include ':tuicontact'
-   project(':tuicontact').projectDir = new File(settingsDir, '../TUIKit/TUIContact/tuicontact')
-   include ':tuiconversation'
-   project(':tuiconversation').projectDir = new File(settingsDir, '../TUIKit/TUIConversation/tuiconversation')
-   // 搜索、社群、通话、会议及各插件等可选模块按需引入
-   ```
-3. 在 app 模块的 `build.gradle` 中添加依赖：
-
-   ``` groovy
-   dependencies {
-       api project(':tuiconversation')
-       api project(':tuicontact')
-       api project(':tuichat')
-       // 其余已引入的可选模块按需添加 api project(...) 依赖
-   }
-   ```
-4. 配置 Kotlin 支持
-
-- 如果您的项目已是 Kotlin 工程​：可跳过此步。
-
-- ​如果您的项目尚未配置 Kotlin​：请添加对应版本的 Kotlin Gradle 插件
-
-   > **说明：**
-   >
->   - 本地源码集成方式升级时需从 GitHub 重新拉取最新代码覆盖本地 `TUIKit` 目录，冲突需手动合并。
->   - 旧架构默认提供经典版与简约版两套 UI，**不能混用**：集成多个组件时必须统一选择经典版或简约版。
-
-### 接入步骤
-
-常用聊天软件由会话列表、聊天窗口、好友列表、音视频通话等基本界面组成，参考下列步骤即可快速搭建。
-
-**步骤1：配置用户鉴权**
-
-在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/tool-usersig) 根据 UserID 获取 UserSig，用于后续登录鉴权。
-
-**步骤2：用户登录**
-``` java
-TUILogin.login(context, sdkAppID, userID, userSig, new TUICallback() {
-    @Override
-    public void onSuccess() {
-        // 登录成功，可跳转聊天或会话页
-    }
-    @Override
-    public void onError(final int code, final String desc) {
-        // 登录失败，可弹框报错
-    }
-});
-```
-
-> **注意：**
->
-
-> 正式生产环境建议在服务端生成 UserSig，由 App 向业务服务器请求动态 UserSig 鉴权。详见 [服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)。
->
-
-**步骤3：构建会话列表界面**
-
-创建 `TUIConversationFragment`（经典版）或 `TUIConversationMinimalistFragment`（简约版）并加入布局：
-``` java
-TUIConversationFragment conversationFragment = new TUIConversationFragment();
-getSupportFragmentManager().beginTransaction()
-        .add(R.id.fragment_container, conversationFragment).commitAllowingStateLoss();
-```
-
-**步骤4：构建聊天界面**
-
-可直接启动预置的聊天 Activity，或在自定义 Activity 中嵌入聊天 Fragment。以经典版为例：
-``` java
-Bundle param = new Bundle();
-param.putInt(TUIConstants.TUIChat.CHAT_TYPE, isGroup ? V2TIMConversation.V2TIM_GROUP : V2TIMConversation.V2TIM_C2C);
-param.putString(TUIConstants.TUIChat.CHAT_ID, chatID);
-if (isGroup) {
-    TUICore.startActivity("TUIGroupChatActivity", param);
-} else {
-    TUICore.startActivity("TUIC2CChatActivity", param);
-}
-```
-
-**步骤5：构建联系人界面**
-
-创建 `TUIContactFragment`（经典版）或 `TUIContactMinimalistFragment`（简约版）并加入布局：
-``` java
-TUIContactFragment contactFragment = new TUIContactFragment();
-getSupportFragmentManager().beginTransaction()
-        .add(R.id.fragment_container, contactFragment).commitAllowingStateLoss();
-```
-
-**步骤6：音视频通话（可选）**
-1. 在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 开通实时音视频（TRTC）服务。
-
-2. 在 `settings.gradle` 中引入 `atomic_x` 与 `tuicallkit-kt`，并在 app 的 `build.gradle` 添加 `api project(':tuicallkit-kt')`。
-
-3. 集成后聊天与联系人界面默认显示「视频通话」「语音通话」按钮，点击即可发起通话。
-
-   **步骤7：多人音视频（可选）**
-
-   在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 开通多人音视频（TUIRoomKit）免费体验，在 `settings.gradle` 引入 `tuiroomkit` 并在 app 的 `build.gradle` 添加 `api project(':tuiroomkit')`，集成后聊天界面将出现「快速会议」入口。
-
 ## 常见问题
 
 ### 音视频常见问题

package/resource/knowledge/chat/urls/restapi.md

@@ -5,7 +5,6 @@
 | 子问题 | 目标文档 |
 |--------|---------|
 | UserSig 生成方法（登录鉴权） | `https://cloud.tencent.com/document/product/269/32688` |
-| 服务端错误码表 | `https://cloud.tencent.com/document/product/269/1671` |
 | 服务端消息格式 | `https://cloud.tencent.com/document/product/269/2720` |
 
 ## 消息相关 REST API

package/resource/knowledge/push/config/donut.md

@@ -0,0 +1,445 @@
+[微信小程序多端框架](https://cloud.tencent.com/document/product/269/111208) 推送服务目前推送支持小米、华为、荣耀、OPPO、vivo、魅族、一加、realme、iQOO 、FCM 和 Apple 等厂商通道。
+
+> **注意：**
+>
+
+> 每个厂商仅支持配置 1 个证书。
+>
+
+【Android】
+
+### 注册应用到厂商推送平台
+
+推送需要将您自己的应用注册到各个厂商的推送平台，得到 AppID 和 AppKey 等参数，来实现推送功能。目前国内支持的手机厂商有：[小米](https://dev.mi.com/xiaomihyperos/documentation/detail)、[华为](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/service-introduction-0000001050040060)、[荣耀](https://developer.hihonor.com/cn/kitdoc)、[OPPO](https://open.oppomobile.com/wiki/doc#id=10195)、[vivo](https://dev.vivo.com.cn/documentCenter/doc/281)、[魅族](https://open.flyme.cn/service/3)，境外支持 [Google FCM](https://console.firebase.google.com/u/0/)，是否需要上架商店详情如下：
+
+|厂商|小米|华为|OPPO|vivo|魅族|荣耀|Google FCM|
+|---------|---------|---------|---------|---------|---------|---------|---------|
+|是否需要上架|是|否|是|是|否|否|否|
+
+【小米】
+
+> **注意：**
+>
+
+> 通知栏推送：应用需在小米软件商店上架。
+>
+
+### 小米
+
+#### 步骤1：注册小米开发者账号
+1. 进入 [小米开放平台](https://dev.mi.com/xiaomihyperos/documentation/detail)，注册小米开发者账号和启用推送服务。
+
+2. 使用小米开发者账号登录 [小米澎湃 OS 开发者平台](https://dev.mi.com/xiaomihyperos)，在管理中心选择 **PUSH 服务**，进入应用列表页。
+
+3. 进入**推送服务应用列表**。应用列表包括该开发者账号下的已有 App（包括 Android 手机/平板应用、Android TV 应用）。
+
+4. 单击**未启用**状态 App 的**启用推送**，可以进入消息推送启用页面。
+
+#### **步骤2：启用推送**
+1. 启用推送前，您须先阅读《消息分类介绍及运营规范》、《推送消息违规处理办法》、《小米推送技术服务协议》、《小米推送技术服务数据保护附录》。勾选同意接受后，点击右上方按钮进入下一步。
+
+2. 为您的应用创建所需的通知类别：
+
+  1. 点击**选择分类**，详细的消息类型说明请参考[《小米推送消息分类新规》](https://dev.mi.com/xiaomihyperos/documentation/detail)。
+
+  2. 按以上新规要求完整填写相应信息。
+
+  3. 提交审核。
+
+该环节您最多可同时创建8个不同分类的通知类别，我们会在3-5个工作日内完成审核。后续您可在**推送运营平台** > **消息分类管理**中维护应用的通知类别。
+
+#### 步骤3：创建应用
+1. 如果您想使用的应用不在应用列表内，点击**创建应用**，选择**创建手机/平板应用或电视应用**。
+
+2. 选择**操作系统**，填写**应用名**和**包名**，选择应用分类，单击**创建**，创建一个新应用。
+
+3. 完成应用创建后，就可以启用该应用的推送服务了。
+
+4. 启用推送服务后，在“应用管理-应用信息”页面可查看该应用对应的 AppId、AppKey 和 AppSecret。
+
+其中 AppId 和 AppKey 是客户端的身份标识，在客户端 SDK 初始化时使用；AppSecret 是服务器端的身份标识，在使用服务端 SDK 向客户端发送消息时使用。
+
+5. 应用列表包括该开发者账号下的已有 App（包括 Android 手机/平板应用、Android TV 应用）。
+
+#### 步骤4：查看并获取**应用信息**
+
+进入推送运营平台的**应用信息**页面，查看**应用信息**。
+
+#### 步骤5：配置推送证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+| #### | <strong>说明：</strong><br>应用内指定界面，请使用默认配置。<br>#### |
+
+【华为】
+
+### 华为
+
+#### 步骤1：注册华为开发者账号
+
+进入 [华为开发者联盟](https://developer.huawei.com/consumer/cn/)，注册华为开发者账号，详情请参见 [注册账号](https://developer.huawei.com/consumer/cn/doc/start/registration-and-verification-0000001053628148)。
+
+#### 步骤2：创建应用
+1. 在 [华为管理中心](https://developer.huawei.com/consumer/cn/console) 的**应用管理**中，单击** AppGallery Connect，**进入应用管理中心。
+
+2. 单击**我的项目**，添加一个新的项目。
+
+3. 在**项目设置**栏单击**推送服务** > **立即开通**。
+
+4. 单击**项目设置 > API 管理**，开启推送服务的权限。
+
+#### 步骤3：添加应用
+
+单击**项目设置 > 常规**，添加应用。
+
+> **注意：**
+>
+
+> 应用包名与插件应用包名保持一致。
+>
+
+#### 步骤4：获取应用信息
+
+单击**项目设置 > 常规**，获取应用信息。
+
+> **说明：**
+>
+> - 常规页面包含项目和应用的 Client ID 和 Client Secret，两者对应的参数不一致，请下拉至页面底部，获取应用的 Client ID 和 Client Secret。
+> - 必须添加打包的 [SHA256证书指纹](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-config-agc-0000001050170137#section193351110105114)，SHA256 证书指纹需与自己的打包证书一致。
+
+>
+>
+
+#### 步骤5：添加推送证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+|  | <strong>注意：</strong><br>- Client ID 对应 AppID，Client Secret 对应 AppSecret。<br>- <strong>应用内指定界面</strong>链接，不可以修改。 该配置用于派发单击后离线推送插件的事件监听，不可以直接配置应用内页面的跳转。 |
+
+【OPPO】
+
+> **注意：**
+>
+> - 通知栏推送：应用需在 OPPO 软件商店上架；
+> - 通知栏推送测试权限：每天仅可推送1000条消息，限测试使用。应用上架后需重新申请“通知栏推送”权限，以获得正常消息推送数量；
+> - 平台将会在1个工作日内返回审核结果，开发者可以在申请页面查看审核结果，其他问题可咨询开放平台客服。
+
+### OPPO
+
+#### 步骤1：注册 OPPO 开发者账号
+
+进入[ OPPO 开放平台](https://open.oppomobile.com/)，注册 OPPO 开发者账号，详情参见 [OPPO 企业开发者账号注册](https://open.oppomobile.com/new/developmentDoc/info)。
+
+#### 步骤2：创建应用
+
+进入 OPPO 开放平台，单击**产品** > **应用分发**> **OPPO 软件商店 > 发布应用**进入管理中心，创建应用。
+
+#### 步骤3：开通 PUSH 服务
+1. 进入 OPPO 开放平台，单击**产品 **> **移动服务 **> **推送服务**进入推送主页，单击**申请接**入开通推送服务。
+
+2. 单击进入**管理中心 **> **应用列表 **> **申请推送服务**界面，为未开启服务的应用申请推送权限。
+
+> **说明：**
+>
+> - 已开启服务：已申请 PUSH 权限并已通过的应用。
+> - 未开启服务：可申请 PUSH 权限的应用。
+
+ 3. 单击**申请开通**。在未开启服务的应用中单击需要申请 PUSH 权限的应用，进入 PUSH 服务并点击**申请开通**。
+
+#### 步骤4：添加推送证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+|  | 注意：<br>- 应用内指定界面链接，不可以修改。<br>- 该配置用于派发单击后离线推送插件的事件监听，不可以直接配置应用内页面的跳转。 |
+
+【vivo】
+
+> **注意：**
+>
+
+> 若应用没有上架应用市场，推送权限受限，不可在 vivo 官网的 Web 界面和 API 后台发送正式消息，可在 API 后台向设置的测试设备发送测试消息进行测试。
+>
+
+### vivo
+
+#### 步骤1：注册 vivo 开发者账号
+
+进入 [vivo 开放平台](https://dev.vivo.com.cn/openAbility/pushNews)，注册 vivo 开发者账号，详情参见 [vivo 企业开发者账号注册](https://dev.vivo.com.cn/documentCenter/doc/2)。
+
+#### 步骤2：新建应用
+
+进入 **vivo 开放平台，**单击**分发 > 应用分发 > 应用商店 > 上传应用**来新建您的应用。
+
+#### 步骤3：**开通推送**
+
+进入管理中心单击**推送服务 > 推送申请，**为新建的应用申请开通推送。
+
+#### 步骤4：获取应用信息
+
+进入推送运营平台，单击**应用管理 > 应用信息**，获取应用信息。
+
+#### 步骤5：添加推送证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置到添加的推送证书。
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+|  | <strong>注意：</strong><br><strong>应用内指定界面</strong>链接，不可以修改。 该配置用于触发点击后的离线推送插件的事件监听，不可以直接配置应用内页面的跳转。 |
+
+#### 回执配置请参见：[消息触达统计配置 > vivo](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
+
+【魅族】
+
+### 魅族
+
+#### 步骤1：注册魅族开发者账号
+
+注册魅族开发者账号，详情参见 [开发者注册](https://open.flyme.cn/ )。
+
+#### 步骤2：创建应用
+1. 单击**控制台** >** Flyme 推送**。
+
+2. 填写应用信息后，创建应用。
+
+> **注意：**
+>
+
+> 应用包名与插件应用包名保持一致。
+>
+
+#### 步骤3：获取应用信息
+
+在应用列表中单击**打开应用**。进入配置管理页面，获取应用信息。
+
+####
+
+#### 步骤4：添加推送证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置到添加的推送证书。
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+|  | <strong>注意：</strong><br><strong>应用内指定界面</strong>链接，不可以修改。 该配置用于触发点击后的离线推送插件的事件监听，不可以直接配置应用内页面的跳转。 |
+
+#### 回执配置请参见：[消息触达统计配置 > 魅族](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
+
+【荣耀】
+
+### 荣耀
+
+#### 步骤1：注册荣耀开发者账号
+
+注册荣耀开发者账号，详情参见 [开发者注册](https://developer.honor.com/cn/doc/guides/100272)。
+
+#### 步骤2：进入管理中心页面。
+
+####
+
+#### 步骤3：进入推送服务列表
+
+单击**推送服务**进入推送服务列表页面。
+
+####
+
+#### 步骤4：创建应用
+1. 单击**申请推送服务，**进入应用申请页面。
+
+2. 选择应用类型“移动应用”，填写应用包名和证书指纹、同意推送服务协议和数据处理附录，单击**提交**。
+
+> **注意：**
+>
+
+> 需要添加打包 [SHA256 证书指纹](https://developer.honor.com/cn/docs/11002/guides/android-generate-appsign)，SHA256 证书指纹需与自己的打包证书一致。
+>
+
+#### 步骤5：获取应用信息
+
+在**推送服务**列表中，单击**查看**，获取应用信息。
+
+#### 步骤6：添加推送证书
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置到添加的推送证书。
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+|  | <strong>注意：</strong><br><strong>应用内指定界面</strong>链接，不可以修改。 该配置用于触发点击后的离线推送插件的事件监听，不可以直接配置应用内页面的跳转。 |
+
+【Google FCM】
+
+### Google FCM
+
+#### 步骤1：进入 Firebase 控制台
+
+进入 [Firebase 控制台](https://console.firebase.google.com)，登录谷歌账号。
+
+#### 步骤2：创建应用
+1. 单击**创建项目**，添加一个新的项目。
+
+2. 进入 Android 应用。
+
+3. 输入应用信息，注册应用。
+
+4. 下载并添加配置文件，完成注册。
+
+下载 google-services.json 文件，放到 Android 原生资源目录中，默认在 miniapp/android/nativeResources/app/ 路径下。
+
+#### 步骤3：生成证书私钥。
+1. 单击应用，进入应用管理。
+
+2. 在**项目设置**单击**服务账号 > 生成新的密钥**。
+
+#### 步骤4：配置推送证书。
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置到添加的推送证书。
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+| #### | #### |
+
+【iOS】
+
+### iOS
+
+集成腾讯云推送服务之前，需要先向 Apple 申请 APNs 推送证书，然后上传推送证书到 IM 控制台 。之后按照 [快速接入](https://cloud.tencent.com/document/product/269/111208) 步骤接入即可。
+
+Apple 厂商配置目前有两种主流的证书，p12 证书和 p8 证书。两种证书各有优劣，您可按需要选择其中的一种。
+|  | <strong>证书类型</strong> | <strong>有效期和管理</strong> | <strong>安全性</strong> | <strong>灵动岛</strong> |
+| --- | --- | --- | --- | --- |
+| <strong>p12 证书</strong> | p12 证书是一个包含公钥和私钥的二进制文件，用于基于证书的身份验证。它将公钥证书和私钥捆绑在一个文件中，扩展名为 .p12 或 .pfx。 | p12 证书通常有一年的有效期，过期后需要重新生成和部署。每个应用程序都需要单独的 p12 证书来处理推送通知。 | 证书：p12 证书使用基于证书的身份验证，需要在服务器上存储私钥。这可能会增加安全风险，因为私钥可能会被未经授权的用户访问。 | 不支持 |
+| <strong>p8 证书</strong> | p8 证书是一个 Auth Key（授权密钥），用于基于令牌的身份验证。它是一个包含私钥的文本文件，扩展名为 .p8。 | p8 证书没有到期日期，因此您无需担心证书过期。此外，使用 p8 证书可以简化证书管理，因为您可以使用一个 p8 证书为多个应用程序提供推送通知服务。 | p8 证书使用基于令牌的身份验证，这意味着您的服务器会周期性地生成一个 JSON Web Token（JWT）来与 APNs 建立连接。这种方法更安全，因为它不需要在服务器上存储私钥。 | 支持灵动岛推送 |
+
+#### 一、推送证书配置（APNs）
+
+【p8 证书（推荐）】
+
+p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。此外，使用 p8 证书可以简化证书管理，因为您可以使用一个 p8 证书为多个应用程序提供推送通知服务。另外，p8 证书支持灵动岛推送。
+
+#### 步骤1：申请 APNs 证书
+
+要创建 p8 证书文件，首先需要登录 [苹果开发者中心](https://developer.apple.com/)。
+
+1.  进入 Certificates, Identifiers & Profiles：在页面右上角单击 **Account**，然后在下拉菜单中选择 **Certificates, Identifiers & Profiles** 。
+
+2. 创建一个新的 App ID：在左侧菜单中单击 **Identifiers** ，然后单击右侧的 **+** 创建一个新的 App ID。填写相应的信息并单击 **Continue **。
+
+3. 创建一个新的密钥：在左侧菜单中单击 **Keys**，然后单击右侧的 **+** 创建一个新的密钥。输入密钥的名称，然后勾选 **Apple Push Notifications service (APNs)**，单击 **Continue** 。
+
+确认并生成密钥：在确认页面核对您的密钥信息，然后单击 **Register** 。接下来，您将看到一个页面提示您下载密钥。单击 **Download**，将生成的 .p8 文件保存到您的计算机上。
+
+> **说明：**
+>
+> - p8 证书只可以下载一次，请妥善保存。
+> - 请妥善保管下载的 p8 文件，因为您将无法再次下载该文件。您可以使用此 p8证书配置您的 iOS 应用程序以接收推送通知。
+
+#### 步骤2：上传 p8 证书到 IM 控制台
+1. 登录 [即时通信 IM 控制台](https://console.cloud.tencent.com/im)。
+
+2. 单击目标应用卡片，进入应用的基础配置页面。
+
+3. 单击 **iOS 原生离线推送设置**右侧的**添加证书**。
+
+4. 选择 .p8 证书
+
+> **说明：**
+>
+> - **Key ID**：这是您的 APNs Auth Key 的唯一标识符。当您在 Apple Developer Center 创建一个新的 APNs Auth Key 时，系统会为您生成一个 Key ID。您可以在 "Certificates, Identifiers & Profiles" 部分的 "Keys" 中找到它。
+> - **Team ID**：这是您的开发者账户的唯一标识符。您可以在 Apple Developer Center 的账户详情页面找到它。点击右上角的 "Membership"，在 "Membership Details" 部分可以找到您的 Team ID。
+> - **Bundle ID**：这是您的应用程序的唯一标识符，也称为应用程序 ID。您可以在 Apple Developer Center 的 "Certificates, Identifiers & Profiles" 部分找到它。选择 "Identifiers"，然后在您的应用程序列表中找到对应的 Bundle ID。
+
+【p12 证书】
+
+#### 步骤1：申请 APNs 证书
+
+#### 开启 App 远程推送
+1. 登录 [苹果开发者中心](https://developer.apple.com/account/) 网站，单击 **Certificates, Identifiers & Profiles** 或者侧栏的 **Certificates, Identifiers & Profiles**，进入 **Certificates, IDs & Profiles** 页面。
+
+2. 单击 Identifiers 右侧的 **+**。
+
+3. 您可以参见如下步骤新建一个 AppID，或者在您原有的 AppID 上增加 `Push Notifications` 的 `Service`。
+
+> **说明：**
+>
+
+>  您的 App 的 `Bundle ID` 不能使用通配符 `*`，否则将无法使用远程推送服务。
+>
+
+4. 勾选 **App IDs**，单击 **Continue** 进行下一步。
+
+5. 选择 **App**，单击 **Continue** 进行下一步。
+
+6. 配置 `Bundle ID` 等其他信息，单击 **Continue** 进行下一步。
+
+7. 勾选 **Push Notifications**，开启远程推送服务。
+
+#### 生成证书
+1. 选中您的 AppID，选择 **Configure**。
+
+2. 可以看到在 **Apple Push Notification service SSL Certificates** 窗口中有两个 `SSL Certificate`，分别用于开发环境（Development）和生产环境（Production）的远程推送证书，如下图所示：
+
+3.
+
+我们先选择开发环境（Development）的 **Create Certificate**，系统将提示我们需要一个 Certificate Signing Request（CSR）。
+
+4. 在 Mac 上打开**钥匙串访问工具（Keychain Access）**，在菜单中选择**钥匙串访问 **> **证书助理 **> **从证书颁发机构请求证书**（`Keychain Access - Certificate Assistant - Request a Certificate From a Certificate Authority`）。
+
+5. 输入用户电子邮件地址（您的邮箱）、常用名称（您的名称或公司名），选择**存储到磁盘**，单击**继续**，系统将生成一个 `*.certSigningRequest` 文件。
+
+6. 返回上述 步骤3 中 Apple Developer 网站刚才的页面，单击 **Choose File** 上传生成的 `*.certSigningRequest` 文件。
+
+7. 单击 **Continue**，即可生成推送证书。
+
+8. 单击 **Download** 下载开发环境的 `Development SSL Certificate` 到本地。
+
+9. 再次按照上述步骤1 - 8，将生产环境的 `Production SSL Certificate` 下载到本地。
+
+> **说明：**
+>
+
+> 生产环境的证书实际是开发（Sandbox）+生产（Production）的合并证书，可以同时作为开发环境和生产环境的证书使用。
+>
+
+10. 双击打开下载的开发环境和生产环境的 `SSL Certificate`，系统会将其导入钥匙串中。
+
+11. 打开钥匙串应用，在**登录 **> **我的证书**，右键分别导出刚创建的开发环境（`Apple Development IOS Push Service`）和生产环境（`Apple Push Services`）的 `p12` 文件。
+
+> **注意**
+>
+
+>  保存`.p12`文件时，请务必为其设置密码。
+>
+
+#### 步骤2：上传证书到控制台
+1. 登录 [即时通信 IM 控制台](https://console.cloud.tencent.com/im)。
+
+2. 单击目标应用卡片，进入应用的基础配置页面。
+
+3. 单击 **iOS 原生离线推送设置**右侧的**添加证书**。
+
+4. 选择证书类型，上传 iOS 证书（.p12），设置证书密码，单击**确认**。
+
+> **说明：**
+>
+> - 上传证书名最好使用全英文（尤其不能使用括号等特殊字符）。
+> - 上传证书需要设置密码，无密码收不到推送。
+> - 发布 App Store 的证书需要设置为生产环境，否则无法收到推送。
+> - 上传的 p12 证书必须是自己申请的真实有效的证书。
+
+5. 待推送证书信息生成后，记录证书的 ID。
+
+#### 二、生成 TIMPushAppGroupID
+- 步骤1：登录 [苹果开发者中心](https://developer.apple.com/account/ios/certificate/development) 网站，进入 **Identifiers > App Groups **创建 App Groups。
+
+- 步骤2：绑定使用 TencentCloud-TIMPush 应用的 appID 到 App Groups。
+
+###
+
+- 步骤3：获取您的 TIMPushAppGroupID。
+
+> **注意：**
+>
+
+> 关于**点击后续动作**支持上报统计功能：
+>
+> 1. 如果选择打开应用和打开网页，购买插件后会默认支持上报统计。
+> 2. 如果选择打开应用内指定界面：
+> - 新增证书情况，请直接使用自动填写的默认值即可支持点击上报统计。
+> - 如果之前有证书且已配置，继续使用旧证书需要修改为默认值，才可以支持上报统计，或者重新生成新的证书。