手机游戏开发基础(经典)

1

GDDC

游戏设计与开发

课程

第十四章 手机游戏开发基础

MIDP 中定义的UI （用户界面）从逻辑上包括两组API ：高级API 和低级API 。高级API 通过应用高层抽象实现，它主要强调可移植性。而实际的绘制于用户交互处理则有实现具体来完成。使用高级API 的应用程序对于组件的显示外观只有有限的控制权，它只能访问高级UI 事件。

另一方面，通过使用低级API ，应该程序可以完全控制外观，而且可以直接访问输入设备并控制由用户交互产生的重要事件。但低级API 可能是与某一固定设备相关的，即可能只在某一设备上可用。所以，使用低级API 的应用程序在可移植性上会大打折扣的。这也是所有开发人员比较头疼的事，在某款手机上开发的游戏，在其他机型上就有可能运行不了，还得需要代码上的改动，而且这种代码上的改动有时会很大的，那么要求开发人员在做游戏的过程中，时刻注意游戏的可移植性问题。 简单的说，高级API 由于控制不了控件的外观，所以一般来说，高级API 都用于手机上的应用或游戏当中的参数设置（如：游戏的关数、难易程度），相反，因为低级API 可以随意在手机屏幕上画各种各样的内容，而且能够很方便地得到用户的输入（包括触摸方式），所以在游戏过程中，主要用的还是低级API 。 本章将讨论手机游戏开发用户界面的一些基础知识，而后两章将介绍使用高级API 和低级API 的UI 开发。

14.1 MIDLET 程序开发的基本方法

1） 编写源代码，生成.java 文件。 2） 编译、预校验，生成.class 文件。 3） 在模拟器上运行并测试。 4） 打包生成jar 文件。 5） 下载到真机上测试。

Mobile Media API

(MMAPI)为多媒体开发提供了一个强大，可扩充以及简单的接口。它有一套规范的播放和录制audio 或video 的接口。

游戏设计与开发

MIDlet程序开发的基本流程图

14.2MIDP 程序类 MIDLET

在上一章节，我们通过一个简单的例子，介绍了MIDlet的生命周期，已经对MIDlet有了一个初步的认识，下面我们要系统地学习一下MIDlet。

14.2.1MIDlet 类介绍

一个MIDP应用程序称作MIDlet——MIDP小应用程序，它不能够单独地运行，必须运行在特定的环境之中，或者说运行在一个容器中。可以把这个容器看作是个大

的应用程序，它运行在Java虚拟机之上，但不能完成任何特定的任务，因此需要程

序开发者编写代码以完成一项工作，这些编写的程序就称作小应用程序。这样设计的

目的是为了让它能在所有的容器中运行，这些容器实现可能不同，但容器的内部却是

相同的。

通过这种形式，程序开发者就从各种运行环境、各种设备中解放出来，只需设计一个MIDlet，就可以在不同的浏览器上运行。比如不同的厂家、不同型号的手机，只

要它支持J2ME、支持MIDP，就有这样一个容器。至于这个容器的外部形状如何，

程序开发者不必考虑，因为容器的内部都是一样的，只要编写规范的小应用程序就行

了。

MIDlet中这个容器就是MIDP实现，它以SUN公司发布的CLDC规范和MIDP 规范为标准，然后针对设备进行移植，从而提供给所有的MIDlet都一样的容器内部

接口。编写MIDP应用程序的要求就是必须扩展MIDlet类，这个类定义了一些接口，

JAM可以通过这些接口对MIDlet进行控制。MIDlet类位于以下包中：

java.microedtion.midlet，因此，在所有的MIDlet中，都必须引入这个包：import

javax.microedtion.midlet.*。注意：这里midlet表示包时必须小写，而MIDlet类的前

三个字母大写。在本书中，称MIDP应用程序为MIDlet，可以表示整个应用程序，也

可以只表示扩展了MIDlet类的子类，即MIDP应用程序的主类。

14.2.2midlet包介绍

midlet包对MIDP应用程序进行了定义，也定义了应用程序和它所运行的环境之间的接口，如前面所述MIDP应用程序被称作MIDlet。

midlet包中只有一个类——MIDlet，它是MIDP应用程序必须要扩展的父类，还有一个异常类——MIDletStateChangeException，它用来监测MIDP应用程序状态的改

变。Midlet包整个层次结构如下：

class https://www.360docs.net/doc/a69005021.html,ng.Object

一个player知道如

何去解释媒体数

据。某种类型的player

知道如何根据mp3媒体数据

产生声音。另外一个player

知道如何播放一端

QuickTime的movie。

javax.microedition.medi

a.Player接口的实现

（implement）既是这里说

的player。

2

3

GDDC

游戏设计与开发

课程

class javax.microedtion.midlet.MIDlet class https://www.360docs.net/doc/a69005021.html,ng.Throwable class https://www.360docs.net/doc/a69005021.html,ng.Exception

class javax.microediton.midlet.MIDletStateChangeException 14.2.3 扩展MIDlet 类

MIDlet 是一个MIDP 应用程序，应用程序必须扩展MIDlet 类，这样才能使得应用管理器（JAM ）对MIDlet 进行控制，并能够从应用程序描述文件中获取属性，通知和请求状态改变等。

