2011 年 7 月 – 微风的网络日志

Android用日常事项管理软件 Routine 版本升级 1.1.4

这几天把自己写的Android程序Routine作了一下升级，在这里简单地做一下说明，也算是作为存档。

Routine是一款Android平台的GTD软件，写这个程序的初衷是为了弥补没有很适合自己用的Xperia X10的GTD工具的遗憾。程序的特色就是使用了索尼爱立信的UXP主题，能够和X10家族的机型保持界面风格上的统一。

这次的1.1.4的升级是继1.0.7支持多任务列表之后的一次较大的升级，关于1.0.0初版的信息，请参见当时的发布日志。

在保持了Routine原有特色的同时，这次的升级主要内容有以下几点：

改变了数据的存储方式，由文件存储改为了SQLite的数据库方式。提高了数据操作的性能。
大幅改进了界面，在美化的同时提高了可用性。
为条目提供了更多值域的支持，为将来支持新特性做准备。
支持标签色彩，视觉效果更为一目了然。

今后计划增加的特性暂定有条目的多标签支持、截止日期以及提醒的支持、多种排序方式的支持等。近期来说，在X10的Android 2.3.3系统升级发布之后会有一次UI风格的升级。

目前Routine可以在Android Market的效率类应用程序中找到，搜索Routine、ルーチン或者pub:BREEZE即可。如果需要一款简单好用的GTD工具，不妨试试看Routine吧。

Android Market页面：

http://market.android.com/details?id=org.breezesoft.routine

最后是一些新版Routine的程序截图：

意图和意图过滤器

一个程序的三个核心组件——活动、服务和广播接收者——通过被称为意图（intent）的消息来被激活。意图消息是一种在同一个或不同程序的组件间的运行后绑定机制。意图自身，即一个Intent对象，是包含了对于要执行的操作的抽象描述的被动数据结构——或者，对于广播来说，是对于已发生正在被播报的事件的描述。对于向不同类型的组建传递意图，有不同的机制：

一个Intent对象被传递给Context.startActivity()或Activity.startActivityForResult()以启动一个活动，或是让一个已存在的活动进行新的工作。（它也可以被传递给Activity.setResult()使其向调用了startActivityForResult()的活动返回信息。）
一个Intent对象被传递给Context.startService()以初始化一个服务或向正在运行的服务发出新的指令。同样的，一个意图可以被传递给Context.bindService()以在进行调用的组件和目标服务间建立联系。如果服务不在运行，还可以选择初始化该服务。
被传递给任何广播方法（例如Context.sendBroadcast()、Context.sendOrderedBroadcast()或Context.sendStickyBroadcast()）的Intent对象将被发送给所有相关的广播接收者。很多种类的广播在系统代码中被创建。

在任何一种情况下，Android系统将寻找合适的活动、服务或广播接收者来响应意图，在必要时对它们进行初始化。这些消息系统之间没有交集：广播意图仅被发送给广播接收者，而不会给活动或是服务。一个传递给startActivity()的意图将仅被发送给一个活动，而不会是服务或广播接收者，依此类推。

本文档将首先对Intent对象进行描述。之后介绍Android用以映射意图至组建的规则——它如何了解哪一个组建应当接收意图消息。对于没有显式地命名目标组件的意图，这个过程将包括使用与可能对象关联的意图过滤器（intent filter)来测试Intent对象。

Intent对象

Intent对象是一捆数据。它包含了接受该意图的组件所感兴趣的信息（例如要采取的操作及操作的对象数据）及Android系统所需的信息（例如要处理该意图的组件类别及如何启动目标活动的指令）。原则上，它包含以下内容：

组件名称

应当处理该意图的组件名称。这部分是一个ComponentName对象——一种目标组件的完整类名（例如“com.example.project.app.FreneticActivity”）和组件所在程序的manifest文件中的包名称组（例如“com.example.project”）的组合。组件名称的包部分和manifest中的包名称组不一定要相同。

组件名称是可选的。如果被设定，Intent对象将被发送给指定类的实例。如果没有设定，Android使用Intent对象中的其他信息来选择合适的目标——参见本文档中之后的“意图解决方案”。

组件名称通过setComponent()、setClass()或setClassName()来设定，通过getComponent()来读取。

行为

命名了要被执行的行为的字符串——或者，对于广播的意图来说将要发生并被报告的行为。Intent类定义了很多行为常量，包括：

常量	目标组件	行为
`ACTION_CALL`	活动	初始化一次电话呼叫。
`ACTION_EDIT`	活动	向用户显示数据以供编辑。
`ACTION_MAIN`	活动	作为一个任务（task）的首活动启动，不包含数据输入且没有返回的输出。
`ACTION_SYNC`	活动	以移动设备上的数据同步服务器上的数据。
`ACTION_BATTERY_LOW`	广播接收者	电量低的警告。
`ACTION_HEADSET_PLUG`	广播接收者	耳机插入或是拔出设备。
`ACTION_SCREEN_ON`	广播接收者	屏幕被打开。
`ACTION_TIMEZONE_CHANGED`	广播接收者	时区设定被改变。

参见Intent类的描述以获知通用行为的预定义常量列表。其他的行为在Android API的其他部分被定义。也可以为激活自己的程序中的组件而定义自有的行为字符串。它们应当包含作为前缀的程序包——例如：“com.example.project.SHOW_COLOR”。

行为很大程度上决定了意图剩余部分的结构——特别是数据和额外信息——就好像是一个方法的名称决定了一组参数和返回值。因此，最好尽可能具体地使用行为名称，将它们紧密地和意图的其他部分配对。换言之，不要单独定义一个行为，而是要为组件可以处理的Intent对象定义一整套的协议。

一个Intent对象的行为通过setAction()方法设置，通过getAction()来读取。

数据

将被执行操作的数据的URI及数据的MIME类型。不同的行为和不同的数据规格相对应。例如，如果行为域是ACTION_EDIT，那数据域就需要包含要被显示以编辑的文档的URI。如果行为是ACTION_CALL，那数据域需要是一个要拨打的号码的tel: URI。同样地，如果行为是ACTION_VIEW且数据域是http: URI，那接收方活动将会下载或显示该URI指向的任何数据。

在配对一个意图和一个有能力处理其数据的组件时，知道数据的类型（即它的MIME类型）以及URI是很重要的。例如，一个可以显示图像数据的组建不应被调用来播放音频文件。

在许多情况下，数据类型可以由URI获知——特别是content: URI，它表明数据位于设备中并由一个内容提供者所控制（参见另外的关于内容提供者的解说）。不过也可以在Intent对象内显式地设定类型。setData()方法以仅URI来指定数据，setType()仅以MIME类型来指定数据，setDataAndType()同时以URI和MIME类型来指定数据。URI通过getData()读取，类型由getType()读取。

类别

一个包含了应该由哪一种类型的组件来处理意图的额外信息的字符串。Intent对象中可以存放任何数量的类别描述。和行为一样，Intent类定义了一些类别常量，其中包括：

常量	意义
`CATEGORY_BROWSABLE`	目标活动可以安全地被浏览器用于显示某一链接指向的数据——例如，一幅图像或是一条电子邮件消息。
`CATEGORY_GADGET`	该活动可以被另一个持有小部件（gadget）的活动嵌于内部。
`CATEGORY_HOME`	该活动显示主界面（home screen）这一用户启动设备或按下HOME键后首先看到的画面。
`CATEGORY_LAUNCHER`	该活动是一个任务中的首活动，被列于应用程序启动器的首级。
`CATEGORY_PREFERENCE`	目标活动是一个偏好设置面板。

参见Intent类的描述以获知完整的类别列表。

addCategory()方法将一个类别存入一个Intent对象，removeCategory()则删除之前添加的一个类别，getCategories()用于获取当前在意图对象内的整个类别集。

