监听用户上下线 - GoEasy IM

实时监听用户上下线状态变化

启用和关闭

所有应用（包括免费应用）均可在我的应用 -> 查看详情 -> 高级功能 -> 在线用户查询和上下线提醒 自助启用和关闭。

资费

增强型应用（包括免费应用），可以免费监听IM用户上下线状态变化，2021年11月起，监听IM用户上下线接口不再单独扣除消息条数。 但启用后，若使用了PubSub模块，会造成PubSub消息数的消耗。

监听用户上下线状态变化

IM用户上下线有两种actions

online，触发条件

• 用户connect成功
• 因为网络的原因，断网重连

offline，触发条件

• 调用disconnect
• 手动关闭窗口或者应用
• 网路断开

        var onUserPresence = function (event) {
            //被监听的用户有上线或者下线行为，就会触发本方法
            //单聊用户上下线event示例
            // {
            //     "time": 1592807533798,
            //     "action": "online",
            //     "id": "user002",
            //     "data": {"avatar":"/images/Avatar-2.png","name":"Wallace"}
            // }
            console.log("online/offline event:" + JSON.stringify(event));
        };
        //接受用户上下线状态变化
        im.on(GoEasy.IM_EVENT.USER_PRESENCE, onUserPresence);


        var userIds = ["user001"];//要监听的用户userId，一次可以监听多个

        //监听用户上下线提醒
        im.subscribeUserPresence({
            userIds:userIds,
            onSuccess: function () { 
                console.log("Subscribe user presence successfully."); 
            },
            onFailed: function (error) { //连接失败
                console.log("Failed to subscribe user presence, code:" + error.code + " content:" + error.content);
            }        
        });

监听群成员上下线状态变化

IM群成员上下线有四种actions

online，触发条件

• 用户connect成功
• 因为网络的原因，断网重连

offline，触发条件

• 调用disconnect、手动关闭窗口或者应用
• 手动关闭窗口或者应用
• 网路断开

join，触发条件

• 用户监听群消息成功

leave，触发条件

• 主动取消监听群消息

JavaScript

       var onGroupPresence = function (event) {            
            //{"groupId":"group001","groupOnlineCount":"23","time":1591689232383,"action":"join","id":"user001","data": {"avatar":"/images/Avatar-2.png","name":"Wallace"}}
            console.log("Group User online/offline event:" + JSON.stringify(event));            
        };

        //接收群成员上下线事件
        im.on(GoEasy.IM_EVENT.GROUP_PRESENCE, onGroupPresence);

        var groupIds = ["group001"];

        //订阅群成员上下线，一次可以订阅多个群
        im.subscribeGroupPresence({
            groupIds:groupIds,
            onSuccess: function () { 
                console.log("Subscribe group presence successfully."); 
            },
            onFailed: function (error) { //连接失败
                console.log("Failed to subscribe group presence, code:" + error.code + " content:" + error.content);
            }        
        });