[snap]实例讲解移动qq在线平台

人气：1903 2007-11-17

[snap]实例讲解移动qq在线平台

简单介绍snap mobile的架构

编写者	日期	关键词
陈曦@exce4	2006- 4-15	snap mobile api http tcp j2me

snap的概念

snap，即scalable network application package，翻译为可缩放的网络应用解决方案。

snap mobile apis是nokia公司和sun公司提供给全球众多移动游戏开发者的基于nokia snap 移动平台（像n-gage? arena.）和sun java wireless toolkit (version2.3)的一个功能强大的j2me客户端的api开发包。在snap apis中提供了基于可高效拓展服务的手机多人在线游戏的开发环境，可以使开发者很方便的为程序添加网络特性，比如注册、登陆、即时通信、多人在线游戏、认证、好友列表、聊天、游戏积分排行、用户帐户和个人信息等游戏特性，大大地简化进行手机多人在线游戏j2me程序的开发工作。

snap mobile具有三大特点：

l 具有游戏社区功能(imps services)

l 具有在线游戏功能(snap game services)

l 具有交流社区功能(web services)

[snap]实例讲解移动qq在线平台（图一）

点击查看大图

也就是说，你可根据你的项目特点有选择地进行开发。

商业应用示范

snapmobile给出了一些与nokia合作的手机游戏开发商的展示：

http://snapmobile.nokia.com/n-gage/web/en/snapmobile/games.jsp

octopi game development studio也有很好的示范，你可以浏览

http://www.octopi.com/snap.htm

从那里你能得到一个很好的概念。

到底snap mobile是什么？

对于移动游戏开发者来说，它其实就是多人在线游戏的开发工具。通过它你可以实现手机注册、登陆、进入游戏大厅或者游戏房间进行多种模式的游戏对战。

它的构架是这样的：

[snap]实例讲解移动qq在线平台（图二）

点击查看大图

对于客户端移动游戏开发者来说，只要实现了客户端访问到服务器，能发出请求，完成登陆、接收信息以及其他的一些社区功能而后登出服务器的话，基本就完成客户端的开发。

[snap]实例讲解移动qq在线平台（图三）

在nokia的产业链中，整个开发运作流程是这样的：

[snap]实例讲解移动qq在线平台（图四）

可以看到nokia有一整套规范的操作流程和成熟的商业运作模式。想了解得更多的话，可以自己仔细查询：

http://snapmobile.nokia.com/n-gage/web/en/snapmobile/process.jsp

只要与nokia提供的服务器端模拟器完成上述功能，就可以进行snap mobile开发，而不需要在真实的通讯网络里完成。这就大大节约了开发成本，提高效率，也使开发者能回到核心业务，集中精力在游戏开发上，而不需要再费过多的资源关注通讯的细节。

我们下面具体讲解一下snap客户端登陆模拟服务器的示例。

简单的登陆示例

下载开发工具：

1。下载snap mobile client sdk：

http://www.forum.nokia.com/main/0,6566,034-1021,00.html

2。下载sun java wireless toolkit 2.3 beta：

http://java.sun.com/products/sjwtoolkit/download-2_3.html

（注意，必须要求用sun java wireless toolkit 2.3。安装它时候，虽然出现的还是wtk2.2版本字样，但不要怀疑。启动时它的界面不再是黄、红、蓝的强势界面，而且友好的浅蓝界面。）

安装完成后，接着就是启动wtk2.3，新建一个项目。例如：

新建 snaptest 项目，midlet的类名为 test.helloworld。保持原来的默认设置，其他的可选包都不用选择。

在设置的外部api包 external apis里面会看到一个 sm-ui-api.jar的选项，还有一个bundle的选项，都打上勾。

[snap]实例讲解移动qq在线平台（图五）

然后在安装snapmobile的目录下找到 samples文件夹，把samples/helloworld/src 目录下的 test 文件复制到wtk2.3的文件夹 wtk2.3/apps/snaptest/src目录下

然后打开设置在权限许可 permission的地方添加访问权限的api：

midlet-permissions: javax.microedition.io.connector.socket

midlet-permissions:javax.microedition.io.connector.http

