套接字-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’ <br> 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’ <br> 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(); |