由于MIDlet 类位于包javax.microedtion.midlet 中，因此第一步需要在代码程序中引入这个包：

import javax.microedtion.midlet.*;

注意不要写成“import javax.microedtion.MIDlet.*;接着需要扩展MIDlet 类，它的类名就是要编写的主类名。

扩展后的代码如下：

import javax.microedition.midlet.MIDlet;

public class MyMIDlet extends MIDlet { }

从java 语法上说，这样一个空类是可以编译的，但实际上用eclipse 试图编译的时候会拒绝通过，是因为有三个抽象方法是必须实现的，除非MIDlet 子类也声明为抽象的：

import javax.microedition.midlet.MIDlet;

public abstract class MyMIDlet extends MIDlet { }

但是通常情况下，这种做法是没有意义的，应用程序需要直接扩展MIDlet 类。 14.2.4 构造函数

你能用一个或多个controls 来调整player 的行为。你可

以在player 从媒体转换数据的时候从一个player 实例，取得并且使用controls 。比如，你能用一个VolumeControl 来调节一个采样音频的声音大小。Controls

是

javax.microedition.medi a.Control 接口的实现。详细的Control 子接口在javax.microedition.medi a.control 包中

游戏设计与开发

接着可以为自己的MIDlet子类生成一个构造函数，这和编写J2SE程序是一样的。

这个构造函数并不是必须的，但生成这个构造函数会带来很多便利，因为在整个游戏

的生存期间，它是第一个被调用的，而且只被调用一次，因此可以利用它进行一些应

用程序的初始化工作，比如获取所需要的资源（如游戏中的图片、声音等）、初始化

某些变量等。

这里先写个空的构建函数，在需要的时候可以往里面添加代码：

import javax.microedition.midlet.MIDlet;

public class MyMIDlet extends MIDlet {

public MyMIDlet() {

super();

}

}

类MyMIDlet之内构造函数之外的任何地方可以声明所需要的成员变量（为了程序结构的清晰，通常在紧靠声明的下面进行），比如声明一个原始数据类型（用来记

录游戏中的分数），声明一个类对象，还可以在声明的时候初始化，这与J2SE编程是

一样的，因为它们都遵守标准的Java语言规范。

这里没有声明变量，在需要的时候可以自行添加进去。下面就要描述的是MIDlet 类功能以及其API，只要实现了一些固定的API函数，java应用程序管理器才能对

MIDlet进行管理和控制。

14.2.5MIDlet类功能介绍

要满足java应用程序管理器的要求，必须实现下面三个方法：startApp()、pauseApp()、destroyApp(boolean unconditional),这三个方法分别被java应用程

序管理器用来向MIDlet发出信号，通知它进入某个状态。

实现后的代码如下：

import javax.microedition.midlet.MIDlet;

import javax.microedition.midlet.MIDletStateChangeException;

public class MyMIDlet extends MIDlet {

一个data source

知道如何从它的原

始位置读取到媒体

数据给player。媒体

数据可以被保存在不同的

位置，从远程服务器到

资源文件或者RMS数据库。

媒体数据可以从原始位置

通过HTTP，像RTP一样的流

式传输协议，或者其他机制

传输到player。

javax.microedition.medi

a.protocol.DataSource是

MMAPI中所有data source

类的抽象父类。

4

5

GDDC

游戏设计与开发

课

程

public MyMIDlet() { super();

}

protected void startApp() throws MIDletStateChangeException { }

protected void pauseApp() { }

protected void destroyApp(boolean arg0) throws MIDletStateChangeException {

}

}

这段代码就可以编译，表明它已经满足了java 应用程序管理器的基本要求。是一个完整的MIDP 应用程序。当然这只是一个MIDlet 的框架，并没有完成任何工作。如果要完成所需的特定工作就，编写相应代码就行了，这个工作与在J2SE 中没有什么差别。下面以MIDlet 整个生存周期状态间转换为基础，详细描述MIDlet 的方法和它们的调用机制。

（1） Active 状态

MIDlet 进入的第一个状态不是Active 状态而是Paused 状态，只是这个状态比较短暂。

在应用程序管理器中，用户可以单击软键Launch,通知应用程序管理器启动用户所选构造函数返回后，MIDlet 就进入了Paused 状态。此时应用程序管理软件会立即获得MIDlet 的控制权，调用startApp 方法。

应用管理软件startApp 方法来向MIDlet 发出信号，通知它已经进入Active 状态，在Active 状态MIDlet 可能拥有资源，只有在MIDlet 处于Paused 状态时才能调用这个方法。

在Active 状态MIDlet 可以完成指定工作，因此程序开发以在这个函数中编写希望MIDlet 执行的代码，比如调用自定义方法，或者其类对象方法等。

可以支持那些类型

的Media 文件？如果

你的装置支持MMAPI 的话，那么这个装置可以播放什么类型的媒体数据呢？支持什么数据传输协议？

MMAPI 并不要求任何指定 的content type 或协议，但你能在运行时找出程序支持什么类型的数据，通过调用

Manager

类的

getSupportedContentType s()

方

法

和

getSupportedProtocols()

