声网实时游戏语音服务已在 Cocos Creator 正式上线
2019.04.04 by cocos
品牌新闻

1 月 8 日,Cocos 宣布与实时音视频服务提供商声网 Agora,基于游戏开发引擎和小游戏平台展开战略级别的深入合作,双方在移动游戏开发、实时音视频两项能力上实现互通、互补。

双方的战略合作,一方面,能让更多使用 Cocos Creator 的开发者可以在游戏中快捷便利地加入实时音视频开黑功能;另一方面,可以帮助 Agora 开发者为 App 增加小游戏的能力,增强互动、趣味性。

为开发者带来的便利具体包括:

  • 在 Cocos Creator 中深度集成声网 SDK。也就是说,如果你是 Agora 开发者,同时也是 Cocos 开发者,未来当你使用 Cocos Creator 开发游戏时,只需要选择开启 Agora 服务,便可快速地为游戏增加实时语音或实时视频通话能力。由于双方都是提供面向全球的技术服务,所以你的游戏玩家也可以实现跨地区跨国的实时语音通话。
  • 声网将深度集成 Cocos 小游戏平台项目。Agora 开发者只需选择接入 Cocos 小游戏平台,即可在其 App 中接入 Cocos 提供的对战类、休闲类及重度小游戏能力。

目前,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
  • 移动端需要 Android 或 iOS 真机
  • Web 端浏览器需满足特定要求
  • 没有连接 VPN

在开始进行开发前,大家需要确保已经安装 Cocos Creator v2.0.9,因为以下操作将通过新版 Cococs Creator 来实现。同时,由于实时语音功能需要调用麦克风,所以大家还需要准备好Android 或 iOS 真机为了保证第一次尝试的效果,建议大家关闭设备端的 VPN。

另外,如果你开发的是Web 游戏,那么你的 Web 端浏览器还需要满足一些特定要求,详见声网文档中心:

https://docs.agora.io/cn/Interactive%20Gaming/game_c?platform=Cocos%20Creator

首先在 Cocos Creator 中打开你的游戏项目,然后选中面板,在下拉菜单中选择服务

在屏幕右侧出现的服务面板中选择AgoraVoice,并点击启用。Cocos Creator 会自动下载和配置所有声网服务依赖的资源。

至此,您已经为您的游戏添加了实时语音服务,接下来需要通过 JS 调用 Agora SDK 的接口来实现实际功能了。

注:点击面板右上方的 Sample 工程可以查看开源 Sample code。

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,可以点击【阅读原文】获取。如果在开发过程中遇到疑问,可以在Cocos 开发者社区(forum.cocos.com)或RTC 开发者社区 (rtcdeveloper.com)提问交流噢。

接下来,值得期待的新功能

大家已经可以通过最新版 Cocos Creator 使用以上服务,在游戏中快速实现实时语音功能。接下来,声网还将在 Cocos Creator 中为开发者们提供实现游戏视频通话的功能,敬请期待!

目前,包括小米、完美世界、阿里游戏、SuperEvil 等知名游戏团队,已经采用 Agora SDK 在游戏中实现实时音视频互动功能。

Cocos Service 也将秉持着“让游戏开发更简单”的宗旨,甄选优质技术服务提供商,为各位开发者提供质优价廉的接入服务。

Cocos 技术派|重度小游戏技术实现方案

Cocos 引擎正式支持百度小游戏

Cocos 与声网达成战略合作

Cocos 引擎正式集成 Matchvs