|
5 | 5 | # DEV FOR MULTI PLATFORMS |
6 | 6 | # UnityWebSocket 使用 |
7 | 7 |
|
8 | | -### 1. 最新Release版本下载 [UnityWebSocket.unitypackage](https://github.com/y85171642/UnityWebSocket/blob/master/Release/UnityWebSocket.unitypackage?raw=true)。 |
| 8 | +### 1. 最新Release版本下载 [UnityWebSocket.unitypackage](https://github.com/y85171642/UnityWebSocket/blob/master/Release/LastRelease/UnityWebSocket.unitypackage?raw=true)。 |
9 | 9 |
|
10 | 10 | ### 2. 使用方法: |
11 | 11 | - 导入 UnityWebSocket.unitypackage |
|
45 | 45 | - WebSocketReceiver.cs |
46 | 46 |
|
47 | 47 | 作用:与jslib交互,负责收发多个WebSocket消息。 |
48 | | - 该脚本在使用WebSocket时会自动加载到场景中。 |
| 48 | + 该脚本在使用WebSocket时会自动加载到场景中,并添加为DonDestroyOnLoad。 |
49 | 49 |
|
50 | 50 | - Demo场景 |
51 | 51 |
|
52 | 52 | 作用:WebSocket的使用方法示例。 |
53 | 53 |
|
54 | | - |
55 | | -### 4. 发布 |
56 | | -- 需要将Unity项目切换为WebGL平台,并Build。 |
57 | | - |
58 | | -- 将生成好的项目文件发布至Tomcat,启动Tomcat,在浏览器中打开相应链接路径。(例如:http://127.0.0.1/UnityWebSocketDemo/index.html ) |
| 54 | +### 4. 注意(Warning) |
| 55 | +- WebSocket的命名空间是 UnityWebSocket 不要用错了 :) 。 |
| 56 | +- WebSocket的 onOpen、OnClose、OnReceive 回调都发生在网络线程中,回调处理函数不能直接修改主线程中的Unity组件内容,需要在主线程中加消息处理队列,缓存网络消息后,再在主线程中处理消息包。 |
| 57 | +- WebGL平台下,需要发布到Tomcat等服务器上运行。 |
| 58 | +- ServerDemo 是用于Demo测试版本的WebSocket服务器,兼容所有Release版本的Demo。 |
| 59 | +- v1.1 后版本有使用websocket-sharp插件,如果本地已使用该插件,可自行修改或删除。 |
59 | 60 |
|
60 | 61 | ### 5. WebSocket服务器 |
61 | 62 | - 项目发布完成后,需要一个WebSocket服务器收发消息,以下是Demo版本对应的服务器。 |
62 | | - |
63 | | -- [服务器Demo下载](https://github.com/y85171642/UnityWebSocket/tree/master/Release/Demo/Server) |
64 | | - |
| 63 | +- [服务器Demo下载](https://github.com/y85171642/UnityWebSocket/tree/master/Release/Server) |
65 | 64 | - 提供简单的WebSocket消息收发 |
66 | | - |
67 | 65 | - 使用了开源项目 [websocket-sharp](https://github.com/sta/websocket-sharp) |
68 | 66 |
|
69 | | -### 6. 注意(Warning) |
70 | | -- 切换场景时,请不要卸载WebSocketReceiver。如果卸载了,请销毁WebSocket连接,并重新创建。 |
71 | | - |
72 | | -### 7. Change Log(v1.0) |
| 67 | +### 6. 版本记录 |
| 68 | +#### v1.0 |
73 | 69 | - 支持单客户端同时创建多个不同WebSocket链接。 |
74 | 70 | - 添加OnError错误回调。错误码对应错误原因,参考jslib文件。 |
75 | 71 | - 删除Alert功能(与WebSocket无关,按需求自行添加即可)。 |
76 | 72 | - Close Event Code 作为链接断开错误信息处理。 |
77 | 73 | - jslib 内容完善,增加Map管理websocket实例。 |
78 | 74 | - 修改 State 枚举对应到WebSocket ReadyState。 |
79 | 75 | - 添加 Release Demo Build 文件。 |
| 76 | + |
| 77 | +#### v1.1 |
| 78 | +- 多平台支持,使用websocket-sharp 开源插件。 |
| 79 | +- 完善项目命名空间,目录结构。 |
| 80 | +- WebSocket增加异步连接发送方法。(webgl平台下仍调用同步方式) |
| 81 | +- 添加开发分支,git管理方式调整。 |
0 commit comments