Cocos Creator
使用 WebSocket 服务器
开发者可以在游戏进程中启动一个 WebSocket 服务器,提供 RPC 接口。通过完善和调用这些 RPC 接口,开发者能够对游戏进程内部状态进行监控,增加对游戏进程状态的管理能力。
如何启用
WebSocket 服务器 默认是剔除的。若要启用,需要在构建原生平台后生成的发布包目录 build/[platform]/proj
(例如 Android 平台默认为 build/android/proj
)下的 cfg.cmake
文件中添加配置 set(USE_WEBSOCKET_SERVER ON)
。
如何调用 WebSocket 服务器接口
可参考下方实例代码:
js
// 在原生平台的 Release 模式下或者在 Web /微信小游戏等平台中,WebSocketServer 可能没有定义
if (typeof WebSocketServer == "undefined") {
console.error("WebSocketServer is not enabled!");
return;
}
let s = new WebSocketServer();
s.onconnection = function (conn) {
conn.ondata = function (data) {
conn.send(data, (err) => {});
}
conn.onclose = function () {
console.log("connection gone!");
};
};
s.onclose = function () {
console.log("server is closed!");
}
s.listen(8080, (err) => {
if (!err);
console.log("server booted!");
});
API
接口定义如下:
typescript
/**
* 服务器对象
*/
class WebSocketServer {
/**
* 关闭服务
*/
close(cb?: WsCallback): void;
/**
* 监听并启动服务
*/
listen(port: number, cb?: WsCallback): void;
/**
* 处理新的请求
*/
set onconnection(cb: (client: WebSocketServerConnection) => void);
/**
* 设置服务器关闭回调
*/
set onclose(cb: WsCallback);
/**
* 获取所有的连接对象
*/
get connections(): WebSocketServerConnection[];
}
/**
* 服务器中客户端的连接对象
*/
class WebSocketServerConnection {
/**
* 关闭连接
*/
close(cb?: WsCallback): void;
/**
* 发送数据
*/
send(data: string|ArrayBuffer, cb?: WsCallback): void;
set ontext(cb: (data: string) => void);
set onbinary(cb: (data: ArrayBuffer) => void);
set ondata(cb: (data: string|ArrayBuffer) => void);
set onconnect(cb: () => void;);
set onclose(cb: WsCallback);
set onerror(cb: WsCallback);
get readyState(): number;
}
interface WsCallback {
(err?: string): void;
}
参考链接
接口设计参考了 nodejs-websocket。