管理聊天会话
聊天会话在IM会话中创建,用于管理和参与人与人的聊天和聊天室。所有的文本即时消息的聊天都是由IChatSession接口来处理,它为发送文本或数据消息和邀请新的参与者加入聊天提供了方法。你可以为聊天会话附加一个聊天监听者来监听与之有关的消息。
处理聊天会话对于在程序中整合文本消息尤其的有用。使用聊天会话,你可以为多玩家游戏创建一个聊天室或者在一个移动交际网络程序中整合人与人的消息。
开启或加入一个聊天会话
一个聊天会话代表着一个管道,通过它传递着与目标用户的所有即时消息,所以,每个用户每个IM会话你只能维护一个聊天聊天会话。
你可以通过一个IM会话创建新的聊天会话,使用getChatSession或creatChatSession方法。
如果某个联系人已经存在一个聊天会话,你可以通过传入用户的用户名来得到你想交流对象的聊天会话,如下面的代码片段所示。如果对于指定的用户没有活跃的聊天会话,那么,这个方法会返回null。
IChatSession cs = imSession.getChatSession(targetContactEmailAddress);
如果你还没有和特定的用户建立聊天会话,使用createChatSession方法来创建,传入目标联系人的用户名。如果IM会话不能创建一个新的聊天会话,这个方法将返回null。
IChatSession chatSession = imSession.createChatSession(targetContactEmailAddress);
如果必要的话,下面的代码演示了在创建一个新的聊天会话之前,检查是否与目标用户之间已经存在聊天会话:
IChatSession chatSession = imSession.getChatSession(targetContactEmailAddress);
if (chatSession == null)
chatSession = imSession.createChatSession(targetContactEmailAddress);