S60_Platform_Music_Application_Developers_Guide_v1

S60平台：音乐应用开发伙伴指南S60platform版本1.12007年1月31日S60平台：音乐应用开发伙伴指南|2法律提示版权©（2005年，2006年）属于诺基亚公司，诺基亚公司保留全部权利“诺基亚”及“诺基亚科技以人为本”是诺基亚公司的注册商标。Java和所有基于Java的标志是Sun微系统有限公司的商标或注册商标。在此提到的其它产品和公司名称可能是其所有者的商标或商业名称。声明本文档中的信息基于其现有状况，不存在任何保证，包括销售保证、适用某一特殊用途的保证，或从任何建议、规范或范例中衍生出来的保证。此外，本文档所提供的并非最终信息，在其最终发布前会做较大改动。本文档仅用作信息通报。诺基亚公司不承担所有因实施本文档中所表述的信息而产生的相关责任，包括侵犯任何知识产权的责任。诺基亚公司并不保证或认为使用这些信息不会构成对这些知识产权的侵犯。诺基亚公司保留不预先通知而随时修改或撤销本规范的权力。授权许可本授权仅限于因个人应用而下载和打印本说明，除此之外，不存在对其它任何知识产权的授权许可。版本1.1|2007年1月31日S60平台：音乐应用开发伙伴指南|3目录1.简介.......................................................................................................................52.音频优先级和播放选择..........................................................................................63.从文件播放音乐.....................................................................................................73.1用于文件回放的API........................................................................................................73.2选择适当的API................................................................................................................83.3Playutility文件播放的生命周期.......................................................................................83.3.1初始化.....................................................................................................................93.3.2播放.......................................................................................................................153.3.3暂停.......................................................................................................................173.3.4停止.......................................................................................................................183.3.5析构.......................................................................................................................193.4搜寻...............................................................................................................................203.5播放系列文件.................................................................................................................213.5.1前一个文件播完后播放一个新文件.......................................................................223.5.2另一个文件在播时播放一个新文件.......................................................................233.5.3暂停播放前一个文件并开始播放新文件................................................................243.5.4停止播放前一个文件并开始播放新文件................................................................264.读取元数据（metadata）...................................................................................285.从应用程序实现流式缓冲.....................................................................................325.1CmdaAudioOutputStream的生命周期..........................................................................325.1.1初始化...................................................................................................................335.1.2播放.......................................................................................................................345.1.3停止.......................................................................................................................365.1.4析构.......................................................................................................................376.在应用中通过流方式提供互联网音乐服务............................................................397.参考文献..............................................................................................................418.术语与缩略语.......................................................................................................429.对本文评分..........................................................................................................43版本1.1|2007年1月31日S60平台：音乐应用开发伙伴指南|4修订记录2005年12月16日版本1.0文档首次发布2006年11月14日版本1.1删除了有关MetadataUtilityAPI（不再包括在SDK中）的信息2007年1月31日中文版本1.1中文版本发布版本1.1|2007年1月31日S60平台：音乐应用开发伙伴指南|51.简介S60平台向开发伙伴们提供多种解决方案，用于为用户创建和分发丰富多彩的音乐应用。，S60终端强大的音频处理能力也确保了方案的实施。本文介绍了如何使用S60多媒体API，在S603rdEdition及后续版本的手机终端上进行音乐应用的开发。文档既包括讲解也包括范例，演示了如何使用各种多媒体API来完成音乐应用中的一些常规操作。此外，本文也述及实现类似操作的其它一些技术并解释了它们各自在设计上的优缺点。文档的讲解方式通过将某些应用用例转换成对应的多媒体服务，从而充分展示为满足用例要求而对各种API的恰当使用。在一些用例中也许只用到了单个的API，而在另一些用例中，则可能要求使用多个API。对后一种情况我们将讨论这些API的协同使用，同时详细讲述多API协调机制的背后原理。阅读本文前，读者应该熟悉创建S60应用的一些基本方法。关于S60应用创建方面的更多信息请参阅《S60SDKC++开发入门》[1]。因而，本文并不讨论有关UI框架、编译环境、及Symbian一般架构等相关问题。如果您正在开发一个功能全面的音乐服务客户端，您可能也希望熟悉其他一些S60API，如浏览器控件和下载管理。这些内容被分别包含在一些具体的开发伙伴指南中，如，《S60平台：BrowserControlAPI开发伙伴指南》和《S60平台：DownloadManagerAPI开发伙伴指南》。有关S60API方面的更多信息请访问|2007年1月31日S60平台：音乐应用开发伙伴指南|62.音频优先级和播放选择常常有这种情况：某台终端的音频硬件同时收到来自多个应用（客户端）的请求。一个常见的例子就是：当用户正在使用一个多媒体应用时接到了一个电话呼叫。此刻，该终端既可以继续使用那个多媒体应用，也可以停止该应用转而振铃。AudioPriority（音频优先级）和AudioPreference（音频播放选择）就用于应付这类情况。AudioPolicy（音频策略）组件通过分解那些来自不同终端的同时请求实现对终端音频硬件的访问优先级管理。当多个应用同时请求音频播放时，AudioPolicy（音频策略）将决定允许哪一个播放，拒绝哪一个访问音频资源，以及是否要混合两种或多种音源。设计一个应用需要考虑方方面面。产品性能，硬件能力，以及系统资源的可用性等不同需求都将对音频优先级的实现产生影响。AudioPriority的范围从EmdaPriorityMin到EmdaPriorityMax。前者是最低优先级，任何其它客户端都能中断该客户端；而后者则相反，其它客户端无法中断该客户端。EmdaPriorityNormal优先级意味着：该客户端能够被中断，但只能被