方法。 可能发生的最糟糕的事情是什么呢？如果你通过Manager 给Player 一种不支持的数据类型或协议，它会抛出个exception 。 你的程序应该试图去从这样的例外中恢复过来，可以显示些礼貌的信息提示给用户。

游戏设计与开发

例如下面的代码：

import javax.microedition.midlet.MIDlet;

import javax.microedition.midlet.MIDletStateChangeException;

public class TestMIDlet extends MIDlet {

String message;//声明一个成员变量

public TestMIDlet() {//在构建函数里进行初始化工作

super();

message = new String("I'm initiated,adn in Paused state.");

showMsg(message);

}

protected void startApp() throws MIDletStateChangeException {//在这里进行要完成的工作

message = "I'm in Active state now.";

showMsg(message);

}

protected void pauseApp() {

// TODO Auto-generated method stub

}

protected void destroyApp(boolean arg0) throws MIDletStateChangeException {

// TODO Auto-generated method stub

}

MIDP 2.0的媒

体 :MIDP 2.0规范包括了

一个MMAPI的子集。它向上

兼容所有API。MIDP 2.0子

集有如下特性：1。只支持

音频回放（录制）。不包含

video控制接口。2。多

Player不能被同步3。

DataSource类和

javax.microedition.medi

a.protocol包的其他类没

有被包括进来；应用程序不

能实现他们自己的协议。

4。Manager类是被简化的。

MIDP要求支持乐音产生和

采样，WAV音频播放。

6

7

GDDC

游

戏

设

计

与

开

发课

程

private void showMsg(String msg) { System.out.println(msg);

}

}

在eclipse中编译并运行这个程序，控制台上会输出如下结果：

I'm initiated,adn in Paused state.

I'm in Active state now.

应用管理软件调用这个MIDlet,它会首先调用构造函数，然后再调用startApp,由于构造函数只运行一次，而startApp可能被应用管理软件调用多次，所以需要的初始化工作，应该在构造函数中进行，而不时放在startApp中。这个阶段会有两种错误会导致服务不能启动：

瞬时错误

非瞬时错误

