跳到主要内容

用户级推送配置

用户级别推送配置是指针对 App 当前登录用户的推送配置。

提示
  • 用户级别推送配置区别于 App Key 级别推送配置。App Key 级别的推送配置针对 App 下所有用户。您可以在融云控制台调整部分 App Key 级别的推送服务配置。
  • 用户级别推送配置要求 App Key 已开通用户级别功能设置。如需开通，请提交工单。

以下配置适用于 IMKit 或 IMLib，或其他依赖 IMLib/IMKit 的客户端 SDK。

设置用户推送通知详情偏好​

在用户未设置偏好的情况下，默认会展示推送通知内容。该功能支持当前登录用户设置自己的推送通知中是否需要展示推送通知的内容详情。

let showStatus = true;
 IMEngine.getInstance().setPushContentShowStatus(showStatus).then(result => {
   if (EngineError.Success !== result.code) {
     // 失败
     return;
   }
   // 成功
 });

如果设置为不显示详情，推送通知将显示为格式文本字符串“您收到了一条通知”（该格式文本字符串支持简体中文 zh_CN、美国英语 en_US、阿拉伯语 ar_SA）。

参数类型说明
showStatusboolean是否显示推送详情。true：显示详情。false：不显示详情。

请注意，发送消息时可以指定 forceShowDetailContent 强制越过消息接收者的该项配置，强制显示推送通知内容详情。以下列出了部分平台的配置：

  • IM Server API：若接口提供 forceShowPushContent 参数，则支持该功能。

您也可以修改 App Key 在融云的默认配置。如有需要，请提交工单申请更改 App Key 级别的 推送通知详情。关闭后，所有推送通知均默认不显示推送内容详情。

设置用户多端时接收推送偏好​

为当前登录用户设置在 Web 端或 PC 端在线时，离线的移动端设备是否需要接收推送通知。请注意，该接口仅在 App Key 已开通 Web/PC 在线手机端接收 Push 服务后可用。

您可以前往控制台的免费基础功能页面修改 App Key 级别配置。

  • 如果 App Key 未开通 Web/PC 在线手机端接收 Push，则所有 App 用户在 Web 端或 PC 端在线时，不在线的移动端不会收到推送。不支持 App 用户修改自己的偏好。
  • 如果 App Key 已开通 Web/PC 在线手机端接收 Push，当前登录用户可自行关闭或开启该行为。
let receiveStatus = true;
 IMEngine.getInstance().setPushReceiveStatus(receiveStatus).then(result => {
   if (EngineError.Success !== result.code) {
     // 失败
     return;
   }
   // 成功
 });

成功设置为 false 后，当前用户如果在 Web/PC 端在线，则移动端不会接收推送通知。

参数类型说明
receiveStatusboolean其它端在线时，移动端是否接受推送。true：接收推送。false：不接收推送。
最后于 更新