接着是设置用户自定义 user defined ，在里面添加连接信息：

snap-mobile-host: localhost

snap-mobile-port: 8080

snap-mobile-protocol: http

username: test1

password: test

[snap]实例讲解移动qq在线平台（图六）

在安装snapmobile的目录下找到 lib 文件夹，把 sm-api.jar复制到wtk2.3/apps/snaptest/lib目录下。然后编译生成。

启动安装snapmobile的目录下snapmobile/tools/serveremulator的服务器端模拟器 emu.bat，会出现一个dos运行框，里面有发布信息，然后再运行客户端的模拟器，就会出现欢迎信息，完成登陆。

[snap]实例讲解移动qq在线平台（图七）

可能看完这个示例后，你对snap mobile 有了一个初步的概念。下面我们再深入一点地介绍整个snap moile的构架和实现。

通过以下helloworld.java的主要部分代码：

helloworld.java

public class helloworld extends midlet implements runnable, snapeventlistener {

/***开始运行***/

public void startapp() {

/***初始化获取访问权限***/

protocol = getappproperty("snap-mobile-protocol");

hostname = getappproperty("snap-mobile-host");

port = integer.parseint(getappproperty("snap-mobile-port"));

username = getappproperty("username");

password = getappproperty("password");

gameclassid = 49152;

thread = new thread(this);

thread.start();

}

/***线程运行***/

public void run() {

try { /***创建服务器连接对象（主机名，端口号，协议）***/

comm = new servercomm(hostname, port, protocol);

/***添加snap事件监听器到该对象***/

comm.addsnapeventlistener(this);

/***统一登陆snap,imps和web 服务器（用户名，密码，游戏类id，显示属性）***/

comm.extendedlogin(username, password, gameclassid, null);

/***发送信息***/

comm.sendbuddymessage(username, "hello world!");

} catch (exception e) { }

/***该对象移除snap事件监听器***/

comm.removesnapeventlistener(this);

/***统一登出服务器***/

comm.unifiedlogout();

}

/***处理事件***/

public void processevents(vector list) {

itemlist il;

for (int i=0; i<list.size(); i++) {

/***获取所有来自服务器的信息***/

il = (itemlist)list.elementat(i);

switch(il.getinteger("id")) {

case itemlist.imps_im_message:

console.println("- imps_im_message event", console.yellow);

console.println(" from id: " + il.getstring("fromid"), console.white);

console.println(" from name: " + il.getstring("fromname"), console.white);

console.println(" location: " + il.getstring("location"), console.white);

console.println(" message: " + il.getstring("message"), console.white);

if (username.equals( il.getstring("fromname"))) {

done = true;

console.println("message from ourself, done!", console.white);

} else {

console.println("message from someone else, not done.", console.white);

}

break;

}

我们可以清楚地看到，nokia已经在snapmobile里面已经封装好了连接接口和连接框架。让我们登陆snapmobile服务器成为一件很简单的事情。

（具体细节可以参考《snap_mobile_helloworld_tutorial_v1_0_en.pdf》的章节）

说到连接接口和连接框架咱们就不能跳过实现snap mobile的通信协议。

http和tcp

snap mobile规范里面明确写着支持http和tcp协议：

l http 使用 8080 端口；

l tcp 使用 8976 端口；

nokia的服务器端模拟器提供了修改相关协议、端口的命令。

说到这里不得不向各位说明一点，目前（从2006年3月20日至4月19止）nokia官方论坛和snapmobile.nokia.com总共提供了两个性能不同的服务器端模拟器，各自针对的demo。

snap mobile sdk自带工具包里的serveremulator主要是针对samples/helloworld的演示，开发指南和readme说明上都介绍说可以在dos状态通过输入:

c:/ serveremulator>emu -protocol tcp ?cport 8976

来完成相关协议和端口的修改，可是多次尝试，均未能修改成功。而性能不稳定。但可以通过客户端模拟器添加好友名单来修改服务器端resource/users文件夹下的用户数据。

而snapmobile.nokia.com下载的sm-serv-em 则是可以emu <port_number>来修改端口。虽然性能稳定，但是取消了通过客户端模拟器修改服务器端的用户数据的功能，只能人工手动修改。

配置访问权限

从上面的上例可以知道客户端可以通过以下代码来获取本地设置的访问权限：

getapppropert

protocol = getappproperty("snap-mobile-protocol");

hostname = getappproperty("snap-mobile-host");

port = integer.parseint(getappproperty("snap-mobile-port"));

username = getappproperty("username");

password = getappproperty("password");

而访问权限的设置除了要在客户端本地设置以外，在服务器端也是需要设置的。在客户端我们将在用户自定义 user defined里面添加如下信息来设置访问权限。

key	value
snap-mobile-protocol	http
snap-mobile-host	localhost
snap-mobile-port	8080
username	test1
password	test

而在服务器端的设置，我们则在服务器端模拟器的/resource文件夹下进行：

上例可通过修改*.cfg配置文件的内容来修改属性和设置。

配置文件	value
gameclasses.cfg	游戏类id ：游戏名
snapserver.cfg	创建游戏厅：游戏厅名
lobbies/49152_lobbies.cfg	游戏厅名
ranking/test/table.cfg	排名表
ranking/test/stat	用户名积分时间

同时也可以手动修改users文件夹下的用户数据文件来设置用户的信息：

1000000x.dat	value
user-id	1000000x
user-name	用户名
password	密码
buddy-list	好友列表

（具体细节参考《snap_mobile_community_service_emulator_guide_v1_0_en.pdf》的章节）

实例讲解移动qq在线平台

[snap]实例讲解移动qq在线平台（图九）

[snap]实例讲解移动qq在线平台（图十）

该平台是基于wtk2.3的demo--snap mobile sample_community修改而成，界面汉化，以及一些功能做了局部调整。现在做实例讲解，主要让大家能深入理解这个snapmobile的sample。

[snap]实例讲解移动qq在线平台（图十二）

看看我们要完成的的流程：

1．初始化

2．登陆

3．加载信息

4．查找用户

5．添加好友

6．聊天对话

7．好友上线

8．下线通知

9．离开

可以根据本文档提供的源代码，逐步理解它的构架和运作机制。

1．初始化

community类初始化

static void initialize() {

/***com.nokia.sm.ui.view初始化***/

view.initialize();

/***好友列表框架初始化***/

buddyview.initialize();

/***软按钮初始化***/

buttonlistview.initialize();

/***发送信息框架初始化***/

chat.initialize();

/***确认信息框架初始化***/

dialog.initialize();

/*** 登陆框架初始化***/

/***社区在线显示初始化***/

rankingview.initialize();

}

2．登陆

连接对象发送统一登陆信息

try {

/***

*连接对象执行extendedlogin命令发送（用户名，密码，游戏类名，在线显示属性）

*来统一登陆snap, imps和web服务器，

*同时服务器会返回好友列表和在线显示信息给returnvalues

returnvalues = comm.extendedlogin(

itemlist.getstring("user"),

itemlist.getstring("pass"),

itemlist.getinteger("gcid"),

itemlist.getstring("presence")

);

} catch (exception e) {

string msg = "" + "cannot contact server. please verify "

+ "that properties snap-mobile-host and "

+ "snap-mobile-port point to a snap mobile "

+ "server. app will close in a few seconds.";

/***显示出错信息***/

showerror(msg, true);

/***延迟10秒***/

try {thread.sleep(10000);}

catch (interruptedexception ie) {}

}

3．加载信息

获取好友列表

https访问
7*24小时服务
专业一线支持
7天无理由退款

关于我们
公司介绍最新动态联系我们
产品与服务
域名注册 jsp空间 php空间
常见问题
空间操作手册网站备案相关退款相关问题
技术支持
技术 QQ ：178966803 联系电话：13616026886 联系邮箱：fjjsp@vip.163.com

扫描关注微信公众号

福佳空间在线客服

20944024 178966803 1946551451

扫描关注微信公众号

欢迎登录福佳jsp空间

技术文档 欢迎使用技术文档，我们为你提供从新手到专业开发者的所有资源，你也可以通过它日益精进

[snap]实例讲解移动qq在线平台