跳转至

集成引导

功能介绍

融云基于 Web SDK 发布了小程序 SDK,功能清单和 Web SDK 完全一致:

  1. 支持和移动端、Web 端、PC 端消息互通

  2. 支持用户链接、消息接收、消息发送、会话列表

  3. 支持群组、聊天室系列方法

  4. 支持消息内容安全审核

  5. 支持 Emoji 表情

当前支持

微信小程序 百度小程序 支付宝小程序 字节跳动小程序
Yes Yes Yes Yes

前期准备

  1. 了解融云即时通信系统架构,查看架构说明

  2. 需要具备 JavaScript(尤其是熟悉 ES6)、CSS 开发能力,学习融云官方提供的 Web IM Lib 开发指南

  3. 搭建应用服务器,在应用服务器维护用户信息,群组信息,好友关系等功能,并实现获取 Token 的逻辑,用于连接融云服务器

    搭建应用服务器可参考,融云 SealTalk Server 开源项目,通过应用服务器实现的更多功能查看 Server API 文档

集成说明

  1. 注册为融云开发者

    前往融云官方网站注册创建融云开发者帐号。

  2. 创建应用

    获取 App Key / Secret,它们是融云 SDK 连接服务器所必须的标识,每一个应用对应一套 App Key / Secret。针对开发者的生产环境和开发环境,提供两套 App Key / Secret,两套环境的功能完全一致。应用最终上线前,使用开发环境即可。

  3. 引入 SDK,开通小程序服务后,可在开发者后台小程序服务中下载。

  4. 集成调试

    小程序 SDK 接口使用与 Web IM Lib 接口使用一致,接口使用可参考 Web IM Lib 开发指南

  5. 设置请求超时时间

    代码示例:

    // 配置在微信小程序项目下的 app.json 中
    {
        "pages": [
          "pages/home"
        ],
        "networkTimeout": {
          "request": 41000
        }
    }
    // 配置在百度小程序项目下的 app.json 中
    {
        "pages": [
          "pages/home"
        ],
        "networkTimeout": {
          "request": 41000
        }
    }
    // 无需配置
    // 无需配置
  6. 应用上线

    1) 在小程序后台,设置合法域名(在开发者后台申请小程序上线后获取)

    2) 若调用 重连方法,传入 url 的域名,需在小程序后台设置为合法域名

    3) 融云平台申请上线,获取生产环境配置信息,申请上线前必须在融云开发环境下实现了发送消息测试。查看上线注意事项

参考文档

小程序集成文档

其他文档