brewapi及ishell接口.ppt

BREW API及IShell接口,计算机系 计算机科学与技术教研室 办公室：C117,Sun Bin 2009,BREW技术开发与应用,BREW API介绍,BREW作为一个标准化的平台，推出一系列的API，为APP开发商和设备制造商提供一个可依赖的标准。 APP开发商：可以不必考虑硬件的差异，在不同手机上使用BREW 标准API实现相同功能，使BREW App具有高度可移植性 设备制造商：可以以BREW API为标准，在OEM层对硬件功能进行封装，实现BREW接口的统一性次大作业）,Sun Bin 2009,BREW技术开发与应用,BREW API介绍,BREW是一个以面向对象思想为基础的平台，其API也是以类（即接口Interface）的形式划分的，也就是将相关的函数封装在一个接口Interface中。 每一个接口都包含一组相关的API函数 IShell接口外壳接口 IDisplay接口显示 IImage接口图像处理 IGraphics接口图形显示 。,Sun Bin 2009,BREW技术开发与应用,BREW API介绍 接口及函数的命名规则,接口的命名：以I开头，后面单词首字母大写 IShell接口 IImage接口 ISoundPlayer接口。 接口函数的命名：全部大写的接口名_首字母大写的函数名 IDISPLAY_DrawText（）函数 IIMAGE_GetInfo（）函数,Sun Bin 2009,BREW技术开发与应用,BREW API介绍,与Applet一样，每个接口类也都有一个唯一的ClassID 接口的使用方法： 首先要调用ISHELL_CreateInstance创建这个接口的实例，并获得指向该接口实例的指针，然后才可以使用该接口中的API 每一个接口函数的第一个参数都必须是指向该接口实例的指针 在一个接口的实例使用完毕后，需要调用该接口实例的析构函数将该类释放（通常是XXX_Release）,Sun Bin 2009,BREW技术开发与应用,IShell接口,IShell接口是最基本的一个接口 IShell接口实例已经创建好，指向该接口实例的指针在调用入口函数AEEClsCreateInstance()时传入 其他接口实例都是IShell接口来创建 IDisplay接口实例在入口函数调用AEEApplet_New()中已由IShell接口创建 除了上述IShell、IDisplay接口外，用户在程序中使用的其他接口都需要由用户通过IShell接口创建其实例,Sun Bin 2009,BREW技术开发与应用,IShell接口,IShell接口所包含的函数主要完成以下功能： 应用程序管理 警报 对话框、消息框和提示 设备和应用程序配置信息 通知 资源文件和文件句柄 计时器 其它,Sun Bin 2009,BREW技术开发与应用,IShell接口 -应用程序管理,应用程序管理 创建、启动和停止 BREW 类及应用程序 获取设备上的模块和类的信息 允许应用程序互相发送事件 允许运行 BREW 应用程序，且不干扰设备必须执行的其它活动 其中最常用到的函数之一就是用于创建其他接口实例的ISHELL_CreateInstance(),Sun Bin 2009,BREW技术开发与应用,IShell接口 -应用程序管理,应用程序管理 ISHELL_CreateInstance() ISHELL_StartApplet () 启动Applet ISHELL_CloseApplet() 结束Applet 。,Sun Bin 2009,BREW技术开发与应用,IShell接口 警报,警报 当前时间到达指定值时，系统将通知应用程序（将EVT_ALAEM事件传递给应用程序的事件处理函数）。 即使应用程序不在运行也可以接收警报过期的通知。 当通知的时间在比较远的将来时，通常使用警报。 例如，日程约会时间将要来临时，日历应用程序将使用警报提醒用户。 ISHELL_SetAlarm() 设置警报时间 ISHELL_CancelAlarm() 用于取消当前激活的警报。 ISHELL_AlarmsActive() 用于检查任一 BREW 内置报警器（闹钟、倒数计时器或秒表）当前是否处于激活状态,Sun Bin 2009,BREW技术开发与应用,IShell接口 对话框、消息框和提示,ISHELL_CreateDialog() 用于创建对话框 ISHELL_EndDialog()，它将终止栈顶的对话框并显示堆栈中紧挨在它下面的对话框 ISHELL_GetActiveDialog() 函数用于获取栈顶对话框的 IDialog 接口指针。 IDIALOG_GetControl()，用于返回对话框控件的接口指针； IDIALOG_SetFocus()，用于指定多控件对话框中的哪一个控件接受设备用户的输入。 ISHELL_MessageBox() 用于从 BREW 资源文件中读取标题和消息文本， ISHELL_MessageBoxText() 则用于接受指向代码中指定的标题和消息文本字符串的指针。 设备用户按下按键时，将结束这些函数创建的对话框。,Sun Bin 2009,BREW技术开发与应用,IShell接口 设备和应用程序配置信息,ISHELL_GetDeviceInfo() 用于返回设备的 AEEDeviceInfo 数据结构指针，其中包括设备的屏幕大小、颜色支持、可用内存大小，字符编码和其它项目的信息。 AEEDeviceInfo 数据结构内容,Sun Bin 2009,BREW技术开发与应用,IShell接口 通知,IShell 的通知机制允许 BREW 类相互通知发生的特定事件。 要接收通知，已激活的类必须向 AEE 外壳注册，指定通知类的ClassID 和通知的事件。 当发生需要通知的事件时，通知程序类将调用 ISHELL_Notify()，向每个已注册接收该事件通知的类发送通知。,Sun Bin 2009,BREW技术开发与应用,IShell接口 资源文件和文件句柄,应用程序可以使用 IShell提供的许多函数从文件中读取各类数据。 这些文件可以是使用 BREW 资源编辑器创建的 BREW 资源 (.bar) 文件，也可以是内容与 MIME 类型相关或由文件扩展名标识的文件。 ISHELL_LoadResString() 用于将字符串资源读入字符缓冲区 ISHELL_LoadResImage() 用于从指定的资源文件加载位图图像，并返回包含该位图的 IImage 接口实例指针 ISHELL_LoadImage() 用于从指定的图片文件加载图像，并返回包含该位图的 IImage 接口实例指针 。,Sun Bin 2009,BREW技术开发与应用,IShell接口 计时器,要启动计时器，可以调用 ISHELL_SetTimer()，并指定计时器持续时间（毫秒）、回调函数地址以及应用程序特定的数据结构指针。 计时器到期时，AEE Shell会调用回调函数，并将应用程序特定的数据指针用作唯一的参数。 BREW 计时器是一次性、非重发计时器 ISHEL