目录 BlackBerry 上消息提醒的方法总述背景常见的 6 种提醒方式应用程序图标 LED 灯震动提示音 Indicator 在系统的 Messag

Size: px

Start display at page:

Download "目录 BlackBerry 上消息提醒的方法总述背景常见的 6 种提醒方式应用程序图标 LED 灯震动提示音 Indicator 在系统的 Messag"

暂固亥
5 years ago
Views:

1 BlackBerry 上不同的消息提醒方法作者 : 王恒进 1

2 目录 BlackBerry 上消息提醒的方法总述背景常见的 6 种提醒方式应用程序图标 LED 灯震动提示音 Indicator 在系统的 Message Inbox 中加入你的应用程序

1. 背景 BlackBerry 上的一大特色就是基于消息的功能, 其中消息提醒功能是初学 BlackBerry 遇到的一大难题 BlackBerry 上的消息 (Messaging) 定义很广, 包括邮件短信 / 彩信即使消息 ( 如 MSN/FaceBook/Twitter/BlackBerry Messenger 等 ) 以及应用程序自己定义的消息这些消息到达 BlackBerry

3 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); 3

4 2, 更新应用程序图标为未读 Bitmap icon=bitmap.getbitmapresource("icon/read.gif"); net.rim.blackberry.api.homescreen.homescreen.updateicon(icon); 2.2 LED 灯效果 : 4

5 示例代码 : 1, 首先需要 import 相应的 API 包 : import net.rim.device.api.system.*; 或者 import net.rim.device.api.system.led; 2, 关闭 LED 灯 5

6 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 的机制, 可以在顶部状态栏显示一个小图标, 同时还可以在小图标旁边显示一个数字, 来标识是否有新消息到来以及新消息的数目 6

7 效果 : 常用的实现步骤 : 在系统中注册自己的图标每来一条新的消息, 将图标设为显示状态, 并且将图标旁边的数字加 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 实例 7

ApplicationIndicator AppIndicator = reg.getapplicationindicator(); 第三步 : 操作 Indicator( 显示 / 隐藏 / 删除 ) // 设置图标和数值 AppIndicator.set( newicon, newvalue ); // 显示图标 ApplicationIndicator.setVisible(true).

8 ApplicationIndicator AppIndicator = reg.getapplicationindicator(); 第三步 : 操作 Indicator( 显示 / 隐藏 / 删除 ) // 设置图标和数值 AppIndicator.set( newicon, newvalue ); // 显示图标 ApplicationIndicator.setVisible(true). // 隐藏图标 ApplicationIndicator.setVisible(false). // 从系统中删除图标的注册信息 ApplicationIndicatorRegistry.unregister(). 3. 在系统的 Message Inbox 中加入你的应用程序系统的 Message Inbox 中是所有消息的唯一入口, 包括 ,SMS/MMS,IM 以及第三方应用的消息 BlackBerry 提供一种机制, 允许第三方应用将自己的消息写入 Message Inbox, 并且定制这些消息的图标, 以及菜单项等同时可以建立自己的应用程序消息目录, 将自己的消息存放在这个目录下效果 : 8

9 常用的实现步骤 : 分为两个步骤, 第一个步骤是将你的图标和你的应用程序关联起来在系统的 Message Inbox 中注册你自己应用的消息, 并且为这些消息对应上你自己定制的图标, 同时为这些消息定制菜单项 ( 如上图所示 ) 示例代码如下 : 1. 调用 EncodedImage.getEncodedImageResource, 通过一个图片文件名来生成 ApplicationIcon 对象. ApplicationIcon newicon = new ApplicationIcon( EncodedImage.getEncodedImageResource( "ml_sample _new.png" ) ); ApplicationIcon openedicon = new ApplicationIcon( EncodedImage.getEncodedImageResource( "ml_sample _opened.png" ) ); 2. 调用 ApplicationMessageFolderRegistry.registerMessageIcon 来将消息状态 / 图标, 和消息关联起来 int MESSAGE_TYPE = 0; reg.registermessageicon( MESSAGE_TYPE, STATUS_NEW, newicon ); reg.registermessageicon( MESSAGE_TYPE, STATUS_OPENED, openedicon ); 通过以上步骤, 当 Message Inbox 中的消息为未读状态时, 显示的图标为 newicon; 已读状态时, 显示的图标为 openedicon 第二个步骤是在 BlackBerry 中定义一个消息存放的应用消息目录, 以及这个目录对应的消息处理函数进入应用消息目录的方法如下 : 查看根目录名的方法, 选择桌面消息, 进去后点菜单键, 向下滚动选择查看文件夹, 在目录树中就可以看到你设置的目录名了 9

10 示例代码如下 : 1. 创建一个类, 来实现接口 ApplicationMessage public class MLSampleMessage implements ApplicationMessage 获取 ApplicationMessageFolderRegistry 的引用 ApplicationMessageFolderRegistry reg = ApplicationMessageFolderRegistry.getInstance(); 在 BlackBerry 上注册自己的应用目录, 来存放来自你的应用的消息在下面, 注册了两个目录, 一个是 Inbox, 另一个是 Deleted Messages ReadableList inboxmessages = messages.getinboxmessages(); ReadableList deletedmessages = messages.getdeletedmessages(); ApplicationMessageFolder inboxfolder = reg.registerfolder( INBOX_FOLDER_ID, "Inbox", inboxmessages ); ApplicationMessageFolder deletedfolder = reg.registerfolder( DELETED_FOLDER_ID, "Deleted Messages", 10

11 deletedmessages, false ); 为制定的目录追加事件处理函数 deletedfolder.addlistener( this, ApplicationMessageFolderListener.MESSAGE_DELETED ); 2. 创建一个类, 来实现接口 ApplicationMessageFolderListener. public class AppFolderListener implements ApplicationMessageFolderListener 下一步, 需要调用 actionperformed() 来处理 Folder 事件, 这个方法定义在接口 ApplicationMessageFolderListener 中. public void actionperformed( int action, ApplicationMessage[] messages, ApplicationMessageFolder folder ) { // check if action was performed on multiple messages if( messages.length == 1 ) { switch( action ) { case ApplicationMessageFolderListener.MESSAGE_DELETED: messagestore.deleteinboxmessage( message ); 3. 设置根目录名, 之前设置的消息目录会列在这个根目录下 reg.setrootfoldername( "OA List" ); 11

目录 BlackBerry 上消息提醒的方法总述 背景 常见的 6 种提醒方式 应用程序图标 LED 灯 震动 提示音 Indicator 在系统的 Messag

目录 BlackBerry 上消息提醒的方法总述背景常见的 6 种提醒方式应用程序图标 LED 灯震动提示音 Indicator 在系统的 Messag