Cocos Creator 从 v2.0.9 版本开始,已经深度集成了声网 Agora Voice SDK,广大Cocos开发者可以一键开通、下载并集成声网SDK到所需游戏项目,并且能在 Creator 中通过统一JS APIs 来调用声网 Agora iOS/Android/Web SDK 接口,在各平台项目中快速实现实时语音功能。接下来我们来简单讲解一下。
在 Cocos Creator 中快速实现游戏语音功能
在开始进行开发前,大家需要确保已经安装 Cocos Creator v2.0.9,因为以下操作将通过新版 Cococs Creator 来实现。同时,由于实时语音功能需要调用麦克风,所以大家还需要准备好 Android 或 iOS 真机。为了保证第一次尝试的效果,建议大家关闭设备端的 v*n。
另外,如果你开发的是 Web 游戏,那么你的 Web 端浏览器还需要满足一些特定要求,详见声网文档中心(docs.agora.io)。
首先在 Cocos Creator 中打开你的游戏项目。然后选中 面板
,在下拉菜单中选择 服务
。
在屏幕右侧出现的 服务面板
中选择 AgoraVoice
,并点击 启用
。Cocos Creator 会自动下载和配置所有声网服务依赖的资源。
至此,我们已经为 Cocos 游戏添加了实时语音服务,接下来需要通过 JS 调用 Agora SDK 的接口来实现实际功能了。
JS 调用 Agora SDK 接口
首先我们需要先登录 Agora DashBoard ,在 项目
页面中获取自己的 App ID。然后将它填写到下述代码中。
-
var agoraCreator = require("agoraCreator");
-
-
agoraCreator.createEngine("AGORA APP ID");
我们支持通过 JS 来调用 SDK 接口。例如,可以通过 .setChannelProfile(profile)
来设置频道模式,如果你希望在游戏中进行一对一或群聊,并且任何用户都可以*说话,那么设定 profile
为通信模式(profile 为 0)即可;如果是想实现类似团战指挥的场景,那么可以采用直播模式(profile 为 1),然后利用 setClientRole
来设定“指挥者”的角色。
另外,开发者还可以通过 JS 接口来设置本地语音音效均衡、本地音效混响、音效音量等功能。如果希望了解详细的接口功能,参考 Demo,可以点击「阅读原文」获取。如果在开发过程中遇到疑问,可以在 RTC 开发者社区 (rtcdeveloper.com)提问。
接下来,值得期待的新功能
大家已经可以通过最新版 Cocos Creator 使用以上服务,在游戏中快速实现实时语音功能。接下来,我们还将在 Cocos Creator 中为开发者们提供实现游戏视频通话的功能,敬请期待。
目前,包括小米、完美世界、阿里游戏、SuperEvil 等知名游戏团队,已经采用 Agora SDK 在游戏中实现实时音视频互动功能。