额外信息

关于需要被传递给要处理意图的组件的其他信息的键值对（key-value pair）。如同一些行为与特定类型的数据URI相配对，另一些会与特定的额外信息相配对。例如，一个ACTION_TIMEZONE_CHANGED意图有一个额外信息“time-zone”来识别新的时区，ACTION_HEADSET_PLUG则有一个额外信息“state”来识别耳机是被插入还是拔出，另外还有额外信息“name”来识别耳机的类型。如果想要设计一个SHOW_COLOR行为，颜色的值将被设置于一个额外的键值对之中。

Intent对象有一系列的put…()方法来插入不同类型的额外数据，类似地有一组get…()方法来读取这些值。这些方法和Bundle对象中的相类似。事实上，额外信息可以如同一个Bundle那样通过putExtras()和getExtras()方法来被设置和读取。

旗标

各种类型的旗标。其中很多指示了Android系统如何去启动一个活动（例如，该活动应该属于哪一个任务）以及在启动后应该如何处理它（例如，它是否应该属于最近活动列表）。所有的这些旗标在Intent类中被定义。

Android系统和该平台的应用程序使用Intent对象来发出系统创建的广播及激活系统定义的组件。要了解如果构建一个意图以激活一个系统组件，参见附录中的意图列表。

意图的解决方案

意图可以被分为两类：

显式意图通过其名称指定目标组件（前面提到过，该组件的名称域有一个值集）。因为组件的名称通常不会被其他程序的开发者知道，显式的意图往往被用于程序内部消息——例如一个活动启动一个附属的服务或是一个平级的活动。
隐式意图不会命名目标（组件的名称域是空白的）。隐式意图常用于激活其他活动中的组件。

Android将一个显式意图传递给所指定的目标类的一个实例。只有Intent对象中的组件名称会影响到意图最终将被传送给哪一个组件。

对于隐式意图需要一种不同的策略。由于没有指定的目标，Android系统必须找到最为合适的那一组件（或那一些组件）——一个单独的执行所请求的行动的活动或服务，或是一组广播接收者来响应广播通告。系统通过比较Intent对象的内容和意图过滤器（和组件相关联的用以接收潜在意图的结构）来实现这一目的。过滤器告知了一个组件的功能并界定了它可以处理的意图。它们使得组件可能接收所告知的类型的隐式意图。如果一个组件没有任何的意图过滤器，它将只能接收显示意图。一个拥有意图过滤器的组件可以同时接收显式和隐式意图。

当一个Intent对象被意图过滤器检查时只有三个方面会被考虑：

行为

数据（同时包括URI和数据类型）

类别

额外信息和旗标不会影响到决定由哪个组件接收意图。

意图过滤器（Intent filter）

为了告知系统它可以处理哪些隐式意图，活动、服务和广播接收者都可以拥有一个或多个意图过滤器。每一个过滤器将描述组件的某一种功能以及该组件要接收的意图集。它有效地过滤下所需的类型，排除不需要的意图——不过仅能排除不需要的（未命名目标类的）隐式意图。显式意图将始终被传递给其目标而无论它包含什么内容；过滤器不会起作用。然而一个隐式意图就只有在通过了组件的过滤器之后才能够被传递给组件。

一个组件对每一类它可以处理的工作及用户所能看见的每一种形式分别有着不同的过滤器。例如，范例中Note Pad程序的NoteEditor活动有两个过滤器——一个用于创建用户可以查看并编辑的特定便筏，另一个用于启动一个空的用户可以输入并保存的新的便筏。（Note Pad的所有的过滤器将会在之后的Note Pad范例一节中详细说明。）

一个意图过滤器是IntentFilter类的一个实例。不过因为Android系统必须在启动一个组件之前知道它所具有的功能，所以意图过滤器一般不在Java代码中使用，而是作为程序的manifest文件中（AndroidManifest.xml）的<intent-filter>元素。（不过有一个例外是广播接收者的过滤器是通过调用Context.registerReceiver()动态地在代码中注册的；它们被作为IntentFilter对象直接创建。）

一个过滤器有着和Intent对象中的行为、数据和类别域相对应的域。一个隐式意图将检测过滤器的所有这三个内容。要被传递给某个组件，一个意图必须通过该组件的过滤器的所有三项检测。即使只有一项不满足，Android系统也不会将该意图传递给组件——至少不会是基于过滤器传递给组件。不过，由于一个组件可以有多个意图过滤器，一个意图如果无法通过其中一个过滤器还是有可能能通过其他的的。

过滤器和安全

意图过滤器不能确保安全性。尽管它只让一个组件接受特定类型的隐式意图，它无法阻止显式意图指向目标组件。即使过滤器约束了意图使其只能使用将会被请求处理特定的行为和数据源的组件，一些人仍然可以将一个显式意图与不同的行为和数据源结合在一起，并将目标以组件的名称来命名。

下面将详细描述三种检测是如何进行的：

行为检测

manifest文件中的一个<intent-filter>元素以<action>子元素的形式列出了行为。例如：

<span style="color: #000080;">&lt;intent-filter<span style="color: #000000;"> . . .</span> &gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"com.example.project.SHOW_CURRENT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"com.example.project.SHOW_RECENT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"com.example.project.SHOW_PENDING"</span> /&gt;</span>
<span style="color: #000000;">    . . .</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter . . . >

. . .

</intent-filter>

如同示例所展示的，一个Intent对象只命名一个单独的行为，而一个过滤器可以列出多个行为。列表不能为空；一个过滤器至少要包含一个<action>元素，否则它将屏蔽所有的意图。

要通过这个检测，在Intent对象中指定的行为必须与过滤器所列出的行为之一相匹配。如果该对象或是过滤器没有指定一个行为，就会有下面的结果：

如果过滤器没有列出任何行为，就没有行为可以与意图相匹配，所有的意图都无法通过检测。没有意图可以通过过滤器。
另一方面，如果Intent对象没有指定任何的行为，它将自动通过检测——只要过滤器含有一个或以上的行为。

类别检测

<intent-filter>也会将类别作为子元素列出。例如：

<span style="color: #000080;">&lt;intent-filter<span style="color: #000000;"> . . .</span> &gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category<span style="color: #800080;"> android:name</span>=<span style="color: #008000;">"android.intent.category.BROWSABLE"</span> /&gt;</span>
<span style="color: #000000;">    . . .</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter . . . >

. . .

</intent-filter>

注意之前描述过的表示行为和类型的常量不在mainfest文件中被使用。而是使用完整的字符串值。例如，在范例中的“android.intent.category.BROWSABLE”字符串和文档之前提到的CATEGORY_BROWSABLE常量相对应。类似地，字符串“android.intent.action.EDIT”和ACTION_EDIT常量相对应。

一个意图要通过类别检测，Intent对象中的每一个类别都必须与过滤器中的某个类别相匹配。过滤器可以列出其他更多的类别，但不能省略任何一个意图中含有的类别。

原则上，所以说，一个不含有类别的Intent对象，无论过滤器中有哪些类别，总是能够通过这项检测。这通常是正确的。不过，有一个例外，Android把所有传递给startActivity()的隐式意图视为它们包含了至少这样一个类别：“android.intent.category.DEFAULT”（CATEGORY_DEFAULT常量）。因此，要接受隐式意图的活动必须在其意图过滤器中包含有“android.intent.category.DEFAULT”。（设有“android.intent.action.MAIN”和“android.intent.category.LAUNCHER”的过滤器不在此范围之中。它们将活动标记为了新任务的开始，并显示在应用启动器（launcher）屏幕上。它们可以在类别列表中包含“android.intent.category.DEFAULT”，不过这并不是必须的。）参见之后的“使用意图匹配”来进一步了解这些过滤器。

数据检测

