SDK 参数与返回对象 | 泡泡 IM 开发文档

SDK 方法调用与 HTTP 请求是两层接口。宿主一般调用 SDK；SDK 负责网络请求、消息缓存和界面。本页解释宿主接入时使用的对象，具体方法见各平台参考。
用户 ID 是宿主系统提供的稳定 ID，不能用昵称代替。昵称用于展示，头像使用 URL。没有头像时原生平台与 uni-app 可传空字符串。可选账号、签名和属地按各平台构造函数省略或传空值；Web 的可选字段省略即可。
各平台的 IMAuth 或 PopoAuthInfo 都包含三项：
authProvider 是宿主实现的取凭证函数：依据宿主自己的登录态请求后端，再返回此对象。完整流程见认证与登录，后端实现见多语言示例。不要把 sdkSecret 放到客户端，也不要在客户端自行生成 Token。
Android 使用 PopoConversationTarget.friend(userId) 或 .group(groupId)；iOS 和 HarmonyOS 也提供同名创建方法。它们返回对应平台的会话目标对象，参数无效时按平台抛出错误。
均为当前总数，范围 0–100，100 可展示为 99+。收到回调后替换宿主角标，不要累加。
Android PopoCallback 的 onComplete(error)、iOS PopoCompletion 的 error，为空表示成功；有值表示失败。方法本身通常返回 void/Void，结果通过回调送达。Android 和 iOS 的宿主完成回调在主线程处理。
HarmonyOS 与 uni-app 主要使用 Promise。Promise<void> 完成时没有业务数据，失败进入 catch；Promise<boolean> 则用布尔值表示该方法说明的结果。
Web 的错误规则见 Web 方法参考。错误不等于全部需要重新登录：网络失败保留可读界面，认证失效才重新通过宿主取票。
原生 SDK 的 cacheSize 返回可清理的媒体缓存字节数；clearCache 返回清理后剩余的字节数。清理不会删除聊天记录、草稿或待发送内容。显示给用户时再换算为 MiB。