SDK 总览：带 UI 的即时通讯接入 | 泡泡 IM 开发文档

Popo IM SDK 是带 UI 的即时通讯 SDK，可以把现成的消息列表、通讯录、好友与群聊界面嵌入你的网站或 App，同时处理消息收发、同步与缓存。你可以沿用已有的用户账号，无需让用户再注册一套 IM 账号。本文把你的网站或 App 称为“宿主”：你保留现有的账号系统和主导航，SDK 负责聊天内部流程。
完整接入分为两部分：业务后端确认用户身份并获取 IM Token，客户端 SDK 用 Token 加载聊天。前端和后端可按下面的顺序分别接入。
每个平台都按从简单到深入的顺序提供两页文档：
只使用 SDK 自带界面时，大多数进阶方法都用不到。 不需要自己逐个调用发送消息、创建群、处理好友申请等 HTTP 接口，也不需要重写这些界面。平台必要的权限、前后台通知等接线已放在快速接入中；按需启用的能力另有说明。
Web + H5 版、uni-app 版和原生版按所选版本交付服务端、对应客户端与 SDK，独立选购；文档列出所有平台，不表示每个版本都包含全部客户端。具体交付范围见版本与价格，源码目录见项目目录。
各端均提供单聊、群聊、文字、图片、语音、视频、文件、名片、搜索和二维码等界面。入口是否显示、媒体大小及通话权限由服务端配置决定；群通话不在当前支持范围。uni-app 的原生通话还需要宿主接入媒体插件与展示页，详见该平台说明。
本表是将 SDK 嵌入自有产品时的支持范围。uni-app 客户端可编译的平台与嵌入式 SDK 的支持范围不同；当前 uni-app SDK 快速接入面向 Android App 和 iOS App，网站接入使用独立 Web SDK。
后端先验证取 Token 接口，再开始客户端接入。Token 是当前用户进入聊天的临时凭证；初始化只登记配置，在你产品的用户登录成功后调用 SDK login()，它取得凭证并完成首次同步后才报告成功。
宿主通过公开入口打开会话，不需要读取 SDK 内部状态或自行拼接聊天页路径。发送消息、修改关系、建群等常规操作由 SDK 界面完成；公开宿主 API 不等于内部所有实现类。
业务后端的取 Token 接口、你的产品导航与业务页面仍需自行开发。业务后端语言无需与 IM 服务端相同，可通过 HTTP 接口获取凭证；后端认证示例提供 PHP、Java、Go、JavaScript 和 C# 实现。
音视频通话需要部署自建通话服务，并完成各平台要求的媒体模块、权限和页面接线；离线系统通知还依赖平台推送服务与宿主接入。App 上架与业务功能按你的产品要求另行完成。服务端和客户端的网络条件见私有化部署与外部依赖。
发布前至少完成一次完整流程：陈悦登录后与林舟互发消息，进入聊天清除未读；切到后台再返回，确认新消息补齐；断网时保留可读内容，联网后恢复；退出后不再接收旧账号数据，切换账号后只显示新身份内容。
图片、语音、视频和通话还需在目标浏览器或真机验证权限拒绝、取消操作与重新进入。编译通过不能替代这些交互验证。
先完成上面对应平台的快速接入，需要额外控制时，再到下面按场景查找。每个方法先说明用途，再解释需要填写的参数和操作结果，无需一次读完：