如同行为和类别，意图过滤器的的数据类型也是作为子元素保存的。而且和它们一样，这些子元素可以出现多次或完全不出现。例如：

<span style="color: #000080;">&lt;intent-filter . . . &gt;</span>
<span style="color: #000080;">    &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"video/mpeg"</span> <span style="color: #800080;">android:scheme</span>=<span style="color: #008000;">"http"</span> . . . /&gt; </span>
<span style="color: #000080;">    &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"audio/mpeg"</span> <span style="color: #800080;">android:scheme</span>=<span style="color: #008000;">"http"</span> . . . /&gt;</span>
<span style="color: #000080;">    . . .</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter . . . >

. . .

</intent-filter>

每一个<data>元素可以指定一个URI和数据类型（MINE媒体类型）。URI的每一个部分由不同的属性——模式（scheme）、主机（host）、接口（port）和路径（path）。

scheme://host:port/path

例如，下面的URI，

content://com.example.project:200/folder/subfolder/etc

其模式是“content”，主机是“com.example.project”，接口是“200”，路径是“folder/subfolder/etc”。主机和接口共同构成了URI的授权；如果没有指定主机，那么接口将被忽略。

每一个属性都是可选的，但并非与其他属性相互独立：要让一个授权变得有意义，必须指定一个模式。要让路径具有意义，必须指定一个模式和一个授权。

当一个Intent对象中的URI和过滤器中的URI相比较时，仅比较过滤器中所包含的URI部分。例如，如果一个过滤器仅指定了一个模式，那所有具有这个模式的URI就与过滤器相匹配。如果过滤器指定了一个模式及一个授权但是没有指定路径，那么无论是什么路径，具有相同模式和授权的URI将得到匹配。如果过滤器指定了模式、授权和路径，那就只有具有相同模式、授权和路径的URI得到匹配。不过，过滤器中指定的路径可以包含通配符以仅仅限定部分路径。

