我们在去年推出了Agora RTC SDK Unity 版,并上线 Unity Asset Store。随着 Unity 社区需求的不断增加,近期 Unity 版的声网Agora 实时消息 RTM SDK 已经上线社区。利用该 SDK,你可以将游戏中的消息聊天、游戏控制指令功能,快速集成到 Unity3D 应用程序中。与Unity 版声网Agora RTC SDK 配合,可实现更丰富的实时互动游戏场景。
01
什么是 RTM?
02
在 Unity 中可实现哪些场景?
03
如何在 Unity 使用 RTM SDK?
接下来,我们将通过 Unity 版 RTM SDK 的演示 Demo,展示 RTM SDK 可在 Unity3D 应用程序中实现的功能。
接下来,我们将通过 Unity 版 RTM SDK 的演示 Demo,展示 RTM SDK 可在 Unity3D 应用程序中实现的功能。
环境要求
-
Unity3D 2017或更高版本 -
真实设备(Android、iOS、Windows、macOS均可)或模拟器
操作步骤
获取声网 App ID
1. 访问声网官方网站(Agora.io),注册开发人员账户。
2. 登陆后在开发者控制台,从左侧列表进入【项目管理】页面,【创建】一个新项目。
3. 在列表中即可查看项目的 App ID。
App ID 是 Agora 为开发项目生成的字符串,是项目的唯一标识。当开发者在 Agora 控制台创建项目时,控制台会自动生成 App ID 用于标识这个项目。
获取 Demo 项目
1. 在官方GitHub仓库,获取最新的 RTM SDK Unity 版,目前最新版本为 RTM SDK_1.4.2.301.1.unitypackage 。
2. 将仓库代码通过 Git 克隆到你的主机上,用 Unity 载入已经克隆到本地的项目,即 Unity-RTM-Demo 文件夹。
配置与运行
1. 从 Unity 的菜单栏选择 Assets - Import Package - Custom Package。找到之前下载的 SDK 文件进行导入。
2. 在 Unity 的 Hierarchy 列表中,找到 MainScene - ChatManager。
3. 找到属性设置列表,在 Agora Properties 下的 App Id 项目中,填写我们之前已经获得的项目 App ID。
4. 通过菜单栏 File - Build Settings 设置你需要运行的平台,之后可通过 Unity 界面上的 Play 按钮直接运行 Demo,或者通过菜单栏 File - Build And Run 来编译运行。如果要部署到 Windows、Mac、Android 和 iOS,只需遵循常规的 Unity 部署工作流程即可。
-
设定频道名 Channel Name(如:123),点击 JOIN 加入频道。Web 端注意设定相同的 App ID 和 频道名,即可与 Unity 端进行通讯。 -
如果两端成功加入相同频道,将会在频道内显示用户成功加入的消息。在 Unity 端 Channel Message 输入内容,点击 SEND 进行发送,可以在 Web 端成功看到我们刚刚输入的消息。 -
点击 Channel Member Count,可对当前加入的频道,进行人数查询。点击 Leave 可以离开当前频道。
-
在 Peer ID 中,输入想要发送消息对象的 Account Name / Peer ID(如:Web)。在 Peer Message 中,输入发送消息的内容。点击 SEND 进行发送,即可在 Web 端看到我们刚刚发送的消息。
-
在 Query Member 中,输入想要查询在线状态对象的 Account Name / Peer ID(如:Web),点击 QUERY 即可返回查询结果,如 PEER_ONLINE_STATE_ONLINE 即代表当前用户在线。
04
加入交流、吐槽
以上为声网实时消息 RTM SDK 在 Unity 的集成步骤。我们还会分享 Unity RTM Demo 的源码详解,以便不熟悉 RTM SDK 的开发者快速了解其中的接口与调用。

