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

应用使用说明

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

前置条件

• 根据开通服务获取 AppID 和临时 Token

• macOS 13.0 或以上版本设备，且可以正常访问互联网

• Cmake 3.21 以上版本

• Xcode 13 以上版本

• QT 5.15.2 或以上版本

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

操作步骤

步骤 1：配置 Demo 工程文件

1. 进入 Demo 根目录，将 CMakeLists.txt 中 CMAKE_PREFIX_PATH 变量设置为QT目录。

2. 执行 script 文件夹下 make_mac_proj.sh 脚本生成 Xcode 工程。

3. 使用 Xcode 打开生成项目文件夹。

4. 搜索并打开 ve_login_model.h文件， 你需要在该界面 APP_ID、TOKEN和 UID 后分别填入你在控制台上获取的 AppId、临时 Token 和用户 ID。

注意：

• 如果你没有 AppID 和临时 Token，参看开通服务。

• 如果没有向 APP_ID 、TOKEN 和 UID 填入相应的值，会导致编译不通过。

步骤 2：编译运行

1. Xcode 选择 veIM 选项。

2. 点击菜单栏 Product -> Run，编译并运行 Demo。

步骤 3：使用软件

1. 编译成功并运行，将自动跳转至应用的主页面。如果你想体验不同用户间收发消息效果，你需要使用不同的用户 ID 和对应的临时 Token 编译运行快速开始 Demo。

2. 应用界面如下图所示。点击"创建直播群"，并确认直播群名称和头像，即可创建直播群会话。

3. 创建成功后，可以发送和接收消息。

常见问题

1. Demo 运行后，出现错误提示。 解决方案：SDK 内部遇到不可恢复的错误，参看错误码。