对于瞬时错误，应用程序应该抛出异常—MIDletStateChangeException(如果MIDlet 不能立即启动，但能够在以后启动时，则抛出这个异常，对于非瞬时错误，notifyDestroyd方法会被调用。

如果在startApp期间发生运行时异常，MIDlet会立即销毁，destroyApp方法会被调用允许MIDlet进行清除工作。

（2）Paused状态

MIDLET进入的第一个状态就是Paused状态，然后通过通用startApp方法进入Active状态。

?从Active状态进入Paused状态

在Active状态下（并且只有这个状态下），应用程序管理以调用pauseApp方法向MIDlet发出信号，通知它暂停运行并进入Paused状态。在Paused状态，MIDlet 必须释放共享资源并静止。如果pauseApp期间发生运行时异常，MIDlet将被立即销毁，此时会调用destroyApp方法，允许MIDlet进行清除工作。

在Active状态下（并且只有这个状态下），MIDlet可以使用notifyPaused方法通知应用管理软件它不需要活动了，并进入Paused状态，如果MIDlet被销毁，或者还没有启动，调用这个方法将没有效果。

?从Paused状态进入Active状态MotoJ2SDK是为摩托罗拉388手机定制的命令行开发工具包，当然也可与IDE 开发工具集成从而方便用户的开发。其中可以集成的开发环境包括：CodeWarrior, JCreator 等。另外SUN公司还提供了Java的开发工具，J2ME Wireless Tookit是为无线手持设备（MDIP）定制的简易开发工具包。如果用户需要更强的IDE开发环境，那么请选用Forte for Java CE。目前SUN公司提供的开发工具中暂时还没有388的模拟器。

游戏设计与开发

在Paused状态下，应用程序管理软件可以调用startApp()方法，使它再次活动。

另外，resumeRequest()给MIDlet提供了一个指出它要进入Active状态的机制，应用管理软件将通过这方法调用, 断哪个应用程序要转移到Active状态。当应用管

理软件决定激活这个应用程序时，它将调用startApp方法。

当调用resumeRequest()方法时，应用程序一般处于Paused状态。即使在Paused 状态应用程序也可处理异步事件，如timer或回叫等。

notifyPaused方法和resumeRequest方法被声明为final,在MIDlet子类中不能重载这个方法。

继续修改TestMIDlet.java前面的代码，进行测试：

import javax.microedition.midlet.MIDlet;

import javax.microedition.midlet.MIDletStateChangeException;

public class TestMIDlet extends MIDlet {

String message;//声明一个成员变量

boolean hasTested;//声明一个变量，代表是否测试过。

public TestMIDlet() {//在构建函数里进行初始化工作

super();

message = new String("I'm initiated,adn in Paused state.");

hasTested = false;

showMsg(message);

}

protected void startApp() throws MIDletStateChangeException {//在这里进行要完成的工作

message = "I'm in Active state now.";

showMsg(message);

if (!hasTested) {

notifyPaused();

moto手机开发的问

题,四级灰度的颜色

值怎么表示？

private final static int

WHITE_COLOR =

0x00FFFFFF;

private final static int

LIGHT_GRAY = 0x00888888;

private final static int

DARK_GRAY = 0x00444444;

private final static int

BLACK_COLOR =

0x00000000;

8

9

GDDC

游戏设计与开发

课程

pauseApp();

}

}

protected void pauseApp() { message = "I'm paused."; showMsg(message); hasTested = true; resumeRequest();

}

protected void destroyApp(boolean arg0) throws

MIDletStateChangeException {

// TODO Auto-generated method stub

}

private void showMsg(String msg) { System.out.println(msg);

}

}

例子中 在MIDlet 处于Active 状态时调用notifyPaused 和pauseApp 方法，使应用程序进这入Paused 状态，在Paused 状态下又调用startApp 方法，重新进入Active 状态。这里设置了一个布尔变量hasTested,目的是为了防止循环。

（3） Destroyed 状态

在Paused 或者Active 状态下，应用管理软件可以调用方法destroyApp,向MIDlet 发出信号终止运行并进入Destroyed 状态。在Destroyed 状态。在Destroyed 状态MIDlet 必须释放所有资源，并保存任何持久状态。

被终止之前，MIDlet 应该执行所有需要的操作，比如释放资源或者保存参数选择或状态，因此可以在这个方法里完成一些清除工作。

moto 手机开发的问题,怎么样程序知道是运行在模拟器上还是在手机上

看IMEI 号。一般手机按"*#06#"就可得到imei 码，每个手机是唯一的。 public

void

paint(Graphics g) { g.drawString("Phone

Parameter:",0, 0, 16|4); g.drawString("IMEI:",0, 30,16|4);

g.drawString(System.get Property("phone.imei"),0, 60,16|4);

g.drawString("Network

Parameter:",0, 90,

16|4);

g.drawString("MCC:"+Sys tem.getProperty("phone.mcc"),0, 120,16|4); g.drawString("MNC:"+Sys tem.getProperty("phone.mnc"),0, 150, 16|4); g.drawString("LAI:"+Sys tem.getProperty("https://www.360docs.net/doc/a69005021.html,i"),0, 180, 16|4); g.drawString("CID:"+Sys tem.getProperty("phone.cid"),0, 210, 16|4); }

游戏设计与开发

这个方法有一个参数unconditional,如果它的值设置为false,就可通过抛出MIDletStateChangeException异常，使MIDlet能够请求不进入Destroyed状态，并

且这将是unconditional标志设置为false时惟一合法的响应。如果为true,MIDlet

被假定处于Destroyed状态，必须清除并释放所有的资源，而不管这个方法是如何终

止的。如果它不是一个unconditional请求，通过抛出一个

MIDletStateChangeException异常，使MIDlet表示它打算处于当前状态，这是一个

比较好的请求，在迟些时候会再次调用destroyApp()方法。

如果在destroyApp期间发生运行时异常，那么这些异常将被忽略，MIDlet被置于Destroyed状态。

MIDlet使用notifyDestroyed()方法通知应用管理软件它已经进入Destroyed状态，应用管理软件将不再调用MIDlet的destroyApp方法，MIDlet所拥有的所有资

源将认为合法收回。MIDlet必须执行它调用MIDlet.destroyApp()方法时一样的操作

（清除，释放资源等等）。

因此在需要退出MIDlet的时候，可以调用notifyDestroyed()方法，而在destroyApp函数中完成一些清除工作。

继续修改MyMIDlet.java前面的代码，使它能够退出应用程序并进行一些清除工作：

import javax.microedition.midlet.MIDlet;

import javax.microedition.midlet.MIDletStateChangeException;

public class TestMIDlet extends MIDlet {

String message;//声明一个成员变量

boolean hasTested;//声明一个变量，代表是否测试过。

public TestMIDlet() {//在构建函数里进行初始化工作

super();

message = new String("I'm initiated,adn in Paused state.");

hasTested = false;

showMsg(message);

}

moto手机开发的问

题,看别人的game

源代码时，找不到

resource(图片)的

原因:

如果你还没有添加一个

叫做J2ME_RESOURCE_DIR的

新的环境变量的话,建立

他,具体步骤如下:win98

下：编辑c:\autoexec.bat

文件，加入set

J2ME_RESOURCE_DIR=你的

工程目录，重起系统。

win2k下：我的电脑-》属性

-》高级-》环境变量-》系

统-》添加-》名称：

J2ME_RESOURCE_DIR

内容：你的工程目录配好

后，每当你在jcreator中

打开时，就自动转向你的

J2ME_RESOURCE_DIR所指定

的目录

10

11

GDDC

游

戏

设

计

与

开

发课

程

protected void startApp() throws MIDletStateChangeException {//在这里进行要完成的工作

message = "I'm in Active state now.";

showMsg(message);

if (!hasTested) {

notifyPaused();

pauseApp();

}else{

notifyDestroyed();

}

}

protected void pauseApp() {

message = "I'm paused.";

showMsg(message);

hasTested = true;

resumeRequest();

}

protected void destroyApp(boolean arg0) throws MIDletStateChangeException {

message="I'm destroyed.";

showMsg(message);

message=null;

}

private void showMsg(String msg) { 我在运行编译好的程序时，仿真器出现错误警告

我在运行编译好的程序时，仿真器出现Exception: https://www.360docs.net/doc/a69005021.html,ng.NoClassDefFou ndError。请问是怎么回事？

可能有两个：首先，要注意Package路径，例如，对于package

com.mot.j2me.midlets.te st，您的类一定是在以下路径：%ClassPath%\com\mot \j2me\midlets\test\。其次，要注意大小写，例如，test.class和Test.class 是两个不同的类。

游戏设计与开发

System.out.println(msg);

}

}

注意，为了确保MIDlet能够真正退出并进行清除工作，在执行退出功能的代码可以是：notifyDestroyed();

destroyApp(true);

另外，在MIDlet中永远不要使用“System.exit(0);”语句，否则它边应用程序管理软件也退出了。

下面总结了一下本小节讲进的内容，MIDlet类的方法允许应用管理软件生成,启动，暂停和销毁MIDlet,可以认为MIDlet就是应用管理软件通过它的接口运行和控

制其类的集合。它的状态机制允许应用管理软件在一个运行时环境中管理多个MIDlet

的活动，通过分别启动和暂停，它可以选择让哪个MIDlet进入活支状态。应用管理

软件维护MIDlet的状态，并在这个MIDlet上调用相应方法来改变状态。通过实现这

些方法，MIDlet修正它的内部活动，资源的使用由应用管理软件控制。

MIDlet本身也可以发起一些状态改变，并通过调用相应方法向应用管理软件通知状态的改变。

注意，这些方法通过发送信号，通知状态的改变，但是直到状态改变方法成功返回，状态改变才算成功完成，也就是说这些方法调用会立即返回，不等待状态的真

正改变。

14.2.6从MIDlet中访问JAR/JAD属性

类MIDlet中的方法getAppProperty(String Key)给MIDlet提供了一个机制，使它能从应用管理软件获取一个己命名属性，包括所有的定义在清单文件（在JAR文

件中）和JAD文件的属性。如果有同名的属性，则JAD中的属性会覆盖清单文件中的

相应属性。

下面的例子展示了如何从jar/jad文件中读出并打印属性值，请读者根据学过的方法和本章开始的说明，自已生成一个项目，完成这个例子。

MyMIDlet.jar中的manifest.mf文件的内容如下（打开项目目录中bin\子目录下的MANIFEST）MF文件，更改为下面的文件，然后保存：

MIDlet-Version: 1.0.0

MIDlet-Vendor: game college

MicroEdition-Configuration: CLDC-1.0

MicroEdition-Profile: MIDP-1.0

装入png图形文件

时的问题 :

我在装入png图形文件时，

运行时出现如下

Exception：image cannot

be loaded or decoded。可

是png文件在看图软件下显

示很正常。应该如何正确显

示呢？

先要用图形处理软件生成

PNG文件，然后把它转换成

字节数组，内容要一一对

应。PNG的颜色应该为2bit

或1bit，因为硬件设备只支

持4级灰度显示。创建图的

语句应该是如下格式：

Image.createImage(byte[

] imagedata, int

imageoffset, int

imagelength)，其中，

imagedata 的格式为：

{;(byte)0x89,

(byte)0x50, (byte)0x4E,

(byte)0x47,

(byte)0x0D,....

12

13

GDDC

游戏设计与开发

课

程

MIDlet-Name: MyMIDlet MIDlet-Data-Size:1500 MIDlet-1:MyMIDlet,,MyMIDlet

MyMIDlet.jad 的内容（打开项目目录中bin\子目录下的MyMIDlet.jad 文件，更改为下面的文件，然后保存）：

MIDlet-Version: 1.0.0 MIDlet-Vendor: game college MIDlet-Jar-URL: MyMIDlet.jar MIDlet-Jar-Size ：1000 MIDlet-Name: MyMIDlet MIDlet-Data-Size:1500 MIDlet-1:MyMIDlet,,MyMIDlet Application-Country ：China

其中属性Application-Country 是用户自定义属性。 import javax.microedition.midlet.MIDlet;

import javax.microedition.midlet.MIDletStateChangeException; public class MyMIDlet extends MIDlet {

protected void startApp() throws MIDletStateChangeException {

System.out.println("Vendor: "+getAppProperty("MIDlet-Vendor")); System.out.println("Application Country:

"+getAppProperty("Application-Country")); System.out.println("MIDlet-Data-Size: "+getAppProperty("IDlet-Data-Size"));

}

protected void pauseApp() {

// TODO Auto-generated method stub

有两个办法让你刚

做好的图片在MIDlet 上变成动画。第一，把图片都放到

一个web 服务器上，让MIDlet 下载他们， MIDP 内置的HTTP 支持。第二个办法更简单，把图片用MIDlet 打包成jar 文件。如果你使用的是J2ME 开发工具，把PNG 文件放你的项目文件里面就可以了。

游戏设计与开发

}

protected void destroyApp(boolean arg0) throws MIDletStateChangeException {

// TODO Auto-generated method stub

}

}

14.3Display类

在第13章，我们曾简单的讲过Display类。用户界面和任何其他API资源一样，根据MIDP应用程序管理的原理进行控制，MIDP中使用类Display进行用户界面的

管理，负责与应用程序管理器进行交互，参见下表。

类Display方法说明

https://www.360docs.net/doc/a69005021.html,ng.Object

|

+--javax.microedition.lcdui.Display

方法

void callSerially(Runnable r)

这个方法用来序列化事件流，使Runnable对象r的run()方法在

重画周期完成之后马上运行

Displayable getCurrent()

获得此MIDLet当前的Displayable对象

static Display getDisplay(MIDlet m)

获得此MIDlet惟一的Display对象

boolean isColor()

获得设备所支持的色彩信息

int numColors()

获得设备所能表示的色彩数目（如果isColor()返回true）或灰度MIDlet套件: 虽

然把MIDlet封装进 Java

档案文件(JAR)并不一定必

要，但这是发布 J2ME/MIDP

应用程序最常见的方法。

MIDlet套件是一个MIDlet

中所有的文件以及作为

MIDlet一部分的必需的资

源的集合。MIDlet套件由以

下几部分组成：1、附在JAR

文件中的 Java类文件，2、

描述 JAR文件内容的清单

文件3、附在 JAR文件

中的资源(如图象)和Java

应用程序描述符文件

(JAD)4、应用程序管理器

14

15

GDDC

游戏设计与开发

课程

级（如果isColor()返回false ）

void setCurrent(Alert alert ，Displayable nextDisplayable)

请求这个Alert 的对象被设置为当前的，在Alert 解除之后把

nextDisplayable 设置为当前的

void sdtCurrent(Displayable nexDisplayable)

请求一个不同的Displayable 对象在设备显示屏上可见 从类https://www.360docs.net/doc/a69005021.html,ng.Object 继承的方法：

equals,getClass,hashCode,notify,notifyAll,toString,wait

Display 代表了系统显示屏和输入设备的管理器，包含用来获取设备属性的方法，以及请求要在设备上显示对象的方法，其他处理设备属性的方法主要用于Canvas 对象，这些方法将在介绍Canvas 类时描述。

一个MIDlet 只能有一个Display 实例，应用程序可以调用getDisplay()方法获取此实例的引用。应用程序从调用startApp()开始到destrlyApp()调用返回都可调用getDisplay()方法，期间所有调用getDisplay()返回的Display 对象都是同一个对象。

下面的例子展示了在一个MIDlet 生存周期中如何调用Display 对象： import javax.microedition.lcdui.Display; import javax.microedition.lcdui.TextBox; import javax.microedition.lcdui.TextField; import javax.microedition.midlet.MIDlet;

import javax.microedition.midlet.MIDletStateChangeException;

public class TestDisplay extends MIDlet {

Display display;//引用MIDlet 的Display 对象

TextBox tb;//TextBox 是一个Displayable 对象(可显示的控件) public TestDisplay() { display=Display.getDisplay(this);//获取一个Display 实例,它是唯一的.

tb=new TextBox("titile","XYZ",25,TextField.ANY) ;//初始化该控件

应用程序管理器是一

个移动设备上的软件程序，这个应用程序与具体的设备有关，并且由设备的生产商实现。它负责安装、运行以及从设备上删除 MIDlet ，而提供错误处理支持。这个应用程序管理器同时还提供一个可选界面，允许用户启动、终止以及删除 MIDlet 。

游戏设计与开发

}

protected void startApp() throws MIDletStateChangeException {

display.setCurrent(tb);//将当前屏幕设置为该控件

}

protected void pauseApp() {

}

protected void destroyApp(boolean arg0) throws MIDletStateChangeException {

}

}

在这个例子中，首先声明了两个对象：

Display display;// 引用MIDlet的Display对象

TextBox tb;//textaBox是一个Displayable对象

对象display用来引用设备的Display实例，一个MIDlet的实例是惟一的，在一个程序中可以多次引用此实例，但指向同一个对象。因为TexBox类继承了Screen类，

而Screen类继承了Displayable类，因此textBox对象实例也发型Displayable类，它

将作为参数传递给方法：

void Display.set Currrent(Displayable nextDisplayable);

在构造函数TestDisplay ()中，第一个语句用来获取设备的Display实例，第二条语句初始化一个TextBox类的实例textBox，它也是一个Displayable对象。方法

startApp()中把textBox设置为当前屏幕对象。运行这个程序，应用程序管理器调用

startApp()方法，把这个文本框设置为当前屏幕，如下图所示。TextBox类在下一章会

有详细的介绍。

Java档案文件:

一个商品化的、封装过应用

程序通常由许多文件构成。

除了 Java类以外，其他文

件诸如图像和应用程序数

据即通常所说的资源，也可

能是这个程序包的一部分。

你把所有这些信息捆绑进

一个整体，就称为 JAR文

件。

16

17

GDDC

游

戏

设

计

与

开

发课

程

14.4Displayable类

在显示设备上显示的用户显示的用户界面对象为Displayable对象，在同一时刻

应用程序最多只能有一个Displayable对象，这个Displayable对象显示在显示屏设备上，并通过它进行与用户的交互。这个被引用的Displayable对象称作当前Displayable 对象。类Displayable方法说明如下表所示。

类Displayable方法说明

https://www.360docs.net/doc/a69005021.html,ng.Object

|

+-javax.microedition.lcdui.Displayable

void addCommand(Command cmd)

向Displayable对象添加一个 Command对象

boolean isShown()

检查Displaysble对象在显示屏上是否真正可见

void removdCommand(Command cmd)

从Displayable对象中删除一个Command对象创建一个 JAD文件是基于两个原因:1、向应用程序管理器提供信息，说明 JAR文件的内容，使用这些信息，就可以判断一个 MIDlet是否适合运行在这个设备上。例如，通过查看属性MIDlet-Data-Size，应用程序管理器可以确定 MIDlet 是否需要比设备可以提供的更多的内存。2、提供一种方法，可以把参数传送到MIDlet而不必更改 JAR文件,在本文的后半段我们将看一个这样的例子。

18

游戏设计与开发

void setCommandListener(CommandListener 1)

为这个Displayable 对象设置一个CommandListener 对象，它会取代任何前 面设置的CommandListener 对象

从类https://www.360docs.net/doc/a69005021.html,ng.Object 继承的方法：

equals,getClass,hashClde,notify,notifyAll,toString,wait,

类Displayable 有两个直接子类：Canvas 和Screen,前者是MIDP UI 的低级

API ，后者则是MIDP UI 所有高级组件的父类，因此Canvas 和Screen 及其子类都可作为参数传递给方法Displayable.setCurrent(Displayable nextDisplayable)。

方法isShown()用来检查Displayable 对象在显示屏上是否真正可见。要使对象Displayable,下列所有条件都必须为真。

◆ 此Display 实例所在的MIDlet 必须运行于前台。 ◆ Displyable 对象必须是此Display 实例的当前屏幕。 ◆ Displayable 必须不被系统屏幕所覆盖。

如果此Displayable 对象是当前可见的则返回true,否则返回false.

方法addCommand(command cmd)和removeCommand(Command cmd)分别用来给Displayable 对象增加和删除Command 类，setCommandListener(CommandListener1)用来这为Displayable 对象设置Command 事件监听器。

类Display 的方法setCurrent()用来设置当前Displayable 对象，方法getCurrent()用来获取当有Displayable 对象。应用程序控制当前Displayable 对象。不过并不总是这种情况，另一个线程可能响应其他的事件，改变当前Displayable 对象，当Alert 对象的计时器超时后当前Displayable 对象也将会改变。

应用程序的当前Displayable 对象不一定绘制到屏幕上，用户事件（比如击键动作）的发生也不一定要定向到当前Displayable 对象。在同一个设备上同时运行其他MIDlet 应用程序的时候可能会出现这些情况。

如果当前Displayable 对象在显示设备上是实际可见的，并且如果用户输入设备事件将被传递给它，那么这个应用程序就被作位于前台：如果应用程序不在前台，就不能对显示屏和输入设备进行访问，则被称作位于后台。把这些设备分配给不同的MIDlet 应用程序超出了MIDP 规范规定的范围，它由称作应用管理软件的外部代理进行控制。

应用程序任何时候都有当前Displayable 对象的概念，即使它位于后台。当前Displayable 对象十分重要，即使是对后台应用程序来说，因为当前Displayable 对象

RetroGuard 是Java 混

淆器，使用时先安装JDK 。运行前需要设置PATH 外，还在CLASSPATH 中加入D:\retroguard\RetroGuar d.jar 。然后准备混淆的.jar 文件包。它的格式是：java RetroGuard [输入JAR 文件 [输出JAR 文件[“保留脚本文件” [日志文件]]]]， 其中“保留脚本文件”描述了那些类、函数、变量名必须保留，不能被混淆；日志文件是执行后生成的记录文件，记录的错误、混淆情况等信息。对于“保留脚本文件”可以通过一个图形界面RGgui 来设置，执行命令是： java RGgui 运行后，可以根据提示选择输入Jar 文件，选择要保留的类、函数、变量，完成后会自动生成“保留脚本文件”。其实通常情况下只要保留运行的起始类名称就可以了。

19

GDDC

游

戏设计与开发

课程

总是在下次应用程序进入前台时所要显示的那个。应用程序可以通过调用isShown()方法来判断Displayable 对象在设备上是否可见。如果是Canvas 对象，调用showNotify()和hideNotify()方法可以分别使它可见和隐藏。

（1） 设置当前Displayable 对象

方法setCurrent(Displayable nextDislayable)用来设置Displayable 对象，使它在显示屏上可见。通常这个改变不会立即生效，可能会有延迟，使它能够在两个事件传递方法的调用这间发生，但不能保证在下个事件传递方法被调用之前发生，不过setCurrent()方法会立即返回，而是不用等待改变生效。因为这个延迟，在调用setCurent()之后立即调用getCurrent()方法，不一定会返回传递给setCurrent()的那个值。

对setCurrent()的调用不会使用队列机制，如果一个setCurrent()方法调用延迟，随后再次调用setCurrent()方法，前一个调用可能会被取消，例如如S1是当前屏幕，那么连续调用这两个方法之后：

display.setCurrent(S2); display,setCurrent(S3);

最终的结果会使S3成为当前屏幕，而S2则完取消了。

MIDlet 第一次启动时没有当前Displayable 对象，所以应用程序要负责确保

Displayable 对象是可见的，并且能在整个期间与用户交互。因此应用程序应该总是调用setCurrent(),作为它初始化的一部分。

应用程序可以把null 作为参数传递给setCurrent()，但设置当前Displayable 对象为null 时不会产生效果，相反当前Displayable 对象会保持不变。但是应用管理软件会把这解释为来自应用程序的一个暗示，即应用程序请求被置入后台。如果应用程序已经在后台运行，传递一个非空引用给setCurrent()会被应用管理软件解释为应用程序请求被置入前台的一种暗示，这个请求可把录前Displayable 对象传递给setCurrent()调用，例如下面的代码：

display.setCruuent(display.getCurrent());

这个请求没有效果，只是请求把应用程序置入前台。这些请求仅仅是暗示，而并不要求应用管理软件完全遵照这些请求执行。

（2） 获取当前Displayable 对象

每个MIDlet 应用程序都有当前Displayable 对象，意味着getCurrent()方法总会返回MIDlet 的当前Displayable 对象，而不管MIDlet 是位于前台还是后台。例如假定一个MIDlet 正在运行于前台，它有当前的Displayable 对象F ，一个MIDlet 正在运行于后台，有当前的Displayable 对象B 。当前台MIDlet 调用方法getCurrent(),它将返回F ，当后台MIDlet 调用getCurrent()方法，它将返回B 。并且，如果某个MIDlet 通过用setCurrent()方法改变了当前的Displayable 对象，这不会影响任何其他MIDlet 的当前

PointBase 非常独特，

因为它是第一个经过认证的100%纯Java 数据库，可用于任何使用的 Java 2 标准版虚拟机(JVM)的平台。在2001年6月的JavaOne 大会上，PointBase 发布了PointBase 袖珍版产品——一个为 J2SE 和 J2ME 环境设计的占用资源少的(不到 45KB )数据库。如果你的目标平台包含一个兼容J2ME 的虚拟机，PointBase 允许你部署一个SQL 数据库应用程序。J2ME MIDP 虚拟机目前可用于Win32，Palm OS ，Windows CE 和摩托罗拉IDEN 电话。

游戏设计与开发

Displayable对象。

调用getCurrent()方法还可能返回null，启动期间MIDlet应用程序调用setCurrent()设置它第一个屏幕之前会发生这种情况。即在MIDlet调用setCurrent()方法之前，

getCurrent()方法永远也不会返回一个Displayable对象的引用。

在“设置Displayable对象”小节中已经说明，方法setCurrent()设置一个Displayable 对象，使它显示在显示屏上，但这个改变通常不会立即生效，它可会有延迟。因为这

个延迟在调用setCurrent()之后间隔不久就调用getCurrent()方法，不一定会返回传递

给setCurrent()的那个值。

(3) 系统屏幕

通常情况下,前台MIDlet的当前屏幕在显示屏上是可见的,不过某些情况下系统可能会生成一个屏幕,临时代替应用程序的当前屏幕,这些屏幕被称作系统屏幕(system

screen)。在下列时候会了生这种情况：系统需要显示命令菜单时，或者如果系统需要

用户在一个单独屏幕中编辑文本，而不是在一个表单的文本输入框中编辑。即使系统

屏幕会临时取代应用程序的屏幕，当前屏幕的引用也不会改变，特别是，当系统屏幕

可见时，调用getCurrent()也将返回应用程序的当前屏幕，而不是系统屏幕。不过当前

Displayable对象被系统屏幕覆盖时，调用isShown()返回的值是false.

如果系统屏幕取代了画布（canvas）对象，它的hideNotify()方法会被调用。当系统屏幕消除后，则恢复画布对象，其方法showNotify()和paint()会被调用。如果系统

屏幕被用户用作提交命令，commandAction()方法则在showNotify()方法被调用之后才

调用。

（4）获取设备信息

isColor()和numColors()这两个方法用来获取设备支持的色彩信息。如果

isColor()返回true，表明设备显示屏支持彩色，numColors()则返回设备支持的色彩数

目；如果isColor()返回fslse,表明设备显示屏不支持彩色，numColors()则返回设备支

持的灰度级，如果设备只支持黑白两色，其返回值为2。

由于MID设备的多样性，如果要采用低级API设计程序，那么获取设备支持的色彩信息将十分重要，比如设计游戏等。

下面就是一个获取设备色彩信息的例子，在MIDlet程序中只是简单地调用类Display的isColor()和numColors()方法：

import javax.microedition.lcdui.Display;

import javax.microedition.midlet.MIDlet;

import javax.microedition.midlet.MIDletStateChangeException;

public class TestDeviceColor extends MIDlet {

优化J2ME程序大

小：就是破坏程序的继承

关系。你也许把相关的代码

放到一个或多个抽象类中，

这是OOD中为提高程序间代

码重用的推荐做法。虽然破

坏继承关系与你所学知识

相违背，但简化的继承关系

更有意义。特别的，当你的

的抽象类――可能来自其

他项目――仅仅被继承一

次时，破坏继承关系的结果

不言而喻。例如，例子

MIDlet继承了BasicMIDlet

类，但两者合并为一个类。

20