接收可靠业务通知

事件订阅event.reliable_business_notification

PLATFORM API

选择接入平台

平台选择会在 API 页面之间保留。下面始终展示该端真实公开入口。

当前平台iOSmacOSAndroid · JavaAndroid · KotlinWindowsHarmonyOSFlutterWebElectron小程序

移动端

桌面端

Web 与小程序

跨平台

iOS · Swift · Completion公开调用入口

reliableBusinessNotificationReceived(查看 iOS 接入准备 →

调用参数

• onEvent@escaping XHIMEventCallback必填

  事件回调；用于刷新当前页面依赖的数据。

返回与后续处理

返回或保存取消订阅句柄。事件到达后重新查询当前页面数据。

可复制代码

eventToken = client.addEventListener { event in
    // 按事件类型刷新数据或页面
}

功能说明

event.reliable_business_notification 属于“事件订阅”。上方平台选择器会显示当前端的真实方法名、参数和调用示例。

• 调用前提： 连接成功后立即订阅事件；收到变化后重新查询当前页面数据。
• 详细规则： 查看本分类的参数和状态说明。
• 跨端提醒： 各端方法名遵循各自语言习惯，请直接复制当前平台的示例。

参数与调用方式

页面顶部会列出必填/可选参数、参数用途和可复制代码。iOS/macOS 默认使用 onSuccess/onFailure，Android 默认使用 Java CompletableFuture；Web、Electron 和小程序未提供的能力会明确显示“不支持”，不会给出无效示例。

需要幂等键或版本号的方法，请使用上一次成功查询返回的值；不要自行猜测或拼接。

返回、错误与取消

结果	应用怎么处理
成功	使用返回结果刷新当前数据或页面；收到后续事件时再重新查询。
invalid_argument	检查空值、数组数量、重复 ID 和页面标注的版本参数。
invalid_state	确认当前账号已连接，并且没有在登出或换号。
unsupported	当前 SDK 或服务端版本没有此能力；提示升级，不要当成空结果。
request_cancelled	停止当前等待；写操作再查询一次结果，避免重复提交。

完整错误字段见 模型、枚举与错误。