DoJa平台手机游戏的开发与移植

一,DoJa技术简介        简单的说,DoJa是日本最大的移动通讯公司NTT DoCoMo的专利技术。而i-mode是该公司对于移动通讯2.5G阶段的一种应用模式,这个技术覆盖很多方面。i-mode初始于1999年,而i-mode与JAVA结合诞生的i-appli服务初始于2001年,以JAVA为开发语言的i-mode被称为DoJa技术,DoJa技术实际上是基于CLDC规范之上的平台技术,与J2ME标准平台是平行。有独立的API类库。在J2ME标准平台上开发的移动通讯程序叫做MIDP程序，符合MIDP1.0或2.0规范。而在DoJa平台上开发的程序被叫做appli程序。DoJa现在已经有很多版本。最高版本DoJa4.0。     二,DoJaAPI预览          我们以现在通用的DoJa2.5版本的API为例,大致看一下它有哪些特色。
2.5版本包括下面几个包:

com.nttdocomo.device	包含了可以控制设备的类,比如camera类
com.nttdocomo.io	包含一些在CLDC的GCF( Generic Connection Framework)框架之下的类
com.nttdocomo.lang	包含语言类
com.nttdocomo.net	包含了用于网络通讯方面的类
com.nttdocomo.opt.ui	包含了一些创建用户界面可选的类
com.nttdocomo.opt.ui.j3d	包含了可创建3D图形的类,也是可选的
com.nttdocomo.system	包含了一些可使用于本地终端功能的类,像操作手机电话本,收发Email等。
com.nttdocomo.ui	包含了一些用于创建用户界面的类
com.nttdocomo.util	包含一些工具类

       可以看出DoJaAPI比标准J2ME更加丰富。一般在开发和移植过程中,经常遇到的类库就是com.nttdocomo.ui包，所以我们大致看一下这里面都有哪些类。       这个包中包含了appli程序的入口类， Iapplication类，appli程序的用户界面（GUI）也分高级界面和低级界面，只不过他们的继承关系有些混乱，比如Component类是定义用于高级界面的抽象类，它有九个子类。包含一些按钮，标签，文本框的一些类。实际上就是一些组件。不是容器类。而Frame类也是一个抽象，意思是可表示为一个框架或容器。
    它的子类有Canvas，Dialog，Panel.其中Dialog和Panel属于高级界面类，而Canvas则用于低级界面。用于显示界面的类叫Display，而它的显示屏幕的方法为setCurrent（Frame f），里面的参数为Frame类对象。说明像Component类型的子类是不能独立显示在界面上的，要通过Frame子类中的高级界面类来填加。也就是必须放在Panel上面，才能被显示出来。
    其它的还有用于画图的Graphics，Graphics2D，Graphics3D类，负责加载媒体资源的MediaManager类等等。因为类很多，而且功能复杂和强大，就不一一介绍了，可以参考API文档进一步学习。
    三，appli程序开发
    下面我们通过一个小程序来讲解如何开发一个appli的程序。工欲善其事必先利其器，我们要下载一个DoJa的专用模拟器才行。
    好在DoJa的API文档和模拟器以及使用方法在http://www.doja-developer.net都已经给全了。下载对应DoJa2.5版本的模拟器。名字叫javaappli Development Kit for DoJa-2.5版本为 1.03，然后安装上就可以了。
    打开模拟器，会出现类似WTK的窗口，不同的是一个手机模拟器的窗口也会一起出现，而且还有个命令行模式的窗口。
    仔细看一下，其实界面功能挺简洁的，菜单栏有文件，工程，编辑，设备，帮助几个选择，工具栏包括新建项目，打开项目，ADF配置，创建，运行这些选项。下面还有一些运行模式的选择。当然这些项目都是英文的。       什么是ADF配置呢，这里讲一下appli的安装程序也包括jar打包文件和一个描述文件，不同的是这个描述文件的类型为.jam.而ADF中的设置就是相当于WTK中的setting.也就是用于jam文件描述的项目。       好了，我们先新建立一个工程，点new project,会出现一个提示窗口，让你输入工程名称，上面还有一个参考工程的选择，这个不用管它。我们的工程名就叫Test_doja. 点create创建。
   然后在这个窗口会显示一些我们创建的信息。比如我的模拟器安装路径是D盘根目录。那么会显示下面信息：
