You need to enable JavaScript to run this app.
导航
iOS
最近更新时间:2024.08.29 11:56:10首次发布时间:2023.06.20 18:07:25

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

应用使用说明

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

前提条件

  • Xcode 14.1+

  • iOS 11.0+ 设备

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

步骤 1:配置 Demo 工程文件

  1. 使用 Xcode 打开 VolcengineRTC_QuickStart_iOS 文件夹中的 ByteBusiness.xcworkspace 工程文件

  2. 请在该界面 kVEIMDemoAppIDkVEIMDemoTokenkVEIMDemoUserID 后分别填入你在控制台上获取的 AppId、临时 Token、用户 ID。demo工程默认为国内环境,如果要切换海外环境,请参看集成方案

    注意

    • 如果你没有 AppID 和临时 Token,参看开通服务
    • 如果没有向 kVEIMDemoAppIDkVEIMDemoTokenkVEIMDemoUserID 填入相应的值,VEIMDemoDefine.h 文件会不符合 Objective-C 语法规范,导致编译不通过。

步骤 2:配置开发者证书(可选,也可使用模拟器)

  1. 登录 Apple ID。
    1. 选择 Xcode 页面左上角 Xcode > Settings,或通过快捷键 Command + , 打开 Preferences。

    2. 选择 Accounts,点击左下部 +,选择 Apple ID 进行账号登录。

  1. 配置开发者证书。
    1. 单击 Xcode 左侧导航栏中的 ByteBusiness 项目,选择 Signing & Capabilities > Automatically manage signing 自动生成证书,也可以通过 Apple 官网手动配置,下载证书。

    2. Team 中选择 Personal Team。

    3. Bundle Identifier 默认的 com.ss.iphone.ucenter.cn.inhouse 已被注册, 将其修改为其他 Bundle ID,格式为 com.xxx

步骤 3:编译运行

  1. 连接并选择你的 iOS 真机设备或者模拟器。

  2. 选择 Product > Run,或通过快捷键 Command + R 运行。

步骤 4:使用软件

  1. 安装成功后,设备屏幕将自动跳转至 QuickStart 应用的登录页面。

  2. 阅读用户协议和隐私政策,同意后点击登录。如果你想体验不同用户间收发消息的效果,你需要使用不同的用户 ID 和对应的临时 Token 编译运行快速开始 Demo。

alt

  1. 登录成功后,应用界面如下图所示。点击右上角可以发起单聊和群聊会话。

  1. 创建成功后,会话详情页可以发送和接收消息。

常见问题

  1. Demo 运行后,出现错误弹窗。
    解决方案:SDK 内部遇到不可恢复的错误,参看错误码