README_zh.md
1# WebSocket
2
3### 介绍
4
5本示例展示了WebSocket的使用，包括客户端与服务端的连接和断开以及客户端数据的接收和发送。
6
7WebSocket连接：使用WebSocket建立服务器与客户端的双向连接，需要先通过createWebSocket方法创建WebSocket对象，然后通过connect方法连接到服务器。
8当连接成功后，客户端会收到open事件的回调，之后客户端就可以通过send方法与服务器进行通信。 当服务器发信息给客户端时，客户端会收到message事件的回调。
9当客户端不要此连接时，可以通过调用close方法主动断开连接，之后客户端会收到close事件的回调。
10
11使用方法：
12
131.输入服务器IP地址，点击**绑定服务器IP地址**按钮，即可绑定该IP并退出弹框，如果要解绑IP，重启应用即可。
14
152.点击顶部栏的**连接**按钮，按钮颜色从灰色变为绿色，即可与服务器建立WebSocket连接，并开始监听服务器发来的消息。
16
173.在底部消息输入框输入消息，点击**发送**按钮，即可收到来自服务端的消息回馈。
18
194.再次点击顶部栏的**连接**按钮，按钮颜色从绿色重新变成灰色，即可与服务器断开连接，接收不到服务器发来的消息。
20
21### 效果预览
22
23
24
25### 相关权限
26
27网络使用权限：ohos.permission.INTERNET
28
29### 依赖
30依赖于[WebSocketServer](https://gitee.com/adslk/application_server/tree/master/WebSocketServer)服务器才能实现相关功能。
31
32### 约束与限制
33
341.本示例仅支持在标准系统上运行。
35
362.本项目仅包含客户端，不包含服务端，当前服务端回复客服端为固定消息。
37
383.本示例为Stage模型，从API version 9开始支持。
39
404.本示例需要使用DevEco Studio 3.0 Beta4 (Build Version: 3.0.0.992, built on July 14, 2022)才可编译运行。
41
