快速开始 Demo 是火山引擎 IM 提供的基本即时通讯 IM 功能的开源示例工程文件。获取该工程文件后，你可以快速构建应用，感受即时通讯 IM 功能；也能通过阅读代码，了解基本即时通讯 IM 的最佳实践。

应用使用说明

使用该项目构建应用后，你可以使用该应用进行 IM 消息的即时发送与接收。你和你的同事必须使用同一个 AppID，才能实现消息的收发，不同的 AppID 之间无法实现互通。

前提条件

• 根据开通服务获取 AppID

• node（推荐使用 Node.js 官方 LTS 版本 18）

• IM 快速开始 Demo 工程文件，你可以通过 ZIP 包或 GitHub 仓库获取

操作步骤

步骤 1：配置 Demo 工程文件

使用任意的编辑器，编辑 Web Demo 项目 src/constant/index.ts，修改 APP_ID 为自己应用的值。

如需体验海外环境，还需将 IS_OVERSEA 设为 true，demo 会自动连接到海外端点。

步骤 2：编译运行

1. 在 Web Demo 项目根目录，运行 npm install 安装开发依赖。

2. 安装依赖后，运行 npm run start 启动开发服务。

3. 启动完成后，开发服务会自动拉起浏览器访问 http://localhost:5000/rtc/solution/im，如无跳转可自己手动开启页面。

步骤 3：使用软件

1. 打开页面后，需要输入用户 ID 和用户 Token 用于登录 IM 系统，临时 Token 可通过控制台生成

2. 输入完成后点击登录，即可进入到聊天页面体验。

常见问题

1. Demo 运行后提示配置 APP_ID。
   解决方法：按照前文步骤 1：配置 Demo 工程文件配置 APP_ID。

2. Demo 运行后提示初始化失败。
   解决方法：按照提示检查 SDK 配置和登录时填入的 Token，并尝试清空浏览器存储后重新访问。