Placed java source files in D:\jDKDoJa2.5\apps\Test_doja\src Placed resource files in D:\jDKDoJa2.5\apps\Test_doja\res Placed Scratchpad file in D:\jDKDoJa2.5\apps\Test_doja\sp
    说明在模拟器的apps目录下，就是我们创建的工程目录。里面还有三个文件夹,scr用来放.java文件，res用来放资源,sp用来存放Scratchpad文件。这个Scratchpad这里要详细讲一下。      appli模式简单说就是客户手机通过连接 I – mode服务器来获得其它的网络资源。这些资源可以来自不同的网站。手机用单独有一块类似硬盘的区域用来存储这些资源，叫做Scratchpad，一般的DoJa手机游戏都是先从网络上下载资源到Scratchpad里，然后再从Scratchpad中读取来用。而且Scrtchpad是可写的，可以保存游戏信息。    

    回到我们刚才的工程中，现在sp目录是空的，也就是没有Scratchpad文件。我们可以自己创建一个。默认名称是工程名后面加上数字0，Scratchpad文件的后缀名为.scr。 需要说明的是，res目录里也是放资源文件的。所不同的是res中放的资源文件，在打包时会一起打进Jar文件。而sp目录下的Scratchpad不会。      我们的程序很简单，所以就不用制作Scratchpad了。功能就是实现高级界面与低级界面的切换。下面是代码：   import com.nttdocomo.ui.IApplication; import com.nttdocomo.ui.Canvas; import com.nttdocomo.ui.Panel; import com.nttdocomo.ui.Button; import com.nttdocomo.ui.Label; import com.nttdocomo.ui.ComponentListener; import com.nttdocomo.ui.Display; import com.nttdocomo.ui.Component; import com.nttdocomo.ui.Graphics;     public class Test_doja extends IApplication implements ComponentListener {        Panel p = new Panel();               public Test_doja()        {               Button ok = new Button("ok");               Label label = new Label("The first DoJa program!");               p.setBackground(0xc0c0c0);               p.add(label);               p.add(ok);               p.setComponentListener(this);                   }        public void start()        {               Display.setCurrent(p);        }        public void componentAction(Component source, int type, int param)        {               if(type == ComponentListener.BUTTON_PRESSED)               {                      Display.setCurrent(new DoJaCanvas());               }        }   }   class DoJaCanvas extends Canvas {        public DoJaCanvas()        {        }        public void paint(Graphics g)        {               g.setColor(0xff0000);               g.fillRect(0,0,getWidth(),getHeight());               g.setColor(0xffffff);               g.drawString("Hello world!",30,50);        } }           代码很简单，所以我没加注释，有过J2SE和J2ME编程经验的人，应该很容易看懂。Iapplication类跟MIDlet性质相同。不过它只需要从写start()方法，作为程序启动入口。 我们现在把代码保存在scr文件夹中，然后点build，如果没错误，则会提示下面信息： D:\jDKDoJa2.5\apps\Test_doja\bin\Test_doja.jar created D:\jDKDoJa2.5\apps\Test_doja\bin\Test_doja.jam updated Build completed   说明jar和jam文件直接创建完了。然后点run，就可以看效果了。是不是很轻松。: )     四, DoJa游戏移植到J2ME平台的方法          这部分内容我在手机移植体会(二)中已经介绍过，这次我主要说一下资源文件的读取。其实DoJa的API比标准J2ME丰富许多，所以移植是有难度的。用标准的J2MEAPI类库不能完全实现DoJa类库所有功能。我主要说一下一般的移植方法。 前面讲过关于Scratchpad的概念。我们通常看到的工程文件，都包含很多内容。其中有gif资源文件，.scr文件，和代码。我觉得只有.scr文件和java代码和打包后的jam和jar文件就够用了。因为图片和声音文件通常也在.scr文件中包含。不过有些小游戏的一些图或声音也会直接打在jar包内。就是工程中res目录下的东西。。   关于.scr文件的读取与解析，DoJa都提供了详细的方法，比如：   DataInputStream in = Connector.openDataInputStream(           "scratchpad:///0;pos=" + offset+ ",length=" + length)；   实际表示 从 scratchpad 的第 0 扇区 偏移量为offset，长度为length的数据作为 输入流。 前面我们说了scratchpad像硬盘一样。所以scratchpad:///0 的0 也可以是1 或者别的数字。但是区域不同。0对应的Scratchpad文件名为"工程名"+0.scr,如果是1就是"工程"+1.scr.也就是说Scratchpad可以由多个文件组成表示不同的存储区域.如果是往scratchpad中写操作，就用DataOutputStream构建就可以了。比如保存游戏中的分数。 上面这是从scratchpad中得到资源文件在DoJa代码中的写法。如果要是从res目录中读取，如何写呢。像这样： DataInputStream in  is = Connector.openInputStream("resource:///" + filename); filename就表示资源文件的名字。       看了上面的表示方法，我想大家应该会用J2ME的方法来把他们从写了吧。DoJa读取资源的方法很灵活，比如gif图片，可以直接用文件名得到图片对象，也可以用byte数组构建，不过比较常用的，还是用输入流来构建。所以移植中要修改图片，首先要对.scr文件进行分析，解析，将图片整理出来，才能使用。提取图片的方法，可以参考我BLOG中的一个程序。       在IApplication类中有个很重要的方法 getArgs() ,这个方法会得到 jam描述文件中App param项目的参数，这些参数可以用空格分开，每一段就表示一个元素，因为用getArgs()得到的是一个String的数组。所以很多游戏都是靠jam中的App param参数进行初始化资源，或判断。       把资源文件找到后，就可以对游戏进行修改了，不过有些方法需要你自己从写，比如drawImage 有很多参数的方法，可以从大图中画小图， 还有 doja自己按键处理机制。不过这些如果仔细看API的话，是可以用J2ME从写的。 有些实现不了的功能，就可以注释掉了。       以上就是我对移植DoJa游戏的一点建议。有些在手机游戏移植体会(二)里面已经说过的我就没有再提。如果你在移植中遇到什么问题可以向我咨询，我会努力帮助你。     五，相关资源链接 http://www.doja-developer.net   可以下载模拟器，API文档，以及DoJa技术的介绍等     http://www.nttdocomo.com     NTT DoCMo 公司的官方网站，里面介绍一些最新的技术和I-mode 的介绍。