主动推送不依赖 Sender 的回复目标。你需要指定目标 IM、群或用户。群推送传 groupCode;私聊推送传 userID。
函数总览
push(...)
目标 IM 类型,例如 qq、weixin、qx,以已启用适配器为准。
目标账号 ID。也可写作 accountID 或 accountId。显式传入时优先级最高。
推送账号选择
以下规则适用于 push(...)、pushImage(...)、pushVoice(...)、pushVideo(...)、pushFile(...) 和 pushMixed(...)。
选择规则:
- 如果
options 中有 account_id,使用它。
- 如果是消息触发,并且目标 IM 与当前会话 IM 一致,默认使用当前会话账号。
- 如果是 cron / fake,使用目标 IM 的默认账号。
- 如果跨 IM 推送,使用目标 IM 的默认账号。
- 如果目标 IM 没有默认账号,运行时会选择第一个在线可发送账号;没有可发送账号时返回
0 或抛出适配器离线错误。
能确定发送账号时,优先显式传 options.account_id。这比依赖“当前会话账号”或“目标 IM 默认账号”更稳定。
媒体推送
所有主动推送 helper 都支持 options 和 timeout。options.account_id / accountID / accountId 可显式指定发送账号;filename / fileName / file_name 与 mimeType / mime_type 用于补充媒体元数据。
返回值
主动推送返回成功发送的目标数,通常是 0 或 1。如果适配器返回错误,SDK 会抛出 Exception。
下一步