BlackBerry 上不同的消息提醒方法

作者: 王恒进

1.  背景

BlackBerry 上的一大特色就是基于消息的功能，其中消息提醒功能是初学 BlackBerry 遇到的一 大难题。BlackBerry 上的消息（Messaging）定义很广，包括邮件、短信/彩信、即使消息（如 MSN/FaceBook/Twitter/BlackBerry Messenger 等）、以及应用程序自己定义的消息。

 

这些消息到达 BlackBerry 时，BlackBerry 提供了 5 种消息提醒的方法，它们是：LED 闪烁、提 示音、界面左上方的小图标提醒（叫做 Indicator），应用程序图标的变化（比如在有新消息到 来时，应用程序图标的右上角会出现一个红色的星号）。

 

同时，BlackBerry 提供一种机制，可以将所有的消息都注册到系统唯一的 Message Inbox 中

（也就是第一排左边第一个图标），在这个 Inbox 中，当不同的应用有新的消息到来时，可以 新添一条自己的记录（包含自定义的应用图标，自定义的打开菜单，在 Message 文件列表中 创建自己的消息目录）。

 

 

2.  常见的 5 种提醒方式

 

  

2.1      应用程序图标

效果：

 

 

 

示例代码：

 

1， 更新应用程序图标为已读

 

Bitmap icon=Bitmap.getBitmapResource("icon/read.gif");

 

net.rim.blackberry.api.homescreen.HomeScreen.updateIcon（icon）;

 

2， 更新应用程序图标为未读

 

Bitmap icon=Bitmap.getBitmapResource("icon/read.gif");

 

net.rim.blackberry.api.homescreen.HomeScreen.updateIcon（icon）;

 

 

 

 

 

 

2.2      LED 灯

效果：

 

 

 

 

 

 

示例代码：

1，首先需要 import 相应的 API 包：

import net.rim.device.api.system.*;

或者

import net.rim.device.api.system.LED;

 

2，关闭 LED 灯

 

if(LED.isSupported(LED.LED_TYPE_STATUS))

{

LED.setState(LED.STATE_OFF);

}

 

3，打开 LED 灯或者开启 LED 灯闪烁

if(LED.isSupported(LED.LED_TYPE_STATUS))

{

//LED.setState(LED.STATE_ON);

//or

LED.setState(LED.STATE_BLINKING); LED.setConfiguration(100, 1000, LED.BRIGHTNESS_100);

}

 

 

4，注意捕获抛出的异常

如果 setState(int state)的输入参数为不正确的状态时，可能会抛出异常:

IllegalArgumentException

 

 

 

2.3      震动

示例代码：

 

net.rim.device.api.system.Alert.startVibrate(5*1000);

 

2.4      提示音

调用系统声音播放的接口，示例如下：

 

// create an instance of the player from the InputStream

 

Player player = javax.microedition.media.Manager.createPlayer(path, type);

 

 

 

player.realize();

 

player.prefetch();

 

 

 

VolumeControl volumeControl = (VolumeControl) player.getControl("VolumeControl");

 

volumeControl.setLevel(100);

 

// start the player player.start();

2.5      Indicator

如下图所示，BlackBerry 提供 Indicator 的机制，可以在顶部状态栏显示一个小图标，同时

还可以在小图标旁边显示一个数字，来标识是否有新消息到来以及新消息的数目。

效果：

 

 

 

常用的实现步骤：在系统中注册自己的图标。每来一条新的消息，将图标设为显示状态，并且将 图标旁边的数字加 1；当每读一条未读消息，将图标设为隐藏，并将图标旁边的数字减 1.

 

示例代码：

 

第一步：创建 ApplicationIndicatorRegistry 和 ApplicationIcon 对象

 

ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();

 

EncodedImage image = EncodedImage.getEncodedImageResource( "clowds.gif" );

 

ApplicationIcon icon = new ApplicationIcon( image );

 

 

第二步：注册或者获取 ApplicationIndicator 对象

 

//第一次调用时，通过方法 ApplicationIndicator register(ApplicationIcon icon,

boolean iconOnly, boolean visible)来注册 Indicator，其中第二个参数控制是否只显示 图标而不显示数字

 

 

ApplicationIndicator indicator = reg.register( icon, false, true);

 

//以后可以通过以下方法来获取已注册的 Indicator 实例。

 

ApplicationIndicator AppIndicator = reg.getApplicationIndicator();

 

第三步：操作 Indicator（显示/隐藏/删除）

 

//设置图标和数值

 

 

AppIndicator.set( newIcon, newValue );

 

//显示图标

 

ApplicationIndicator.setVisible(true).