前提条件

请确保满足以下开发环境要求:

  • Cocos Creator v2.0.9
  • 注册 Cococs Creator 账号,并完成账号认证(系统认证需要 1-3 天)
  • 移动端需要 Android 或 iOS 真机
  • Web 端浏览器需满足特定要求
  • 没有连接 VPN

创建新的项目

如果你的项目已存在,请略过本节内容。

  1. 打开 Cocos Creator,选择新建项目

  2. 新建项目页面,选择空白项目,设置项目所在路径,点击新建项目

至此,一个新项目就创建成功了。你会看到如下界面:

集成 Agora 服务

  1. 在 Cocos Creator 中,打开你的项目。选中面板,在下拉菜单中选择服务,屏幕右边区域会出现服务面板。

  2. 服务面板中选中你的项目名称,然后点击关联。该项目名称是你之前在 Cocos 系统新建的项目名称。

    关联成功后,你的服务面板中就会出现 Agora Service了,如下图所示:

  3. Agora Voice 面板中点击启用按钮,然后在屏幕弹框中点击确定

  4. 根据屏幕提示确认开通 Agora Service 服务。

  5. 开通后,你会在屏幕上看到如下界面。点击前往控制台,进入声网 Dashboard,系统已自动为你注册了一个声网的项目,项目详情内有你的 App ID。

    至此,你就成功地在 Cocos Creator 中为你的项目开通了 Agora Service 的服务,并获取了该项目的声网 App ID。在编译和运行示例代码程序,或调用 API 实现功能时,都需要使用 App ID。

    服务开通后,Cocos Creator 会自动下载和配置所有声网服务依赖的资源。

  6. 在你的项目中,调用 API 实现游戏通话。关键 API 的调用方法及逻辑可参考 HelloAgora Demo

Cocos Creator 提供的 JavaScript API 为方便使用仅实现了主要功能,如果需要其他扩展功能,请参考各平台完整版 API 文档。