一个<data>元素的类型（type）属性指定了数据的MINE类型。在过滤器中这比URI更为常见。Intent对象和过滤器都可以用”*”通配符作为子类别域来标识子类别匹配，例如“text/*”或“audio/*”。

数据检测同时将Intent对象中的URI和数据类型与过滤器中的URI和数据类型相比较。该过程遵循以下规则：

不包含URI和数据类型的Intent对象只有在过滤器也不指定任何URI及数据类型时才能通过检测。
包含URI但不包含数据类型（且数据类型不能通过URI推断出来）的Intent对象只有在其URI与过滤器中的URI相匹配且过滤器同样没有指定类型时才能通过检测。这是仅仅在类似mailto:和tel:这样没有指向实际数据的URI时才会出现的情况。
包含数据类型但不包含URI的Intent对象只有在过滤器列出了相同的数据类型而没有指定URI时才能通过检测。
同时包含有URI和数据类型（或URI可以推导出数据类型）的Intent对象在其数据类型与过滤器中列出的类型相匹配时通过检测的数据类型部分。当其URI与过滤器中的URI相匹配，或，其具有一个content:或file:URI并且过滤器没有指定URI时，通过测试的URI部分。换言之，如果过滤器仅列出了数据类型，一个组件将被假定支持content:和file:数据。

如果一个意图可以通过不止一个活动或服务的过滤器，用户将被询问要激活哪一个组件。如果没有一个目标能被找到，则会抛出一个例外。

常见情况

上面数据检测中的最后一条规则，说明了组件可以从一个文件或是内容提供者处获取本地数据。因此，它们的过滤器可以仅仅列出数据类型而不需要显式地命名content:和file:模式。这是一种典型的情况。比如说，一个如下的<data>元素，告诉Android组件可以从内容提供者处获取图像数据并显示：

<span style="color: #000080;">&lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"image/*"</span> /&gt;</span>

1	<span style="color: #000080;"><data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"image/*"</span> /></span>

因为大部分可用的数据由数据提供者分发，所以指定了数据类型而没有指定URI的过滤器也许是最为常见的了。

另一种常见的情况是过滤器指定了模式和数据类型。例如，如下的一个<data>元素告诉Android组件可以从网络获取视频数据并播放：

<span style="color: #000080;">&lt;data</span> <span style="color: #800080;">android:scheme</span>=<span style="color: #008000;">"http"</span> <span style="color: #800080;">android:type</span>=<span style="color: #008000;">"video/*"</span> <span style="color: #000080;">/&gt;</span>

1	<span style="color: #000080;"><data</span> <span style="color: #800080;">android:scheme</span>=<span style="color: #008000;">"http"</span> <span style="color: #800080;">android:type</span>=<span style="color: #008000;">"video/*"</span> <span style="color: #000080;">/></span>

试想，例如，浏览器类应用在用户打开网页上的一个链接后将做什么。它首先尝试显示数据（如果该链接是一个HTML页面的话）。如果它无法显示数据，它将生成一个包含模式和数据类型的隐式意图并试图启动一个可以处理该工作的活动。如果没有合适的活动，它将请求下载管理器下载该数据。这处于内容提供者的控制之下，所以有大量的可能合适的活动（它们的过滤器仅指定了数据类型）将能够做出响应。

大部分程序还有一种不需要任何指定数据引用的开始刷新的方法。能够初始化一个程序的活动有着将行为指定为”android.intent.action.MAIN”的过滤器。如果它们需要被显示在应用程序启动器中的话，它们还需要被指定为”android.intent.category.LAUNCHER”类别：

<span style="color: #000080;">&lt;intent-filter . . . &gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"code android.intent.action.MAIN"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"code android.intent.category.LAUNCHER"</span> /&gt;</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter . . . >

</intent-filter>

使用意图匹配

将意图与意图过滤器相匹配不仅仅是为了寻找要激活的某一目标组件，同时也是要获取设备上的某一组组件的某些属性。例如，Android系统通过查找所有具有指定了“android.intent.action.MAIN”行为和“android.intent.category.LAUNCHER”类别的过滤器的活动（如前一节所示）来弹出应用程序启动器这一列出了所有可供用户启动的程序的顶层屏幕内容。之后它在启动器中显示那些活动的图标（icon）和标签（label）。同样地，它通过查找具有“android.intent.category.HOME”类别的过滤器的活动来显示主界面。

程序可以以一种类似的方式来使用意图匹配。PackageManager拥有一组query…()方法来返回所有可以接受某一特定意图的组件，以及一系列的resolve…()方法来决定响应意图最合适的组件。例如，queryIntentActivities()将返回一个列出了所有可以将意图作为参数传递的活动的列表，queryIntentServices()将返回一个类似作用的所有服务的列表。这两种方法都不会激活组件；它们只是列出了那些可以做出响应的。对于广播接收者，还有一个类似的queryBroadcastReceivers()方法。

记事本（Note Pad）范例

记事本范例允许用户浏览笔记列表、查看列表中项目的详细内容、编辑项目、向列表增加新项目。本节将分析在其manifest文件中声明的意图过滤器（如果正在离线使用SDK，可以在<sdk>/samples/NotePad/index.html下找到包括manifest文件在内的该范例程序的所有源文件。如果是在在线查看文档，源文件则是在这里的“教程和范例代码”一节。

在manifest文件中，记事本程序声明了三个活动，每一个都有至少一个意图过滤器。它还声明了一个内容提供者用以管理笔记数据。以下是整个manifest文件的内容：

<span style="color: #000080;">&lt;manifest <span style="color: #800080;">xmlns:android</span>=<span style="color: #008000;">"http://schemas.android.com/apk/res/android"</span></span>
<span style="color: #000080;"><span style="color: #800080;">          package</span>=<span style="color: #008000;">"com.example.android.notepad"</span>&gt;</span>
<span style="color: #000080;">    &lt;application <span style="color: #800080;">android:icon</span>=<span style="color: #008000;">"@drawable/app_notes"</span></span>
<span style="color: #000080;"><span style="color: #800080;">                 android:label</span>=<span style="color: #008000;">"@string/app_name"</span> &gt;</span>

<span style="color: #000080;">        &lt;provider <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"NotePadProvider"</span></span>
<span style="color: #000080;"><span style="color: #800080;">                  android:authorities</span>=<span style="color: #008000;">"com.google.provider.NotePad"</span> /&gt;</span>

<span style="color: #000080;">        &lt;activity <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"NotesList"</span> android:label=<span style="color: #008000;">"@string/title_notes_list"</span>&gt;</span>
<span style="color: #000080;">            &lt;intent-filter&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.MAIN"</span> /&gt;</span>
<span style="color: #000080;">                &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.LAUNCHER"</span> /&gt;</span>
<span style="color: #000080;">            &lt;/intent-filter&gt;</span>
<span style="color: #000080;">            &lt;intent-filter&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.VIEW"</span> /&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.EDIT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.PICK"</span> /&gt;</span>
<span style="color: #000080;">                &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.dir/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">            &lt;/intent-filter&gt;</span>
<span style="color: #000080;">            &lt;intent-filter&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.GET_CONTENT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.item/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">            &lt;/intent-filter&gt;</span>
<span style="color: #000080;">        &lt;/activity&gt;</span>

<span style="color: #000080;">        &lt;activity <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"NoteEditor"</span></span>
<span style="color: #000080;"><span style="color: #800080;">                  android:theme</span>=<span style="color: #008000;">"@android:style/Theme.Light"</span></span>
<span style="color: #000080;"><span style="color: #800080;">                  android:label</span>=<span style="color: #008000;">"@string/title_note"</span> &gt;</span>
<span style="color: #000080;">            &lt;intent-filter <span style="color: #800080;">android:label</span>=<span style="color: #008000;">"@string/resolve_edit"</span>&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.VIEW"</span> /&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.EDIT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"com.android.notepad.action.EDIT_NOTE"</span> /&gt;</span>
<span style="color: #000080;">                &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.item/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">            &lt;/intent-filter&gt;</span>
<span style="color: #000080;">            &lt;intent-filter&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.INSERT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.dir/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">            &lt;/intent-filter&gt;</span>
<span style="color: #000080;">        &lt;/activity&gt;</span>

<span style="color: #000080;">        &lt;activity <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"TitleEditor" </span></span>
<span style="color: #000080;"><span style="color: #800080;">                  android:label</span>=<span style="color: #008000;">"@string/title_edit_title"</span></span>
<span style="color: #000080;"><span style="color: #800080;">                  android:theme</span>=<span style="color: #008000;">"@android:style/Theme.Dialog"</span>&gt;</span>
<span style="color: #000080;">            &lt;intent-filter <span style="color: #800080;">android:label</span>=<span style="color: #008000;">"@string/resolve_title"</span>&gt;</span>
<span style="color: #000080;">                &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"com.android.notepad.action.EDIT_TITLE"</span> /&gt;</span>
<span style="color: #000080;">                &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">                &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.ALTERNATIVE"</span> /&gt;</span>
<span style="color: #000080;">                &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.SELECTED_ALTERNATIVE"</span> /&gt;</span>
<span style="color: #000080;">                &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.item/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">            &lt;/intent-filter&gt;</span>
<span style="color: #000080;">        &lt;/activity&gt;</span>

<span style="color: #000080;">    &lt;/application&gt;</span>
<span style="color: #000080;">&lt;/manifest&gt;</span>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

package="com.example.android.notepad">

<application android:icon="@drawable/app_notes"

android:label="@string/app_name" >

<provider android:name="NotePadProvider"

android:authorities="com.google.provider.NotePad" />

<intent-filter>

</intent-filter>

<intent-filter>

</intent-filter>

<intent-filter>

</intent-filter>

</activity>

<activity android:name="NoteEditor"

android:theme="@android:style/Theme.Light"

android:label="@string/title_note" >

<intent-filter android:label="@string/resolve_edit">

</intent-filter>

<intent-filter>

</intent-filter>

</activity>

<activity android:name="TitleEditor"

android:label="@string/title_edit_title"

android:theme="@android:style/Theme.Dialog">

<intent-filter android:label="@string/resolve_title">

</intent-filter>

</activity>

</application>

</manifest>

第一个活动，NoteList，和其他的活动不同，它要对一系列的笔记（笔记列表）进行操作而不是某条单独的笔记。它通常将作为用户进入程序的初始界面。如其三个意图过滤器所描述的，它能执行三项工作：

<span style="color: #000080;">&lt;intent-filter&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.MAIN"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.LAUNCHER"</span> /&gt;</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter>

</intent-filter>

该过滤器声明了Note Pad程序的主入口。标准MAIN行为是一种不需要Intent中的其他信息（比如不需要数据类型）的入口（entry point），LAUNCHER类别则说明该入口应该被列于应用程序启动器中。

<span style="color: #000080;">&lt;intent-filter&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.VIEW"</span> /&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.EDIT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.PICK"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.dir/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter>

</intent-filter>

该过滤器声明了这个活动可以对一列笔记进行何种操作。它可以允许用户查看或编辑笔记（通过VIEW和EDIT行为），或是从列表中选取一条特定笔记（通过PICK行为）。

<data>元素的mimeType属性指定了这些行为要执行操作的数据类型。它表明了这个活动可以从一个持有Note Pad数据的内容提供器（vnd.google.note）中获取一个指向零个或更多个项目（vnd.android.cursor.dir）的Cursor。启动该活动的Intent对象包含一个content: URI用以指定活动应该打开的确切数据类型。

也请注意该过滤器中提供的DEFAULT类别，因为Context.startActivity()和Activity.startActivityForResult()方法在意图包含DEFAULT类别时将会对其进行处理——只有两种例外：

显式地命名了目标活动的Intent
包含了MAIN行为和LAUNCHER类别的Intent

因此，所有的过滤器都需要DEFAULT类别——除非有MAIN行为和LAUNCHER类别。（意图过滤器不过滤显式意图）

<span style="color: #000080;">&lt;intent-filter&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.GET_CONTENT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.item/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter>

</intent-filter>

该过滤器说明了这个活动可以返回一条用户选中的笔记而不需要这条笔记所在的列表的相关信息。GET_CONTENT行为类似于PICK行为。两种情况下活动都将返回用户所选择的笔记的URI。（将返回给调用了startActivityForResult()来启动NoteList活动的那个活动。）不过现在，调用者指定了所需的数据类型而不是用户要进行选择的数据列表的类型。

数据类型，vnd.android.cursor.item/vnd.google.note，标明了该活动可以返回的数据的类型——一条单笔记的URI。通过所返回的URI，调用者可以从持有Note Pad数据（vnd.google.note）的内容提供其中获取某一特定条目（vnd.android.cursor.item）的Cursor。

也就是说，前一个过滤器中的PICK行为，数据类型标识出了活动可以显示给用户的数据的类型。而GET_CONTENT过滤器则标识出了活动可以返回给它的调用者的数据的类型。

有了这些能力，下面的意图可以实现活动NotesList的功能：

行为：android.intent.action.MAIN

不需要特定的数据就能启动活动

行为：android.intent.action.MAIN

类别：android.intent.category.LAUNCHER

不需要特定的被选择的数据就能启动活动。这是实际上应用程序启动器用来填充其最高层列表（top-level list）的意图。所有具有匹配该行为和类别的过滤器的活动将被添加至列表。

行为：android.intent.action.VIEW

数据：content://com.google.provider.NotePad/notes

请求活动显示在content://com.google.provider.NotePad/notes下的所有笔记的列表。之后用户可以浏览该列表并获取列表中项目的信息。

行为：android.intent.action.PICK

数据：content://com.google.provider.NotePad/notes

请求活动显示在content://com.google.provider.NotePad/notes下的笔记的列表。之后用户可以从列表中选取一条笔记，活动将返回该条目的URI给启动了NoteList活动的那个活动。

行为：android.intent.action.GET_CONTENT

数据类型：vnd.android.cursor.item/vnd.google.note

请求活动提供一条单独的Note Pad数据。

第二个活动，NoteEditor，向用户显示一条单独的笔记条目并允许对其进行编辑。根据其两个意图过滤器的描述，它可以进行两项任务：

<span style="color: #000080;">&lt;intent-filter <span style="color: #800080;">android:label</span>=<span style="color: #008000;">"@string/resolve_edit"</span>&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.VIEW</span>" /&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.EDIT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"com.android.notepad.action.EDIT_NOTE"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.item/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter android:label="@string/resolve_edit">

</intent-filter>

这个活动的第一个，也是主要的目的是使用户与一条笔记交互，VIEW这条笔记或是EDIT它。（类别EDIT_NOTE与EDIT的意义相同。）该意图将包含匹配MIME类型vnd.android.cursor.item/vnd.google.note的数据的URI——也就是说，这条指定的笔记的URI。它通常是被NoteList活动的PICK或GET_CONTENT行为所返回的URI。

和之前一样，该过滤器列出了DEFAULT类别因此这个活动可以被其他没有显式地指定NoteEditor类的意图启动。

<span style="color: #000080;">&lt;intent-filter&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.action.INSERT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.dir/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter>

</intent-filter>

这个活动的第二个目的是使用户创建一条新的笔记并INSERT至现有的笔记列表中。该意图包含了匹配MIME类型vnd.android.cursor.dir/vnd.google.note的数据的URI——即笔记将被插入的笔记列表的URI。

有了这些能力，下面的意图可以实现NoteEditor活动的功能：

行为：android.intent.action.VIEW

数据：content://com.google.provider.NotePad/notes/ID

请求活动显示由ID确定的笔记的内容。（关于content: URIs是如何指定一个群组内的个别成员的，请参见“内容提供器”。）

行为：android.intent.action.EDIT

数据：content://com.google.provider.NotePad/notes/ID

请求活动显示由ID确定的笔记的内容，并允许用户对其进行编辑。如果用户保存了修改，该活动将更新内容提供器中的笔记数据。

行为：android.intent.action.INSERT

数据：content://com.google.provider.NotePad/notes

请求活动在content://com.google.provider.NotePad/note的笔记列表中创建一个新的空笔记并允许用户对其进行编辑。如果用户保存了笔记，其URI将被返回给调用者。

最后一个活动，TitleEditor，允许用户编辑笔记的标题。这可以通过直接调用该活动来实现（通过显式地在Intent中设定该组件名称），而不需要通过一个意图过滤器。不过这里主要关注如何对现存的数据进行其他操作：

<span style="color: #000080;">&lt;intent-filter <span style="color: #800080;">android:label</span>=<span style="color: #008000;">"@string/resolve_title"</span>&gt;</span>
<span style="color: #000080;">    &lt;action <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"com.android.notepad.action.EDIT_TITLE"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.DEFAULT"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.ALTERNATIVE"</span> /&gt;</span>
<span style="color: #000080;">    &lt;category <span style="color: #800080;">android:name</span>=<span style="color: #008000;">"android.intent.category.SELECTED_ALTERNATIVE"</span> /&gt;</span>
<span style="color: #000080;">    &lt;data <span style="color: #800080;">android:mimeType</span>=<span style="color: #008000;">"vnd.android.cursor.item/vnd.google.note"</span> /&gt;</span>
<span style="color: #000080;">&lt;/intent-filter&gt;</span>

<intent-filter android:label="@string/resolve_title">

</intent-filter>

这个活动的唯一的意图过滤器使用了一个名为”com.android.notepad.action.EDIT_TITLE“的自定义行为。它必须像之前的VIEW和EDIT行为一样通过一条指定的笔记调用（数据类型vnd.android.cursor.item/vnd.google.note）。不过，这个活动将显示包含于笔记数据中的标题，而不是笔记内容自身。

另外为了支持常见的DEFAULT类别，这个标题编辑器也支持其他两种常见类别：ALTERNATIVE和SELECTED_ALTERNATIVE。这两个类别表明了活动可以在一个选项菜单中显示给用户（就好象LAUNCHER类别表明了活动应当在应用程序启动器中显示给用户一样）。注意过滤器也支持一个显式标签（通过android:label=”@string/resolve_title”）以更好地控制用户能够看到当前被这个活动以其他行为方式查看的数据的哪些内容。（关于这些类别和创建选项菜单的更多信息，请参见PackageManager.queryIntentActivityOptions()和Menu.addIntentOptions()方法。）

有了这些能力，下面的意图就可以实现TitleEditor活动的功能：

行为：com.android.notepad.action.EDIT_TITLE

数据：content://com.google.provider.NotePad/notes/ID

请求活动显示和笔记ID相关联的标题，并允许用户对其进行编辑。

本页部分内容根据Android Open Source Project创作并共享的内容修改，并在知识共享署名2.5许可协议中所述条款的限制下使用。

媒体

Android平台为多种常见媒体类型提供了内建的编码/解码支持，因而可以简单地向程序整合音频、视频和图像。要使用平台的媒体功能非常简单——同样只需使用意图-活动的机制，之后Android会处理其余的工作。

Android可以从多种数据源类型中播放音频和视频。可以播放存储在程序资源（原始资源 raw resource）中的音频或视频媒体文件，可以播放文件系统中的某一文件，可以播放经由网络的流数据。要让程序播放视频或音频，需使用MediaPlayer类。

如果移动设备硬件支持的话，平台也支持录制音频和视频。要录制音频或视频，需使用MediaRecorder类。注意，模拟器没有获取音频或视频的硬件，不过实际的移动设备通常会提供这些支持，可以通过MediaRecorder类使用。

要了解Android提供内建支持的媒体格式列表，参见附录“Android媒体格式”。

音频和视频播放

可以播放任意来源的媒体：原始资源、系统中的文件或是可用的网络（URL）。

仅可以通过标准输出设备播放音频数据；目前来说，就是至移动设备的扬声器或是蓝牙耳机。现在不能在通话音频中播放声音文件。

播放原始资源

最为常见的需求或许就是从自有程序中播放媒体（一般是声音）了吧。这很容易做到：

将声音（或其他媒体资源）文件放入工程的res/raw文件夹，Eclipse插件（或aapt）将会发现它并将其识别为R类可以引用的资源。
创建一个MediaPlayer的实例，用MediaPlayer.create引用该资源，之后调用实例的start()方法：

 <span style="color: #000000;"><span style="color: #800080;"> MediaPlayer</span> mp = <span style="color: #800080;">MediaPlayer</span>.create(context, R.raw.sound_file_1);</span>
<span style="color: #000000;">    mp.start();</span>

1 2	<span style="color: #000000;"><span style="color: #800080;"> MediaPlayer</span> mp = <span style="color: #800080;">MediaPlayer</span>.create(context, R.raw.sound_file_1);</span> <span style="color: #000000;"> mp.start();</span>

要停止播放，调用stop()。如果希望之后重放该媒体，就必须在再次调用start()之前reset()及prepare()该MediaPlayer对象。（create()在第一次使用时会调用prepare()。）

要暂停播放，调用pause()。在想要继续播放的时候调用start()。

播放文件或流

可以播放储存于文件系统中或位于网络URL的媒体文件：

使用new来创建一个新的MediaPlayer实例
以一个包含了要播放的文件的路径（文件地址或是URL）的字符串调用setDataSource()
首先prepare()之后start()该实例：

   <span style="color: #800080;">MediaPlayer</span> <span style="color: #000000;">mp =</span> <span style="color: #000080;">new</span> <span style="color: #800080;">MediaPlayer</span><span style="color: #000000;">();</span>
   <span style="color: #000000;">mp.setDataSource(PATH_TO_FILE);</span>
<span style="color: #000000;">    mp.prepare();</span>
<span style="color: #000000;">    mp.start();</span>

MediaPlayer mp = new MediaPlayer();

mp.setDataSource(PATH_TO_FILE);

mp.prepare();

mp.start();

stop()和pause()的工作方式同上。

注意：当引用的文件不存在时，IllegalArgumentException 和IOException 可能会在使用setDataSource()时被接收或传递。

注意：如果传递的是在线媒体文件的URL，该文件必须可以被逐步下载。

播放JET内容

Android平台包含了一个JET引擎，它允许在程序中添加与JET音频内容的播放控制交互。可以使用SDK附带的JetCreator授权程序创建JET内容的播放控制交互。要在程序中播放并管理JET内容，需要使用JetPlayer类。

关于JET理念的描述及使用JetCreator授权工具的使用说明，参见“JetCreator用户手册”。该工具在OS X和Windows平台下全功能可用，在Linux下所有的内容创建功能也都被支持，只是输入内容审查功能不被支持。

这里有一个如何从一个储存于SD卡的.jet文件中建立JET播放的例子：

<span style="color: #000000;"><span style="color: #800080;">JetPlayer</span> myJet = <span style="color: #800080;">JetPlayer</span>.getJetPlayer();</span>
<span style="color: #000000;">myJet.loadJetFile(<span style="color: #008000;">"/sdcard/level1.jet"</span>);</span>
<span style="color: #000000;"><span style="color: #000080;">byte</span> segmentId = 0;</span>

<span style="color: #993300;">// queue segment 5, repeat once, use General MIDI, transpose by -1 octave</span>
<span style="color: #000000;">myJet.queueJetSegment(<span style="color: #008080;">5</span>, -<span style="color: #008080;">1</span>, <span style="color: #008080;">1</span>, -<span style="color: #008080;">1</span>, <span style="color: #008080;">0</span>, segmentId++);</span>
<span style="color: #993300;">// queue segment 2</span>
<span style="color: #000000;">myJet.queueJetSegment(<span style="color: #008080;">2</span>, -<span style="color: #008080;">1</span>, <span style="color: #008080;">0</span>, <span style="color: #008080;">0</span>, <span style="color: #008080;">0</span>, segmentId++);</span>

<span style="color: #000000;">myJet.play();</span>

JetPlayer myJet = JetPlayer.getJetPlayer();

myJet.loadJetFile("/sdcard/level1.jet");

byte segmentId = 0;

// queue segment 5, repeat once, use General MIDI, transpose by -1 octave

myJet.queueJetSegment(5, -1, 1, -1, 0, segmentId++);

// queue segment 2

myJet.queueJetSegment(2, -1, 0, 0, 0, segmentId++);

myJet.play();

SDK包含了一个程序范例——JetBoy——演示了如何使用JetPlayer创建游戏中的音乐音轨播放交互。它同时也展示了如何使用JET事件来同步音乐播放和游戏逻辑。该程序位于<sdk>/platforms/android-1.5/samples/JetBoy。

音频录制

通过设备录制音频要比播放音频/视频稍微复杂一些，不过其实也是相当简单：

使用new来创建android.media.MediaRecorder的一个新的实例
使用MediaRecorder.setAudioSource()来设置音频源。通常会使用MediaRecorder.AudioSource.MIC
使用MediaRecorder.setOutputFormat()来设置输出文件格式
使用MediaRecorder.setOutputFile()来设置输出文件名
使用MediaRecorder.setAudioEncoder()来设置音频编码
对MediaRecorder实例调用MediaRecorder.prepare()
调用MediaRecorder.start()以开始音频录制
调用MediaRecorder.stop()以结束音频录制
当不再需要MediaRecorder实例时，对其调用MediaRecorder.release()。建议调用MediaRecorder.release()来立即释放资源

范例：录制音频并播放录制的音频

下面的这个范例类演示了如何建立、开始及终止音频录制，之后播放录制的音频文件。

<span style="color: #993300;">/*</span>
<span style="color: #993300;"> * The application needs to have the permission to write to external storage</span>
<span style="color: #993300;"> * if the output file is written to the external storage, and also the</span>
<span style="color: #993300;"> * permission to record audio. These permissions must be set in the</span>
<span style="color: #993300;"> * application's AndroidManifest.xml file, with something like:</span>
<span style="color: #993300;"> *</span>
<span style="color: #993300;"> * &lt;uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /&gt;</span>
<span style="color: #993300;"> * &lt;uses-permission android:name="android.permission.RECORD_AUDIO" /&gt;</span>
<span style="color: #993300;"> *</span>
<span style="color: #993300;"> */</span>
<span style="color: #000000;"><span style="color: #000080;">package</span> com.android.audiorecordtest;</span>

