socket.io 系统API

SOCKET.IO，系统API，

原文：http://www.cnblogs.com/xiezhengcai/p/3956401.html 

1. 服务端

io.on('connection',function(socket));

监听客户端链接,回调函数会传递本次链接的socket

io.sockets.emit('String',data);

给全部客户端广播消息

io.sockets.socket(socketid).emit('String', data);

给指定的客户端发送消息

socket.on('String',function(data));

监听客户端发送的信息

socket.emit('String', data);

给该socket的客户端发送消息

 

广播消息

//给除了本身之外的客户端广播消息
socket.broadcast.emit("msg",{data:"hello,everyone"}); 
//给全部客户端广播消息
io.sockets.emit("msg",{data:"hello,all"});

 

分组

socket.on('group1', function (data) {
        socket.join('group1');
});
socket.on('group2',function(data){
        socket.join('group2');
 });

客户端发送

socket.emit('group1')，就能够加入group1分组；
socket.emit('group2')，就能够加入group2分组；

一个客户端能够存在多个分组（订阅模式）

踢出分组

socket.leave(data.room);

对分组中的用户发送信息

//不包括本身
socket.broadcast.to('group1').emit('event_name', data);
//包括本身
io.sockets.in('group1').emit('event_name', data);

broadcast方法容许当前socket client不在该分组内

获取链接的客户端socket 

io.sockets.clients().forEach(function (socket) {
    //.....
})

 

获取分组信息

//获取全部房间（分组）信息
io.sockets.manager.rooms
//来获取此socketid进入的房间信息
io.sockets.manager.roomClients[socket.id]
//获取particular room中的客户端，返回全部在此房间的socket实例
io.sockets.clients('particular room')

 

另外一种分组方式

io.of('/some').on('connection', function (socket) {
    socket.on('test', function (data) {
        socket.broadcast.emit('event_name',{});
    });
});

客户端

var socket = io.connect('ws://103.31.201.154:5555/some')
socket.on('even_name',function(data){
   console.log(data);
})

客户端都连接到ws://103.31.201.154:5555 可是服务端能够经过io.of('/some')将其过滤出来。

 

另外，Socket.IO提供了4个配置的API：io.configure, io.set, io.enable, io.disable。其中io.set对单项进行设置，io.enable和io.disable用于单项设置布尔型的配置。io.configure可让你对不一样的生产环境（如devlopment，test等等）配置不一样的参数。

2. 客户端

创建一个socket链接

var socket = io("ws://103.31.201.154:5555");

监听服务消息

socket.on('msg',function(data){
    socket.emit('msg', {rp:"fine,thank you"}); //向服务器发送消息
    console.log(data);
});

socket.on("String",function(data)) 监听服务端发送的消息 Sting参数与服务端emit第一个参数相同

 

监听socket断开与重连。

socket.on('disconnect', function() {
    console.log("与服务其断开");
});


socket.on('reconnect', function() {
    console.log("从新链接到服务器");
});

 

客户端socket.on()监听的事件：

connect：链接成功
connecting：正在链接
disconnect：断开链接
connect_failed：链接失败
error：错误发生，而且没法被其余事件类型所处理
message：同服务器端message事件
anything：同服务器端anything事件
reconnect_failed：重连失败
reconnect：成功重连
reconnecting：正在重连
当第一次链接时，事件触发顺序为：connecting->connect；当失去链接时，事件触发顺序为：disconnect->reconnecting（可能进行屡次）->connecting->reconnect->connect。

知识是咱们已知的 也是咱们未知的 基于已有的知识之上 咱们去发现未知的 由此,知识获得扩充 咱们得到的知识越多 未知的知识就会更多 于是,知识扩充永无止境