套接字-socket
描述
套接字，父对象为ui，无子对象
事件
- connect: 套接字建立连接成功时触发，事件函数定义:onConnect(ip)，参数ip是连接的另一端的IP地址
- disconnect: 套接字连接断开时触发，事件函数定义:onDisconnect(ip)，参数ip是连接的另一端的IP地址
- receive: 接收到消息时触发，事件函数定义:onReceive(ip)，参数ip是消息发送端的IP地址
属性
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| endPoint | 终端 0-CLINT客户端, 1-SERVER服务端 | ui.form-name.socket-name.endPoint=1 设置套接字为服务端 |
| protocol | 协议 0-TCP, 1-UDP | ui.form-name.socket-name.protocol=1 设置套接字协议为UDP |
方法
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| connect(ip, port, timeout) | 连接TCP服务端,参数timeout是连接超时，单位：毫秒 | ui.form-name.socket-name.connect('192.168.1.11', 8888, 3000) 连接TCP服务端，端口号8888 |
| disconnect() | 断开当前TCP连接 | ui.form-name.socket-name.disconnect() 断开当前TCP连接 |
| isConnected() | 判断当前TCP客户端是否已连接 | var connected = ui.form-name.socket-name.isConnected() 返回是否已连接 |
| read() | 读取套接字另一端发送的二进制内容，返回值是字节数组 | var data = ui.form-name.socket-name.read() 读取套接字另一端发送的所有二进制内容 |
| readAsString() | 读取套接字另一端发送的文本内容，返回值是字符串 | var str = ui.form-name.socket-name.readAsString() 读取套接字另一端发送的所有文本内容 |
| write(data) | 写数据到TCP套接字 | ui.form-name.socket-name.write('abcd'); 发送字符串'abcd' ui.form-name.socket-name.write([0xaa, 0xbb]); 发送二进制数组 |
| write(data, ip, port) | 写数据报到UDP套接字 | ui.form-name.socket-name.write('abcd', '192.168.1.11', 8888); 发送字符串'abcd' ui.form-name.socket-name.write([0xaa, 0xbb], '192.168.1.11', 8888); 发送二进制数组 |
| startListening(ip, port) | 监听端口，TCP服务端或者UDP客户端都可以监听端口 | ui.form-name.socket-name.startListening('192.168.1.11', 8888); 监听端口8888 |
| stopListening() | 停止监听端口 | ui.form-name.socket-name.stopListening(); |