Android
原生应用接入;重点确认系统版本、后台连接策略和推送通道。
Kotlin / Java 接入评估从跨平台 IM SDK 到服务端 REST API,先理解身份、连接、会话与消息的协作关系。这里提供安汇聊接入流程概览和示意代码,正式 SDK 包、接口版本与下载方式需在接入时确认。若需先了解长连接、心跳或接口用语,可查阅安汇聊即时通讯术语表。
平台范围用于前期选型。可用版本、支持的消息能力、最低系统要求与授权范围,以项目提供的 SDK 文档为准。
原生应用接入;重点确认系统版本、后台连接策略和推送通道。
Kotlin / Java 接入评估原生应用接入;确认系统版本、应用生命周期及通知权限。
Swift / Objective-C 接入评估网页产品接入;确认浏览器兼容、连接恢复和跨域配置。
JavaScript / TypeScript 接入评估宿主环境接入;确认网络域名配置、生命周期和平台限制。
按宿主平台分别适配跨平台应用接入;确认原生桥接、插件版本及推送依赖。
Dart 与原生能力适配由服务端签发用户凭证,处理业务消息、回调与权限校验。
接口与鉴权方式按版本确认下方代码仅解释接入步骤,未声明任何真实包名、下载地址或可调用接口。获取 SDK 后,请按对应版本文档替换方法、事件与参数。
// 接入流程伪代码,不是已发布 SDK 的可执行接口。
// im 代表项目实际选用的 SDK 实例;请替换为正式 API。
// 1. 向自己的业务服务获取短期访问凭证
const { token } = await yourBackend.getChatToken();
// 2. 先监听消息,再连接(具体顺序以 SDK 文档为准)
im.onMessage((message) => {
renderAsText(message.text); // 安全渲染,避免直接插入 HTML
});
await im.connect({ token });
// 3. 向已获授权的会话发送一条消息
await im.send({
conversationId: 'YOUR_CONVERSATION_ID',
type: 'text',
text: '你好,欢迎使用安汇聊'
});
// 生产接入还需处理:凭证到期、重连、去重和发送失败。
适合由业务系统触发消息、管理账号凭证或对接Webhook 回调。请求签名、权限模型、错误码和限流策略均需依据正式接口文档实现。相关概念也可对照REST API释义理解。
# REST 请求结构示意;域名、路径与字段均为占位。
# 不是可调用接口。正式鉴权可能包含签名等额外步骤。
# 仅在服务端执行;服务端密钥不得放入 APP 或 Web 代码。
curl --request POST \
'https://im-api.example.invalid/v1/messages' \
--header "Authorization: Bearer ${IM_SERVER_TOKEN}" \
--header 'Content-Type: application/json' \
--data '{
"recipient": "YOUR_USER_ID",
"type": "text",
"content": "你的服务进度已更新",
"request_id": "YOUR_UNIQUE_REQUEST_ID"
}'
# 业务侧需要检查响应、记录结果,并实现幂等与退避重试。
回调处理需核验签名与时间范围,按事件标识去重。消息重试应采用退避策略,避免重试风暴;发送结果与业务状态分别记录。
本页用于接入完成后的验证。若还在确认要做哪些即时通讯能力,请先使用安汇聊即时通讯定制需求清单整理范围,再回到这里核对身份、消息、推送和运维路径。
验证凭证只允许访问授权的会话。
用真实设备验证正常和异常网络。
先确定口径,再验证指标。
验证消息与业务状态保持一致。