快速上手
本教程旨在帮助开发者快速了解和掌握 IMLib SDK(融云即时通讯能力库)的基础集成流程与核心通信通能力。通过本教程,您将完成从 IMLib SDK导入、初始化、设置监听、建立连接和发送消息等全流程操作。
准备工作
- 访问融云控制台,注册您的开发者账号。注册成功后,控制台自动在开发环境中为您创建一个应用。
- 在控制台的基本信息页,获取您的应用在开发环境的 App Key。您可在基本信息页查看应用的信息,如 App Key、App Secret、所属数据中心(默认为北京)。
如您想自己创建应用参考如何创建应用,并获取对应环境 App Key 和 App Secret。
提示
- 每 个应用均拥有两个不同的 App Key,分别对应开发环境与生产环境,且两个环境之间数据相互隔离。在您的应用正式上线前,建议切换到生产环境的 App Key,以便完成上线前全流程测试和最终发布。
- App Secret 用于生成数据签名,仅在请求融云服务端 API 接口时使用。本教程中暂不涉及。应用的 App Key / Secret 是获取连接融云服务器身份凭证的必要条件,请注意不要泄露。
导入 SDK
提示
IMLib 对 Typescript 的使用者提供了友好的类型化支持,推荐开发者使用 Typescript 进行业务开发以提升代码健壮性及可维护性。
NPM 引入(推荐)
-
依赖安装
bashnpm install @rongcloud/engine@latest @rongcloud/imlib-next@latest -S
-
代码集成
JavaScript// CommonJS
const RongIMLib = require('@rongcloud/imlib-next')
// ES Module
import * as RongIMLib from '@rongcloud/imlib-next'
CDN 链接引入
html
<script src="https://cdn.ronghub.com/RongIMLib-5.9.5.prod.js"></script>