<span style="color: #000000;"><span style="color: #000080;">import</span> android.app.<span style="color: #800080;">Activity</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.widget.<span style="color: #800080;">LinearLayout</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.os.<span style="color: #800080;">Bundle</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.os.<span style="color: #800080;">Environment</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.view.<span style="color: #800080;">ViewGroup</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.widget.<span style="color: #800080;">Button</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.view.<span style="color: #800080;">View</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.view.View.<span style="color: #800080;">OnClickListener</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.content.<span style="color: #800080;">Context</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.util.<span style="color: #800080;">Log</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.media.<span style="color: #800080;">MediaRecorder</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">import</span> android.media.<span style="color: #800080;">MediaPlayer</span>;</span>

<span style="color: #000000;"><span style="color: #000080;">import</span> java.io.<span style="color: #800080;">IOException</span>;</span>

<span style="color: #000000;"><span style="color: #000080;">public</span> <span style="color: #000080;">class</span> <span style="color: #800080;">AudioRecordTest</span> <span style="color: #000080;">extends</span> <span style="color: #800080;">Activity</span></span>
<span style="color: #000000;">{</span>
<span style="color: #000000;"><span style="color: #000080;">    private static</span> <span style="color: #000080;">final</span> <span style="color: #800080;">String</span> LOG_TAG = "AudioRecordTest";</span>
<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #000080;">static</span> <span style="color: #800080;">String</span> mFileName = <span style="color: #000080;">null</span>;</span>

<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #800080;">RecordButton</span> mRecordButton = <span style="color: #000080;">null</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #800080;">MediaRecorder</span> mRecorder = <span style="color: #000080;">null</span>;</span>

<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #800080;">PlayButton  </span> mPlayButton = <span style="color: #000080;">null</span>;</span>
<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #800080;">MediaPlayer  </span> mPlayer = <span style="color: #000080;">null</span>;</span>

<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #000080;">void</span> onRecord(<span style="color: #000080;">boolean</span> start) {</span>
<span style="color: #000000;"><span style="color: #000080;">        if</span> (start) {</span>
<span style="color: #000000;">            startRecording();</span>
<span style="color: #000000;">        } <span style="color: #000080;">else</span> {</span>
<span style="color: #000000;">            stopRecording();</span>
<span style="color: #000000;">        }</span>
<span style="color: #000000;">    }</span>

