CocosCreator 集成 Pomelo 教程

本文出自 Eddy Wiki ，转载请注明出处：http://eddy.wiki/creator-pomelo.html

本文主要介绍怎么在 CocosCreator 中集成 Pomelo， 以及使用CocosCreattor + Pomelo 开发一个多人聊天应用。

使用 Pomelo 官方多人聊天 demo（下文统一称为 pomelo-chat-demo）的服务端代码作为本多人聊天应用的服务端，而本聊天应用客户端（下文统一称为 ccc-pomelo-chat-client）则是参考 pomelo-chat-demo 的web客户端使用CocosCreattor实现。

怎么运行ccc-pomelo-chat-client

本人开发环境

CocosCreator 1.1, Pomelo 1.2.2, MacOS 10.10.3

安装 pomelo

参考 安装 pomelo wiki 安装 pomelo。

pomelo-chat-demo 源码下载与运行

ccc-pomelo-chat-client 服务端使用的是 pomelo-chat-demo 的服务端，并没有另外开发，这样可以很方便的展示多人聊天应用的多端（Web, Android, desktop等）聊天通讯功能。

参考 pomelo chat 源码下载与安装 wiki 下载 pomelo-chat-demo 源码。

下载源码后，通过下列步骤来运行 pomelo-chat-demo。下文使用 yourdir 指代你本地 pomelo-chat-demo 源码的存放目录。

打开终端，启动 pomelo-chat-demo 的聊天服务器。

$ cd yourdir/chatofpomelo-websocket/game-server 
$ pomelo start

打开另外一个终端，启动 pomelo-chat-demo 的 web 服务器。

$ cd yourdir/chatofpomelo-websocket/web-server
$ node app.js

如果启动过程中没有错误，那么我们就可以打开浏览器，输入 http://127.0.0.1:3001/index.html, 然后就可以看到聊天应用的界面了。输入一个用户名和一个房间名，就可以开始聊天了。可以多开几个客户端实例（即打开多个网页），测试 pomelo-chat-demo 是否能正常地运行。效果图如下：

那么怎么关闭 pomelo-chat-demo 的聊天服务器呢，其实很简单。打开另外一个终端

$ cd yourdir/chatofpomelo-websocket/game-server 
$ pomelo stop 或 pomelo kill

注意：如果不是按以上步骤关闭聊天服务器，那么当你再次启动聊天服务器的时候，就有可能因为聊天服务器未完全关闭而出现错误。出现这种情况可以直接关闭启动聊天服务器的终端（这样聊天服务器就被完全关闭了），然后重新打一个终端启动聊天服务器。

ccc-pomelo-chat-client源码下载与运行

下文使用 yourdir 指代你本地 ccc-pomelo-chat-client 源码的存放目录。

从GitHub上下载 ccc-pomelo-chat-client 源码。

$ cd yourdir
$ git clone https://github.com/eddy2015/ccc-pomelo-chat-client.git

使用 CocosCreator 打开 ccc-pomelo-chat-client 项目并运行预览（模拟器和浏览器都行），效果图如下：

经本人测试，该客户端在web、Android、ccc模拟器都可以正常运行，其他平台请自行尝试。服务器 ip 地址默认为 127.0.0.1，如果你是在 Android 等其他不和服务器同一台机器平台运行，请把该 ip 修改成你启动服务器的电脑 ip 地址。端口默认为 3014，这个一般不需要修改，除非你改动了服务器端的代码。输入一个用户名和一个房间名（用户名和房间名限制了只能是字母、数字、或汉字），然后点击 join 按钮登陆后就可以进行一对多或者一对一聊天了。

CocosCreator 怎么集成 pomelo

集成 pomelo 步骤

下载 ccc-pomelo-chat-client 源码，把源码中的 ccc-pomelo-chat-client/assets/pomelo 拷贝到你的 CocosCreator 项目 assets 目录下，这样在你的项目中即可使用 pomelo-client 相关 API 了。

API请阅读 pomelo/pomelo-client.js 源码，具体使用方法可以参考 ccc-pomelo-chat-client 源码，或者参考以下网址：

1. pomelo 官方中文 wiki
2. pomelo-chat-demo 源码
3. pomelo 客服端开发

集成后的会出现的一些警告

CocosCreator 项目集成 pomelo 后，你会在 CocosCreator 编辑器中看到如下的红色错误信息：

Simulator : mutating the [[Prototype]] of an object will cause your code to run very slowly; instead create the object with the correct initial [[Prototype]] value using Object.create
    at a: "Buffer.prototype.__proto__ = Uint8Array.prototype" (../../../../../../../Applications/CocosCreator.app/Contents/Resources/app.asar/node_modules/buffer/index.js:153)

或者在 web 上运行时，看到下列警告信息：

mutating the [[Prototype]] of an object will cause your code to run very slowly; instead create the object with the correct initial [[Prototype]] value using Object.create

以上的警告信息并不影响 pomelo 的使用。由于本人水平有限，所以暂时没有解决该警告问题，如果各位有解决方法，请指出。

该 CocosCreator pomelo 库由来

由于前一段时间对 pomelo 比较感兴趣，所有就去了解了一下。最近也一直在关注 CocosCreator，看到论坛有不少人问 CocosCreator 是否能集成pomelo。根据我个人的理解：CocosCreator 实现了 websocket 的跨平台封装；而 pomelo 也有基于 websocket 的客户端实例。因此，CocosCreator 集成 pomelo 应该不会有什么问题的。刚好端午节有空就尝试集成了一下，然后就有了这篇文章和 ccc-pomelo-chat-client。

ccc-pomelo-chat-client 中的 pomelo 库生成过程：

1. 拷贝 chatofpomelo-websocket/web-server/public/js/lib/components/component-emitter/index.js 文件并修改文件名为 emitter.js，在 emitter.js 文件的 module.exports = Emitter; 代码后面添加 window.EventEmitter = Emitter; 代码。
2. 拷贝 chatofpomelo-websocket/web-server/public/js/lib/components/NetEase-pomelo-protocol/lib/protocol.js 文件。
3. 拷贝 chatofpomelo-websocket/web-server/public/js/lib/components/pomelonode-pomelo-protobuf/lib/client/protobuf.js 文件。
4. 拷贝 chatofpomelo-websocket/web-server/public/js/lib/components/pomelonode-pomelo-jsclient-websocket/lib/pomelo-client.js 文件，并使用 cc.log、 cc.error 替换文件中的 console.log、console.error。

最后

这是我博客的第一篇博文（除了 HelloWord 外^_），希望大家喜欢。由于本人水平有限，文章中难免错漏之处，请各位不吝指正。