@tencentcloud/sdk-mcp 1.6.3 → 1.6.5

package/resource/knowledge/push/api-reference/android.md

@@ -0,0 +1,337 @@
+本文介绍 TIMPush Android SDK 的客户端 API，包括 `TIMPushManager`、`TIMPushListener`、`TIMPushCallback`、`TIMPushMessage` 和错误码。
+
+## API 概览
+
+### TIMPushManager
+
+`TIMPushManager` 是 TIMPush Android SDK 的推送服务管理类，用于注册推送服务、管理 `RegistrationID`、配置推送通道和前台通知展示，以及添加 Push 监听器。
+
+|API|说明|
+|---------|---------|
+|getInstance|获取 TIMPushManager 管理器实例。|
+|registerPush|注册推送服务。|
+|unRegisterPush|反注册关闭离线推送服务。|
+|getRegistrationID|获取推送唯一 ID 标识。|
+|setRegistrationID|自定义设置推送唯一 ID 标识。|
+|addPushListener|添加 Push 监听器。|
+|removePushListener|移除 Push 监听器。|
+|forceUseFCMPushChannel|指定设备离线推送使用 FCM 通道。|
+|disablePostNotificationInForeground|关闭 App 在前台时弹出通知栏。|
+
+### TIMPushListener
+
+`TIMPushListener` 是 Push 监听器抽象类。按需重写以下方法，即可接收 Push 消息、推送撤回和通知点击事件。
+
+|API|说明|
+|---------|---------|
+|onRecvPushMessage|收到 Push 消息。|
+|onRevokePushMessage|收到 Push 消息撤回通知。|
+|onNotificationClicked|点击通知栏消息回调。|
+
+## 回调类型
+
+### TIMPushCallback
+
+TIMPush 通用结果回调抽象类。接口调用成功时触发 `onSuccess`，失败时触发 `onError`。
+
+#### 声明
+``` java
+public abstract class TIMPushCallback<T> {
+    public void onSuccess(T data) {}
+
+    public void onError(int errCode, String errMsg, T data) {}
+}
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`data`|`T`|成功或失败回调时返回的数据。|
+|`errCode`|`int`|失败回调时的错误码。|
+|`errMsg`|`String`|失败回调时的错误描述。|
+
+## TIMPushManager
+
+### getInstance
+
+获取 `TIMPushManager` 管理器实例。
+
+#### 声明
+``` java
+public static TIMPushManager getInstance();
+```
+
+#### 返回值
+
+`TIMPushManager` 单例对象。后续 API 均通过该实例调用。
+
+### registerPush
+
+注册推送服务。
+
+#### 声明
+``` java
+public abstract void registerPush(Context context, int sdkAppId, String appKey, TIMPushCallback callback);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`context`|`Context`|Android 上下文对象。|
+|`sdkAppId`|`int`|应用的 sdkAppId。|
+|`appKey`|`String`|控制台分配的 appKey。|
+|`callback`|`TIMPushCallback`|注册结果回调。|
+
+#### 说明
+
+如果您单独使用推送服务，请正确传递 `sdkAppId` 和 `appKey` 两个参数，即可注册推送服务。
+
+如果您已经集成 IM 产品，请在 IM 登录成功后调用该接口，将 `appKey` 参数设置为 `null`，接入离线推送能力。
+
+### unRegisterPush
+
+反注册关闭离线推送服务。
+
+#### 声明
+``` java
+public abstract void unRegisterPush(TIMPushCallback callback);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`callback`|`TIMPushCallback`|反注册结果回调。|
+
+### getRegistrationID
+
+获取推送唯一 ID 标识。
+
+#### 声明
+``` java
+public abstract void getRegistrationID(TIMPushCallback callback);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`callback`|`TIMPushCallback`|获取结果回调。|
+
+#### 说明
+
+注册离线推送服务成功后，通过该接口可获取推送唯一 ID 标识，即 `RegistrationID`，然后可以根据 `RegistrationID` 向指定设备推送消息。
+
+`RegistrationID` 是设备的推送唯一标识 ID。默认注册推送服务成功后会自动生成，也支持用户自定义设置，提供用户根据 `RegistrationID` 向指定设备推送消息的能力，卸载重装会改变。
+
+### setRegistrationID
+
+自定义设置推送唯一 ID 标识。
+
+#### 声明
+``` java
+public abstract void setRegistrationID(String registrationID, TIMPushCallback callback);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`registrationID`|`String`|自定义推送唯一标识 ID。|
+|`callback`|`TIMPushCallback`|设置结果回调。|
+
+#### 说明
+
+自定义设置设备使用的推送唯一标识 ID，即 `RegistrationID`，需要在注册推送服务之前调用。
+
+`RegistrationID` 是设备的推送唯一标识 ID。默认注册推送服务成功后会自动生成，也支持用户自定义设置，提供用户根据 `RegistrationID` 向指定设备推送消息的能力，卸载重装会改变。
+
+### addPushListener
+
+添加 Push 监听器。
+
+#### 声明
+``` java
+public abstract void addPushListener(TIMPushListener listener);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`listener`|`TIMPushListener`|Push 监听器对象。|
+
+### removePushListener
+
+移除 Push 监听器。
+
+#### 声明
+``` java
+public abstract void removePushListener(TIMPushListener listener);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`listener`|`TIMPushListener`|需要移除的 Push 监听器对象。|
+
+### forceUseFCMPushChannel
+
+指定设备离线推送使用 FCM 通道。
+
+#### 声明
+``` java
+public abstract void forceUseFCMPushChannel(boolean enable);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`enable`|`boolean`|`true` 表示使用 FCM 通道；`false` 表示使用本机通道。|
+
+#### 说明
+
+需要在注册推送服务之前调用。常用于海外推送走 FCM 通道，例如海外小米手机走 FCM 通道。
+
+### disablePostNotificationInForeground
+
+关闭 App 在前台时弹出通知栏。
+
+#### 声明
+``` java
+public abstract void disablePostNotificationInForeground(boolean disable);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`disable`|`boolean`|`true` 表示关闭；`false` 表示开启。|
+
+#### 说明
+
+推送 SDK 收到在线推送时，会自动向通知栏增加 Notification 提示。如果您想自己处理在线推送消息，可以调用该接口关闭自动弹通知栏提示的特性。
+
+## TIMPushListener
+
+`TIMPushListener` 是 Push 监听器抽象类。基类已提供空实现，按需重写以下方法即可。
+
+三个回调的触发时机如下：
+
+|回调|触发时机|
+|---------|---------|
+|`onRecvPushMessage`|App 在线时，收到带 `offlinePushInfo` 的 IM 消息时触发。|
+|`onRevokePushMessage`|App 在线时，收到消息撤回通知时触发。|
+|`onNotificationClicked`|用户点击通知栏消息时触发。包含 App 离线时由厂商通道（小米 / 华为 / OPPO / vivo / 荣耀 / 魅族 / FCM）下发、点击后拉起 App 的场景。|
+
+### onRecvPushMessage
+
+App 在线时，收到带 `offlinePushInfo` 的 IM 消息时触发。App 进程已退出时本回调不会触发。
+
+#### 声明
+``` java
+public void onRecvPushMessage(TIMPushMessage message);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`message`|`TIMPushMessage`|Push 消息对象。|
+
+### onRevokePushMessage
+
+App 在线时，收到消息撤回通知时触发。App 进程已退出时本回调不会触发。
+
+#### 声明
+``` java
+public void onRevokePushMessage(String messageID);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`messageID`|`String`|消息唯一标识。|
+
+### onNotificationClicked
+
+用户点击通知栏消息时触发。无论 App 当时在前台、后台还是已退出（点击通知拉起 App），都会触发。
+
+#### 声明
+``` java
+public void onNotificationClicked(String ext);
+```
+
+#### 参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`ext`|`String`|离线消息透传字段。|
+
+#### 说明
+
+需要先在腾讯云控制台将推送证书的「点击后续动作」配置为「打开应用内指定界面」，并保持默认填充值，否则本回调不会触发。
+
+## TIMPushMessage
+
+`TIMPushMessage` 表示 Push 消息对象，实现 `Serializable` 接口。
+
+### 构造方法
+
+#### 声明
+``` java
+public TIMPushMessage();
+```
+
+### 属性
+
+|属性|类型|说明|
+|---------|---------|---------|
+|`title`|`String`|离线推送标题。|
+|`desc`|`String`|离线推送内容。|
+|`ext`|`String`|离线推送透传内容。|
+|`messageID`|`String`|消息唯一标识 ID。|
+
+### 方法
+
+|方法|返回类型|说明|
+|---------|---------|---------|
+|`setTitle(String title)`|`void`|设置离线推送标题。|
+|`getTitle()`|`String`|获取离线推送标题。|
+|`setDesc(String description)`|`void`|设置离线推送内容。|
+|`getDesc()`|`String`|获取离线推送内容。|
+|`setExt(String ext)`|`void`|设置离线推送透传内容。|
+|`getExt()`|`String`|获取离线推送透传内容。|
+|`setMessageID(String messageID)`|`void`|设置消息唯一标识 ID。|
+|`getMessageID()`|`String`|获取消息唯一标识 ID。|
+|`toString()`|`String`|返回消息对象的字符串描述。|
+
+## 错误码
+
+`TIMPushConstants` 定义 TIMPush SDK 的业务错误码。
+
+|错误码|枚举值|说明|
+|---------|---------|---------|
+|`ERR_INVALID_PARAM`|`800000`|参数不合法。|
+|`ERR_NOT_LOGINED`|`800001`|注册 Push 之前，未登录 IM 账号。|
+|`ERR_INVALID_SDK_APPID`|`800002`|注册 Push 参数 sdkAppID 不合法。|
+|`ERR_REGISTER_PUSH_INIT_FAILED`|`800003`|初始化 SDK 失败。|
+|`ERR_REGISTER_PUSH_CONNECT_FAILED`|`800004`|长链接建立失败。|
+|`ERR_REGISTER_PUSH_FAILED_BUILT_IN_DEVICE`|`800005`|本机通道注册推送失败。|
+|`ERR_REGISTER_PUSH_FAILED_TRY_FCM`|`800006`|本机通道注册推送失败后，尝试 FCM 通道注册失败。|
+|`ERR_REGISTER_PUSH_FAILED_DETECT_CHANNELS`|`800007`|探测所有通道失败。|
+|`ERR_REGISTER_PUSH_FAILED_TIMEOUT`|`800008`|注册推送服务超时。|
+|`ERR_REGISTER_TOKEN_EMPTY`|`800009`|注册推送 token 为空。|
+|`ERR_SET_PUSH_TOKEN_FAILED`|`800010`|给 SDK 设置 token 失败。|
+|`ERR_DISABLE_AUTO_REGISTER_PUSH_FAILED`|`800011`|关闭自动注册失败。|
+|`ERR_DISABLE_REQUEST_POST_NOTIFICATION_PERMISSION_FAILED`|`800012`|关闭推送权限请求失败。|
+|`ERR_CREATE_NOTIFICATION_CHANNEL_FAILED`|`800013`|创建通知 channel 失败。|
+|`ERR_SET_PUSH_CONFIG_FAILED`|`800014`|设置推送配置失败。|
+|`ERR_CALL_EXPERIMENTAL_API_FAILED`|`800015`|实验性接口调用失败。|
+|`ERR_SET_APP_LANGUAGE_FAILED`|`800016`|配置设备语言失败。|
+|`ERR_HTTPS_REQUEST_FAILED`|`800017`|HTTPS 请求失败。|

package/resource/knowledge/push/api-reference/donut.md

@@ -0,0 +1,190 @@
+## 接口概览
+
+|API|描述|
+|---------|---------|
+|setRegistrationID|设置注册推送服务使用的推送 ID 标识，即 RegistrationID，需要在注册推送服务之前调用。|
+|getRegistrationID|注册推送服务成功后，获取推送 ID 标识，即 RegistrationID。|
+|registerPush|注册推送服务 (必须在 App 用户同意了隐私政策，并且确定为 App 用户开始提供推送服务后，再调用该接口使用推送服务)。|
+|unRegisterPush|反注册关闭推送服务。|
+|addPushListener|订阅推送事件，如点击通知栏事件。|
+|removePushListener|取消订阅推送事件。|
+|disablePostNotificationInForeground|应用在前台时，开/关通知栏通知（默认开）。|
+|createNotificationChannel|创建客户端通知 channel。此接口可实现自定义铃音功能。|
+|setCustomBadgeNumber|设置应用角标数字（仅华为、iOS）|
+
+## 接口详情
+
+### 注册推送服务
+
+> **注意：**
+>
+> 必须在 App 用户同意了隐私政策，并且确定为 App 用户开始提供推送服务后，再调用该接口使用推送服务。否则可能因提前获取用户隐私导致上架失败。
+>
+
+#### 接口
+``` typescript
+registerPush(sdkAppID: number, appKey: string): Promise<JSON>;
+```
+
+#### 参数说明
+
+|参数|类型|说明|获取路径|
+|---------|---------|---------|---------|
+|sdkAppID|number|推送（Push）应用 ID|[IM 控制台 > 推送服务 Push > 概览](https://console.cloud.tencent.com/im/push-plugin-push-identifier)<br>|
+|appKey|string|推送（Push）应用客户端密钥||
+
+#### 返回值说明
+
+|返回值|说明|
+|---------|---------|
+|Promise|成功返回 {"errCode":0,"errMsg":"success","data":{"token":"xxx"}}，失败返回 { errCode: number, errMsg: string }|
+
+### 反注册关闭推送服务
+
+#### 接口
+``` typescript
+unRegisterPush(): Promise<JSON>;
+```
+
+#### 返回值说明
+
+|返回值|说明|
+|---------|---------|
+|Promise|成功返回 {"errCode":0,"errMsg":"success"}，失败返回 { errCode: number, errMsg: string }|
+
+### 设置推送 ID 标识 RegistrationID
+
+> **注意：**
+>
+> 需要在注册推送服务之前调用。
+>
+
+#### 接口
+``` typescript
+setRegistrationID(registrationID: string): Promise<JSON>;
+```
+
+#### 参数说明
+
+|参数|类型|必填|说明|
+|---------|---------|---------|---------|
+|registrationID|string|是|设备的推送标识 ID，卸载重装会改变|
+
+#### 返回值说明
+
+|返回值|说明|
+|---------|---------|
+|Promise|成功返回 {"errCode":0,"errMsg":"success"}，失败返回 { errCode: number, errMsg: string }|
+
+### 获取推送 ID 标识 RegistrationID
+
+> **说明：**
+>
+> 需要在注册推送服务成功之后调用。
+>
+
+#### 接口
+``` typescript
+getRegistrationID(): Promise<JSON>;
+```
+
+#### 返回值说明
+
+|返回值|说明|
+|---------|---------|
+|Promise|成功返回 {"errCode":0,"errMsg":"success","data":{"registrationID":"xxx"}}，失败返回 { errCode: number, errMsg: string }|
+
+### 订阅推送事件，如点击通知栏事件
+
+#### 接口
+``` typescript
+addPushListener(eventName: string, listener: (res: any) => void): void;
+```
+
+#### 参数说明
+
+|参数|类型|必填|说明|
+|---------|---------|---------|---------|
+|eventName|string|是|推送事件类型，可查看 Push.EventName|
+|listener|(res: any) => void|是|推送事件处理方法|
+
+### 取消订阅推送事件
+
+#### 接口
+``` typescript
+removePushListener(eventName: string, listener: (res: any) => void): void;
+```
+
+#### 参数说明
+
+|参数|类型|必填|说明|
+|---------|---------|---------|---------|
+|eventName|string|是|推送事件类型，可查看 Push.EventName|
+|listener|(res: any) => void|是|推送事件处理方法|
+
+### 应用在前台时，开/关通知栏通知
+
+#### 接口
+``` typescript
+disablePostNotificationInForeground(disable: boolean): void;
+```
+
+#### 参数说明
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| disable | boolean | 是 | 应用在前台时，开/关通知栏通知，默认开：<br>- true: 应用在前台时，关闭通知栏通知。<br>- false: 应用在前台时，开启通知栏通知。 |
+
+### 创建客户端通知 channel
+
+> **说明：**
+>
+> 如果不同厂商的 ChannelID 各不相同，那么每个 Channel 都需要创建。
+>
+
+#### 接口
+``` typescript
+createNotificationChannel(options: {
+        channelID: string;
+        channelName: string;
+        channelDesc?: string;
+        channelSound?: string;
+    }): Promise<JSON>;
+```
+
+#### 参数说明
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| options.channelID | String | 是 | 自定义 channel 的 ID。 |
+| options.channelName | String | 是 | 自定义 channel 的名称。 |
+| options.channelDesc | String | 否 | 自定义 channel 的描述。 |
+| options.channelSound | String | 否 | 自定义 channel 铃音的音频文件名，不带文件扩展名，音频文件需要放到 xxx/android/nativeResources/res/raw 中。<br>例如：options.channelSound = private_ring，即设置 xxx/android/nativeResources/res/raw/private_ring.mp3 为自定义铃音。 |
+
+#### 返回值说明
+
+|返回值|说明|
+|---------|---------|
+|Promise|成功返回 {"errCode":0,"errMsg":"success"}，失败返回 { errCode: number, errMsg: string }|
+
+### 设置应用角标数字
+
+> **注意：**
+>
+> - 需要在注册推送服务之后调用。
+> - 仅支持华为、iOS。
+
+#### 接口
+``` typescript
+setCustomBadgeNumber(badgeNumber: number): Promise<JSON>;
+```
+
+#### 参数说明
+
+|参数|类型|必填|说明|
+|---------|---------|---------|---------|
+|badgeNumber|number|是|应用角标数字|
+
+#### 返回值说明
+
+|返回值|说明|
+|---------|---------|
+|Promise|成功返回 {"errCode":0,"errMsg":"success"}，失败返回 { errCode: number, errMsg: string }|

package/resource/knowledge/push/api-reference/flutter.md

@@ -0,0 +1,176 @@
+## TencentCloudChatPush
+
+class TencentCloudChatPush：推送插件接口类。
+
+## 接口概览
+
+### 注册/反注册推送服务接口
+
+|API|描述|
+|---------|---------|
+|registerPush|注册推送服务，可选覆盖推送信息来自接口参数 json。|
+|unRegisterPush|反注册推送服务。|
+|setRegistrationID|RegistrationID 是推送接收设备的唯一标识 ID。默认情况下，注册推送服务成功时自动生成该 ID，同时也支持您自定义设置。您可根据 RegistrationID 向指定设备推送消息。需要注意的是，卸载并重新安装设备会更改 RegistrationID，因此需要在注册推送服务之前调用 setRegistrationID 接口。|
+|getRegistrationID|在成功注册推送服务后，可通过调用 getRegistrationID 接口获取推送接收设备的唯一标识 ID，即 RegistrationID。您可根据 RegistrationID 向指定设备推送消息。|
+
+### Push 全局监听接口
+
+|API|描述|
+|---------|---------|
+|addPushListener|添加 Push 监听器。|
+|removePushListener|移除 Push 监听器。|
+
+### 自定义配置接口
+
+|API|描述|
+|---------|---------|
+|forceUseFCMPushChannel|指定设备离线推送使用 FCM 通道，需要在注册推送服务之前调用。|
+|disablePostNotificationInForeground|关闭 App 在前台时弹出通知栏。|
+
+## 接口详情
+
+### 推送插件类
+
+TencentCloudChatPush()：获取 TencentCloudChatPush 推送插件实例，是一个静态单例。后续步骤, 均通过此单例实例, 进行方法调用。
+
+### 成员函数说明
+
+#### registerPush
+
+注册推送服务，IM 账号登录成功后调用。
+
+**示例代码：**
+``` java
+void _onNotificationClicked({required String ext, String? userID, String? groupID}) {
+  print("_onNotificationClicked: $ext, userID: $userID, groupID: $groupID");
+  /// 自定义处理
+}
+TencentCloudChatPush().registerPush(
+    onNotificationClicked: _onNotificationClicked,
+    sdkAppId: 您的sdkAppId,
+    appKey: "客户端密钥",
+    apnsCertificateID: 您配置的证书 ID);
+```
+
+**参数说明：**
+| 参数 | 类型 | 说明 |  |
+| --- | --- | --- | --- |
+| onNotificationClicked | ext | String | 为该消息所携带的完整 ext 信息，由发送方指定, 如果未指定，则有默认值。您可根据解析该字段，跳转至对应页面。 |
+| userID | String? | 本参数对应 userID，自动尝试解析 ext Json String， 获取里面携带的单聊对方 userID 。<br><strong>说明：</strong><br>如果您未自定义 ext 字段，ext 字段由 SDK 或 UIKit 默认指定，则可使用此处的默认解析。如果尝试解析失败，则为 null 空。 |  |
+| groupID | String? | 本参数对应 groupID，自动尝试解析 ext Json String， 获取里面携带的群聊 groupID 信息。<br><strong>说明：</strong><br>如果您未自定义 ext 字段，ext 字段由 SDK 或 UIKit 默认指定，则可使用此处的默认解析。如果尝试解析失败，则为 null 空。 |  |
+| sdkAppId | int? | IM 控制台为您分配的应用 ID。 |  |
+| appKey | String? | IM 控制台为您分配的客户端密钥。 |  |
+| apnsCertificateID | int? | 如单独调用 setApnsCertificateID 方法已配置, 此项可不传。 |  |
+
+#### unRegisterPush
+
+反注册离线推送服务。
+
+**示例代码：**
+``` java
+TencentCloudChatPush().unRegisterPush();
+```
+
+#### setRegistrationID
+
+设置注册离线推送服务使用的推送 ID 标识, 即 RegistrationID，需要在注册推送服务之前调用。
+
+参数说明：
+
+|参数|描述|
+|---------|---------|
+|registrationID|设备的推送标识 ID，卸载重装会改变。|
+
+**示例代码：**
+``` java
+TencentCloudChatPush().setRegistrationID(registrationID: registrationID);
+```
+
+#### getRegistrationID
+
+注册离线推送服务成功后，获取推送 ID 标识，即 RegistrationID。
+
+**示例代码：**
+``` java
+TencentCloudChatPush().getRegistrationID();
+```
+
+#### addPushListener
+
+添加 Push 监听器
+
+**示例代码：**
+``` java
+TIMPushListener timPushListener = TIMPushListener(
+  onRecvPushMessage: (TimPushMessage message) {
+      String messageLog = message.toLogString();
+      debugPrint(
+          "message: $messageLog");
+      },
+
+  onRevokePushMessage: (String messageId) {
+    debugPrint(
+        "message: $messageId");
+  },
+
+  onNotificationClicked: (String ext) {
+    debugPrint(
+        "ext: $ext");
+  }
+);
+TencentCloudChatPush.addPushListener(listener: timPushListener);
+```
+
+#### removePushListener
+
+移除 Push 监听器
+
+**示例代码：**
+``` java
+TIMPushListener timPushListener = TIMPushListener(
+  onRecvPushMessage: (TimPushMessage message) {
+      String messageLog = message.toLogString();
+      debugPrint(
+          "message: $messageLog");
+      },
+
+  onRevokePushMessage: (String messageId) {
+    debugPrint(
+        "message: $messageId");
+  },
+
+  onNotificationClicked: (String ext) {
+    debugPrint(
+        "ext: $ext");
+  }
+);
+TencentCloudChatPush.removePushListener(listener: timPushListener);
+```
+
+#### forceUseFCMPushChannel
+
+指定设备离线推送使用 FCM 通道，需要在注册推送服务之前调用。
+
+参数说明：
+| 参数 | 描述 |
+| --- | --- |
+| enable | - true：使用 FCM 通道。<br>- false：使用本机通道。 |
+
+**示例代码：**
+``` java
+TencentCloudChatPush.forceUseFCMPushChannel(enable: true);
+```
+
+#### disablePostNotificationInForeground
+
+关闭 App 在前台时弹出通知栏。推送 SDK 收到在线推送时，会自动向通知栏增加 Notification 提示，如果您想自己处理在线推送消息，可以调用该接口关闭自动弹通知栏提示的特性。
+
+参数说明：
+| 参数 | 描述 |
+| --- | --- |
+| disable | - true：关闭。<br>- false：开启。 |
+
+**示例代码：**
+``` java
+TencentCloudChatPush.disablePostNotificationInForeground(disable: true);
+```