<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #000080;">void</span> onPlay(<span style="color: #000080;">boolean</span> start) {</span>
<span style="color: #000000;"><span style="color: #000080;">        if</span> (start) {</span>
<span style="color: #000000;">            startPlaying();</span>
<span style="color: #000000;">        } <span style="color: #000080;">else</span> {</span>
<span style="color: #000000;">            stopPlaying();</span>
<span style="color: #000000;">        }</span>
<span style="color: #000000;">    }</span>

<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #000080;">void</span> startPlaying() {</span>
<span style="color: #000000;">        mPlayer = <span style="color: #000080;">new</span> <span style="color: #800080;">MediaPlayer</span>();</span>
<span style="color: #000000;"><span style="color: #000080;">        try</span> {</span>
<span style="color: #000000;">            mPlayer.setDataSource(mFileName);</span>
<span style="color: #000000;">            mPlayer.prepare();</span>
<span style="color: #000000;">            mPlayer.start();</span>
<span style="color: #000000;">        } <span style="color: #000080;">catch</span> (<span style="color: #800080;">IOException</span> e) {</span>
<span style="color: #000000;"><span style="color: #800080;">            Log</span>.e(LOG_TAG, <span style="color: #008000;">"prepare() failed"</span>);</span>
<span style="color: #000000;">        }</span>
<span style="color: #000000;">    }</span>

