• 标准网络接口
    • 使用方法
    • SocketIO

    标准网络接口

    在 Cocos Creator 中，我们支持 Web 平台上最广泛使用的标准网络接口：

    • XMLHttpRequest：用于短连接
    • WebSocket：用于长连接
      当然，在 Web 平台，浏览器原生就支持这两个接口，之所以说 Cocos Creator 支持，是因为在发布原生版本时，用户使用这两个网络接口的代码也是可以运行的。也就是遵循 Cocos 一直秉承的 “一套代码，多平台运行” 原则。

    使用方法

    • XMLHttpRequest 简单示例：
    1.  var xhr = new XMLHttpRequest();
    2.  xhr.onreadystatechange = function () {
    3.      if (xhr.readyState == 4 && (xhr.status >= 200 && xhr.status < 400)) {
    4.          var response = xhr.responseText;
    5.          console.log(response);
    6.      }
    7.  };
    8.  xhr.open("GET", url, true);
    9.  xhr.send();

    开发者可以直接使用 new XMLHttpRequest() 来创建一个连接对象，也可以通过 cc.loader.getXMLHttpRequest() 来创建，两者效果一致。

    XMLHttpRequest 的标准文档请参考 MDN 中文文档。

    • WebSocket

      简单示例：

    1.  ws = new WebSocket("ws://echo.websocket.org");
    2.  ws.onopen = function (event) {
    3.      console.log("Send Text WS was opened.");
    4.  };
    5.  ws.onmessage = function (event) {
    6.      console.log("response text msg: " + event.data);
    7.  };
    8.  ws.onerror = function (event) {
    9.      console.log("Send Text fired an error");
    10.  };
    11.  ws.onclose = function (event) {
    12.      console.log("WebSocket instance closed.");
    13.  };
    15.  setTimeout(function () {
    16.      if (ws.readyState === WebSocket.OPEN) {
    17.          ws.send("Hello WebSocket, I'm a text message.");
    18.      }
    19.      else {
    20.          console.log("WebSocket instance wasn't ready...");
    21.      }
    22.  }, 3);

    WebSocket 的标准文档请参考 MDN 中文文档。

    SocketIO

    很抱歉，Creator 并未在 Web 平台上提供 socket.io 的官方支持，需要用户自己在项目中添加，并且原生平台的 socket.io 也已废弃。之前原生平台的 socket.io 是第三方开发者自己实现的，已经很久没有维护了，所以也不推荐使用。

    除此之外，SocketIO 提供一种基于 WebSocket API 的封装，可以用于 Node.js 服务端。如果需要使用这个库，开发者可以自己引用 SocketIO。

    在脚本中引用 SocketIO：

    • 下载 SocketIO：https://socket.io
    • 将下载后的文件放入拖入资源管理器中你希望保存的路径

    • 修改 SocketIO 脚本文件以避免在原生环境中被执行

      由于 Web 版本 SocketIO 不能够在 JSB 中被正确解析，因此 Cocos 在原生环境中自带了 SocketIO 实现。所以我们需要一点 hack 的手段让 Web 版本 SocketIO 的脚本在原生环境中不生效，方法就是在 SocketIO 脚本文件中做如下修改：

    1.  if (!cc.sys.isNative) {
    2.      // SocketIO 原始代码
    3.  }

    • 将 SocketIO 脚本文件设为 插件脚本，这样在组件中直接使用 window.io 就能访问到 SocketIO

    • 在组件中使用 SocketIO，可以参考 SocketIO 官方网站查询 API 和文档等