SmackAPI中文版资源-CSDN文库

共29个文件

html：23个

png：3个

css：2个

Smack

即时通讯

openfire

5星 · 超过95%的资源需积分: 44 9 浏览量 2011-01-18 11:14:34 上传评论 3 收藏 111KB RAR 举报

资源推荐

资源详情

资源评论

收起资源包目录

Smack帮助文档中文版.rar （29个子文件）

Smack帮助文档中文版

documentation

gettingstarted.html 3KB

overview.html 2KB

extensions

disco.html 9KB

dataforms.html 5KB

privatedata.html 600B

rosterexchange.html 6KB

muc.html 24KB

invitation.html 2KB

toc.html 700B

filetransfer.html 6KB

time.html 366B

index.html 365B

intro.html 3KB

messageevents.html 11KB

style.css 1KB

xhtml.html 7KB

messaging.html 4KB

properties.html 3KB

roster.html 4KB

providers.html 4KB

processing.html 3KB

debugging.html 3KB

images

enhanceddebugger.png 33KB

roster.png 18KB

debugwindow.gif 15KB

smacklogo.png 4KB

index.html 1014B

privacy.html 6KB

style.css 1KB

<html> <head> <title>多人聊天</title> <link rel="stylesheet" type="text/css" href="style.css" /> </head> <body> <div class="header">多人聊天</div> 允许构造，参与，并管理个别的基于文本的会议聊天室。 <ul> <li><a href="#create">创建新聊天室</a></li> <li><a href="#join">加入聊天室</a></li> <li><a href="#invite">控制聊天室邀请</a></li> <li><a href="#discomuc">查看MUC支持</a></li> <li><a href="#discojoin">查看已加聊天室</a></li> <li><a href="#discoroom">查看聊天室信息</a></li> <li><a href="#privchat">开始私聊</a></li> <li><a href="#subject">管理聊天室主题变更</a></li> <li><a href="#role">管理角色变更</a></li> <li><a href="#afiliation">管理从属关系变更</a></li> </ul> JEP related: <a href="http://www.jabber.org/jeps/jep-0045.html">JEP-45</a> <hr> <div class="subheader"><a name="create">创建新聊天室</a></div> 描述 被许可的可以用户创建新的聊天室.您可以创建两类聊天室。Instant rooms适用立即进入和基于一些默认配置自动创建。Reserved rooms在允许其它人进入之前由聊天室创建者手动配置。 用法 要创建聊天室您需要首先创建MultiUserChat的一个实例。聊天室名字通过构造方法传递给要创建的聊天室。下一骤是调用MultiUserChat的create(String nickname)方法在这里nickname是加入聊天室用的昵称。 根据您要创建的聊天室的类型您需要使用不同配置表单。要创建一个Instant room调用sendConfigurationForm(Form form)方法在这里表单是一个空表单。但是如果您想创建一个Reserved room您应该首先获得聊天室的配置表单，完成表单，最后将它发送回服务器。 范例 在这个例子中我们可以看到如何创建一个instant room： <blockquote> <pre> // 使用XMPPConnection创建一个MultiUserChat MultiUserChat muc = new MultiUserChat(conn1, "myroom@conference.jabber.org"); //创建聊天室 muc.create("testbot"); // 发送一个空表单配置这显示我们想要一个instant room muc.sendConfigurationForm(new Form(Form.TYPE_SUBMIT)); </pre> </blockquote> 在这个例子中我们可以看到如何创建一个reserved room.表单使用默认值完成： <blockquote> <pre> // 使用XMPPConnection创建一个MultiUserChat MultiUserChat muc = new MultiUserChat(conn1, "myroom@conference.jabber.org"); // 创建聊天室 muc.create("testbot"); // 获得聊天室的配置表单 Form form = muc.getConfigurationForm(); // 根据原始表单创建一个要提交的新表单。 Form submitForm = form.createAnswerForm(); // 向要提交的表单添加默认答复 for (Iterator fields = form.getFields(); fields.hasNext();) { FormField field = (FormField) fields.next(); if (!FormField.TYPE_HIDDEN.equals(field.getType()) && field.getVariable() != null) { // 设置默认值作为答复 submitForm.setDefaultAnswer(field.getVariable()); } } // 设置聊天室的新拥有者 List owners = new ArrayList(); owners.add("johndoe@jabber.org"); submitForm.setAnswer("muc#roomconfig_roomowners", owners); // 发送已完成的表单（有默认值）到服务器来配置聊天室 muc.sendConfigurationForm(submitForm); </pre> </blockquote> <hr> <div class="subheader"><a name="join">加入聊天室</a></div> 描述 通常您向聊天室发送消息的第一步是加入这个聊天室。多人聊天允许在加入聊天室时指定一个参数。基本上您可以控制加入聊天室后接收的历史记录的数量花并且还可以提供聊天室里的昵称和密码如果聊天室有密码保护的话。 用法 要加入一个聊天室您需要首先创建一个MultiUserChat的实例。把您要加入的聊天室的名称传递给构造方法。下一步是调用MultiUserChat实例的join(...)方法。但是您首先要决定发送哪种加入消息。如果您想加入没有密码和没有指定要发送的历史记录的数量您可以使用join(String nickname)方法，在这里 nickname是您在聊天室的昵称。万一聊天室需要密码想加入您可以使用join(String nickname, String password)方法。最后，最完整的加入聊天室的方法是调用join(String nickname, String password, DiscussionHistory history, long timeout)方法，在这里nickname是您在聊天室的昵称，password是您加入聊天室的密码，history是指定要接收的历史记录的数量的对象，timeout是等待服务器响应的毫秒数。 范例 在这个例子中我们可以看到如何使用特定昵称加入一个聊天室: <blockquote> <pre> // 使用XMPPConnection创建一个MultiUserChat MultiUserChat muc2 = new MultiUserChat(conn1, "myroom@conference.jabber.org"); // 用户2加入新聊天室 // 聊天室服务将会决定要发送的历史记录数量 muc2.join("testbot2"); </pre> </blockquote> 在这个例子中我们可以看到如何使用特定昵称和密码加入聊天室: <blockquote> <pre> // 使用XMPPConnection创建一个MultiUserChat MultiUserChat muc2 = new MultiUserChat(conn1, "myroom@conference.jabber.org"); // 用户2使用密码加入新聊天室 // 聊天室服务将会决定要发送的历史记录数量 muc2.join("testbot2", "password"); </pre> </blockquote> 在这个例子中我们可以看到如何使用特定昵称和要接收的历史记录的数量： <blockquote> <pre> // 使用XMPPConnection创建一个MultiUserChat MultiUserChat muc2 = new MultiUserChat(conn1, "myroom@conference.jabber.org"); // 用户2使用密码和指定要接收的历史记录的数量加入新聊天室 // 在这个例子中我们请求最后5条消息。 DiscussionHistory history = new DiscussionHistory(); history.setMaxStanzas(5); muc2.join("testbot2", "password", history, SmackConfiguration.getPacketReplyTimeout()); </pre> </blockquote> <hr> <div class="subheader"><a name="invite">控制聊天室邀请</a></div> 描述 某人从自己拥有的聊天室邀请另一个人到聊天室是和有用的。根据聊天室的类型被邀请者可能接收一个用于加入聊天室的密码并且/或者被加到成员列表中如果聊天室是members-only类型的。Smack允许发送聊天室邀请并且允许潜在被邀请人监听聊天室邀请和邀请人监听被邀请人的拒绝。 用法 要邀请另一个用户到聊天室您必须已经加入了该聊天室。一旦您加入了调用MultiUserChat的invite(String participant, String reason)方法,在这里participant是您要邀请的用户(例如hecate@shakespeare.lit),reason是用户被邀请的原因。 如果潜在被邀请人想监听聊天室邀请,被邀请人必须向MultiUserChat类添加一个InvitationListener。因为InvitationListener是一个接口,需要创建一个类实现这个接口。如果邀请人相监听聊天室邀请拒绝,只要向MultiUserChat添加一个 InvitationRejectionListener。InvitationRejectionListener也是一个接口所以您需要创建一个类实现这个接口。 范例 在这个例子中我们可以看到如何邀请另一个用户到聊天室并且监听可能的拒绝: <blockquote> <pre> // 用户2加入聊天室 MultiUserChat muc2 = new MultiUserChat(conn2, room); muc2.join("testbot2"); // 用户2监听邀请拒绝 muc2.addInvitationRejectionListener(new InvitationRejectionListener() { public void invitationDeclined(String invit

评论收藏

内容反馈