<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #000080;">void</span> stopPlaying() {</span>
<span style="color: #000000;">        mPlayer.release();</span>
<span style="color: #000000;">        mPlayer = <span style="color: #000080;">null</span>;</span>
<span style="color: #000000;">    }</span>

<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #000080;">void</span> startRecording() {</span>
<span style="color: #000000;">        mRecorder = <span style="color: #000080;">new</span> <span style="color: #800080;">MediaRecorder</span>();</span>
<span style="color: #000000;">        mRecorder.setAudioSource(<span style="color: #800080;">MediaRecorder.AudioSource</span>.MIC);</span>
<span style="color: #000000;">        mRecorder.setOutputFormat(<span style="color: #800080;">MediaRecorder.OutputFormat</span>.THREE_GPP);</span>
<span style="color: #000000;">        mRecorder.setOutputFile(mFileName);</span>
<span style="color: #000000;">        mRecorder.setAudioEncoder(<span style="color: #800080;">MediaRecorder.AudioEncoder</span>.AMR_NB);</span>

<span style="color: #000000;"><span style="color: #000080;">        try</span> {</span>
<span style="color: #000000;">            mRecorder.prepare();</span>
<span style="color: #000000;">        } <span style="color: #000080;">catch</span> (<span style="color: #800080;">IOException</span> e) {</span>
<span style="color: #000000;"><span style="color: #800080;">            Log</span>.e(LOG_TAG, <span style="color: #008000;">"prepare() failed"</span>);</span>
<span style="color: #000000;">        }</span>

<span style="color: #000000;">        mRecorder.start();</span>
<span style="color: #000000;">    }</span>

<span style="color: #000000;"><span style="color: #000080;">    private</span> <span style="color: #000080;">void</span> stopRecording() {</span>
<span style="color: #000000;">        mRecorder.stop();</span>
<span style="color: #000000;">        mRecorder.release();</span>
<span style="color: #000000;">        mRecorder = <span style="color: #000080;">null</span>;</span>
<span style="color: #000000;">    }</span>

<span style="color: #000000;"><span style="color: #000080;">    class</span> <span style="color: #800080;">RecordButton</span> <span style="color: #000080;">extends</span> <span style="color: #800080;">Button</span> {</span>
<span style="color: #000000;"><span style="color: #000080;">        boolean</span> mStartRecording = <span style="color: #000080;">true</span>;</span>

<span style="color: #000000;"><span style="color: #800080;">        OnClickListener</span> clicker = <span style="color: #000080;">new</span> <span style="color: #800080;">OnClickListener</span>() {</span>
<span style="color: #000000;"><span style="color: #000080;">            public</span> <span style="color: #000080;">void</span> onClick(<span style="color: #800080;">View</span> v) {</span>
<span style="color: #000000;">                onRecord(mStartRecording);</span>
<span style="color: #000000;"><span style="color: #000080;">                if</span> (mStartRecording) {</span>
<span style="color: #000000;">                    setText("Stop recording");</span>
<span style="color: #000000;">                } <span style="color: #000080;">else</span> {</span>
<span style="color: #000000;">                    setText("Start recording");</span>
<span style="color: #000000;">                }</span>
<span style="color: #000000;">                mStartRecording = !mStartRecording;</span>
<span style="color: #000000;">            }</span>
<span style="color: #000000;">        };</span>

<span style="color: #000000;"><span style="color: #000080;">        public</span> <span style="color: #800080;">RecordButton</span>(<span style="color: #800080;">Context</span> ctx) {</span>
<span style="color: #000000;"><span style="color: #000080;">            super</span>(ctx);</span>
<span style="color: #000000;">            setText(<span style="color: #008000;">"Start recording"</span>);</span>
<span style="color: #000000;">            setOnClickListener(clicker);</span>
<span style="color: #000000;">        }</span>
<span style="color: #000000;">    }</span>

<span style="color: #000000;"><span style="color: #000080;">    class</span> <span style="color: #800080;">PlayButton</span> <span style="color: #000080;">extends</span> <span style="color: #800080;">Button</span> {</span>
<span style="color: #000000;"><span style="color: #000080;">        boolean</span> mStartPlaying = <span style="color: #000080;">true</span>;</span>

<span style="color: #000000;"><span style="color: #800080;">        OnClickListener</span> clicker = <span style="color: #000080;">new</span> <span style="color: #800080;">OnClickListener</span>() {</span>
<span style="color: #000000;"><span style="color: #000080;">            public</span> <span style="color: #000080;">void</span> onClick(<span style="color: #800080;">View</span> v) {</span>
<span style="color: #000000;">                onPlay(mStartPlaying);</span>
<span style="color: #000000;"><span style="color: #000080;">                if</span> (mStartPlaying) {</span>
<span style="color: #000000;">                    setText(<span style="color: #008000;">"Stop playing"</span>);</span>
<span style="color: #000000;">                } <span style="color: #000080;">else</span> {</span>
<span style="color: #000000;">                    setText(<span style="color: #008000;">"Start playing"</span>);</span>
<span style="color: #000000;">                }</span>
<span style="color: #000000;">                mStartPlaying = !mStartPlaying;</span>
<span style="color: #000000;">            }</span>
<span style="color: #000000;">        };</span>

<span style="color: #000000;"><span style="color: #000080;">        public</span> <span style="color: #800080;">PlayButton</span>(<span style="color: #800080;">Context</span> ctx) {</span>
<span style="color: #000000;"><span style="color: #000080;">            super</span>(ctx);</span>
<span style="color: #000000;">            setText(<span style="color: #008000;">"Start playing"</span>);</span>
<span style="color: #000000;">            setOnClickListener(clicker);</span>
<span style="color: #000000;">        }</span>
<span style="color: #000000;">    }</span>

<span style="color: #000000;"><span style="color: #000080;">    public</span> <span style="color: #800080;">AudioRecordTest</span>() {</span>
<span style="color: #000000;">        mFileName = <span style="color: #800080;">Environment</span>.getExternalStorageDirectory().getAbsolutePath();</span>
<span style="color: #000000;">        mFileName += <span style="color: #008000;">"/audiorecordtest.3gp"</span>;</span>
<span style="color: #000000;">    }</span>

<span style="color: #008080;">    @Override</span>
<span style="color: #000000;"><span style="color: #000080;">    public</span> <span style="color: #000080;">void</span> onCreate(<span style="color: #800080;">Bundle</span> icicle) {</span>
<span style="color: #000000;"><span style="color: #000080;">        super</span>.onCreate(icicle);</span>

<span style="color: #000000;"><span style="color: #800080;">        LinearLayout</span> ll = <span style="color: #000080;">new</span> <span style="color: #800080;">LinearLayout</span>(<span style="color: #000080;">this</span>);</span>
<span style="color: #000000;">        mRecordButton = <span style="color: #000080;">new</span> <span style="color: #800080;">RecordButton</span>(<span style="color: #000080;">this</span>);</span>
<span style="color: #000000;">        ll.addView(mRecordButton,</span>
<span style="color: #000000;"><span style="color: #000080;">            new</span> <span style="color: #800080;">LinearLayout.LayoutParams</span>(</span>
<span style="color: #000000;"><span style="color: #800080;">                ViewGroup.LayoutParams</span>.WRAP_CONTENT,</span>
<span style="color: #000000;"><span style="color: #800080;">                ViewGroup.LayoutParams</span>.WRAP_CONTENT,</span>
<span style="color: #000000;"><span style="color: #008080;">                0</span>));</span>
<span style="color: #000000;">        mPlayButton = <span style="color: #000080;">new</span> <span style="color: #800080;">PlayButton</span>(<span style="color: #000080;">this</span>);</span>
<span style="color: #000000;">        ll.addView(mPlayButton,</span>
<span style="color: #000000;"><span style="color: #000080;">            new</span> <span style="color: #800080;">LinearLayout.LayoutParams</span>(</span>
<span style="color: #000000;"><span style="color: #800080;">                ViewGroup.LayoutParams</span>.WRAP_CONTENT,</span>
<span style="color: #000000;"><span style="color: #800080;">                ViewGroup.LayoutParams</span>.WRAP_CONTENT,</span>
<span style="color: #000000;"><span style="color: #008080;">                0</span>));</span>
<span style="color: #000000;">        setContentView(ll);</span>
<span style="color: #000000;">    }</span>

<span style="color: #008080;">    @Override</span>
<span style="color: #000000;"><span style="color: #000080;">    public</span> <span style="color: #000080;">void</span> onPause() {</span>
<span style="color: #000000;"><span style="color: #000080;">        super</span>.onPause();</span>
<span style="color: #000000;"><span style="color: #000080;">        if</span> (mRecorder != <span style="color: #000080;">null</span>) {</span>
<span style="color: #000000;">            mRecorder.release();</span>
<span style="color: #000000;">            mRecorder = <span style="color: #000080;">null</span>;</span>
<span style="color: #000000;">        }</span>

<span style="color: #000000;"><span style="color: #000080;">        if</span> (mPlayer != <span style="color: #000080;">null</span>) {</span>
<span style="color: #000000;">            mPlayer.release();</span>
<span style="color: #000000;">            mPlayer = <span style="color: #000080;">null</span>;</span>
<span style="color: #000000;">        }</span>
<span style="color: #000000;">    }</span>
<span style="color: #000000;">}</span>

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

/*

* The application needs to have the permission to write to external storage

* if the output file is written to the external storage, and also the

* permission to record audio. These permissions must be set in the

* application's AndroidManifest.xml file, with something like:

*

* <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

* <uses-permission android:name="android.permission.RECORD_AUDIO" />

*

*/

package com.android.audiorecordtest;

import android.app.Activity;

import android.widget.LinearLayout;

import android.os.Bundle;

import android.os.Environment;

import android.view.ViewGroup;

import android.widget.Button;

import android.view.View;

import android.view.View.OnClickListener;

import android.content.Context;

import android.util.Log;

import android.media.MediaRecorder;

import android.media.MediaPlayer;

import java.io.IOException;

public class AudioRecordTest extends Activity

{

private static final String LOG_TAG = "AudioRecordTest";

private static String mFileName = null;

private RecordButton mRecordButton = null;

private MediaRecorder mRecorder = null;

private PlayButton mPlayButton = null;

private MediaPlayer mPlayer = null;

private void onRecord(boolean start) {

if (start) {

startRecording();

} else {

stopRecording();

}

private void onPlay(boolean start) {

if (start) {

startPlaying();

} else {

stopPlaying();

}

private void startPlaying() {

mPlayer = new MediaPlayer();

try {

mPlayer.setDataSource(mFileName);

mPlayer.prepare();

mPlayer.start();

} catch (IOException e) {

Log.e(LOG_TAG, "prepare() failed");

}

private void stopPlaying() {

mPlayer.release();

mPlayer = null;

}

private void startRecording() {

mRecorder = new MediaRecorder();

mRecorder.setAudioSource(MediaRecorder.AudioSource.MIC);

mRecorder.setOutputFormat(MediaRecorder.OutputFormat.THREE_GPP);

mRecorder.setOutputFile(mFileName);

mRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.AMR_NB);

try {

mRecorder.prepare();

} catch (IOException e) {

Log.e(LOG_TAG, "prepare() failed");

}

mRecorder.start();

}

private void stopRecording() {

mRecorder.stop();

mRecorder.release();

mRecorder = null;

}

class RecordButton extends Button {

boolean mStartRecording = true;

OnClickListener clicker = new OnClickListener() {

public void onClick(View v) {

onRecord(mStartRecording);

if (mStartRecording) {

setText("Stop recording");

} else {

setText("Start recording");

}

mStartRecording = !mStartRecording;

}

};

public RecordButton(Context ctx) {

super(ctx);

setText("Start recording");

setOnClickListener(clicker);

}

class PlayButton extends Button {

boolean mStartPlaying = true;

OnClickListener clicker = new OnClickListener() {

public void onClick(View v) {

onPlay(mStartPlaying);

if (mStartPlaying) {

setText("Stop playing");

} else {

setText("Start playing");

}

mStartPlaying = !mStartPlaying;

}

};

public PlayButton(Context ctx) {

super(ctx);

setText("Start playing");

setOnClickListener(clicker);

}

public AudioRecordTest() {

mFileName = Environment.getExternalStorageDirectory().getAbsolutePath();

mFileName += "/audiorecordtest.3gp";

}

@Override

public void onCreate(Bundle icicle) {

super.onCreate(icicle);

LinearLayout ll = new LinearLayout(this);

mRecordButton = new RecordButton(this);

ll.addView(mRecordButton,

new LinearLayout.LayoutParams(

ViewGroup.LayoutParams.WRAP_CONTENT,

0));

mPlayButton = new PlayButton(this);

ll.addView(mPlayButton,

new LinearLayout.LayoutParams(

ViewGroup.LayoutParams.WRAP_CONTENT,

0));

setContentView(ll);

}

@Override

public void onPause() {

super.onPause();

if (mRecorder != null) {

mRecorder.release();

mRecorder = null;

}

if (mPlayer != null) {

mPlayer.release();

mPlayer = null;

}

}

本页部分内容根据Android Open Source Project创作并共享的内容修改，并在知识共享署名2.5许可协议中所述条款的限制下使用。

Android SDK升级至revision 12后的一个Bug及解决方案

今天把SDK从revision 11升级至了最新的revision 12，却发现出现了问题。模拟器无法运行，在运行时提示：

invalid command-line parameter: SDK\tools/emulator-arm.exe.
Hint: use '@foo' to launch a virtual device named 'foo'.
please use -help for more information

invalid command-line parameter: SDK\tools/emulator-arm.exe.

Hint: use '@foo' to launch a virtual device named 'foo'.

please use -help for more information

也就是说似乎是由于参数错误导致无法启动模拟器。

在网上还看到了有人出现这样的错误信息：

invalid command-line parameter: Files\Android\android-sdk\tools/emulator-arm.exe.
Hint: use '@foo' to launch a virtual device named 'foo'.
please use -help for more information

invalid command-line parameter: Files\Android\android-sdk\tools/emulator-arm.exe.

Hint: use '@foo' to launch a virtual device named 'foo'.

please use -help for more information

经过一番折腾之后终于找到了问题所在。应该是路径的问题。路径参数之前还有内容，被忽略了。这应该是本次升级的一个Bug。SDK所在文件夹的名称中如果有空格就会导致问题的发生（我使用的是android SDK这一名称）。于是将文件夹重命名为android-SDK之后，问题解决。