Common Intents(常用intent)
2014-04-15 15:48
567 查看
文章转载禁止用于商业用途,且不能带有虚拟货币、积分、注册等附加条件。转载须注明出处莫高雷草原以及作者@JiongBull。
访问Android API指南目录索引查看全部翻译
常用intent
intent可以让你启动其他应用的activity,你只需在Intent对象里描述你想要执行的操作就可以了(比如“查看地图”或“拍照“)。这种类型的intent被称为隐式intent,因为它不是指定要启动的应用组件,而是指定action和提供执行action处理的一些数据。
当你调用
the intent)给能处理该intent的应用,启动相关的
这篇文档描述了一些隐式intent,你可以使用它们来执行常用操作,按照处理intent的应用类型进行归类。每个章节还介绍了如何通过创建intent filter来告诉系统你的应用有处理相同操作的能力。
注意:如果当前设备上没有可以接收某个隐式intent的应用,那么你的应用在调用startActivity()时就会崩溃掉。为了验证是否存在能接收该intent的应用,请对你的Intent对象调用resolveActivity()。如果结果是非null的,说明至少有一个应用可以处理该intent,调用startActivity()是安全的。如果结果是null,那么你不应该使用该intent,并且如果可能的话,你应该关闭那些会调用该intent的功能。
如果你还不熟悉如何创建intent和intent filter,你应该先阅读Intents and Intent Filters。
要了解如何从开发主机上使用这篇文档中列举的intent,请参阅Verify Intents with the Android Debug Bridge。
Google Now
Google Now使用这篇文档中列举的一些intent来响应语音命令。更多信息,请参阅Intents
Fired by Google Now。
Google Now
"set an alarm for 7 am"
要创建一个新的闹钟,请使用
注意:小时、分钟和信息extra只有在Android 2.3(API级别9)或更高的平台上可用。其他的extra是在后续版本的平台上引入的。
Action
如果是一次性闹钟,请不要指定该extra。
如果要使用默认铃声,请不要指定该extra。
intent事例:
注意:
为了调用
intent filter事例:
Google Now
"set timer for 5 minutes"
要创建一个倒计时计时器,请使用
注意:该intent时从Android 4.4(API级别19)开始引入的。
Action
intent事例:
注意:
为了调用
intent filter事例:
要显示闹钟列表,请使用
虽然会调用该intent的应用不会很多(它主要是给系统应用使用的),任何有闹钟功能的应用都应该实现该intent filter,以便能显示当前所有的闹钟列表。
注意:该intent是从Android 4.4(API级别19)开始引入的。
Action
intent filter事例:
为了在用户的日历中添加一个新的时间,请使用
URI。你可以使用下面定义的extra来指定多种事件的详情。
Action
可以使用在CalendarContract.EventsColumns类中定义的常量来指定更多的事件细节。
intent事例:
intent filter事例:
为了打开相机应用并接收到返回的照片或视频,请使用
Action
当焦点重新从相机应用返回到你的activity时(你的应用会接收到onActivityResult()回调),你可以从你在EXTRA_OUTPUT值里指定的URI位置访问那些照片和视频。
注意:当你使用
intent事例:
更多关于如何使用intent拍照的信息,包括如何为输出路径创建合适的
Photos Simply or Taking Videos Simply。
intent filter事例:
在处理该intent时,你的activity应该检查传入Intent中的
Google Now
"take a picture"
要打开只有拍照模式的相机应用,请使用
Action
intent事例:
intent filter事例:
Google Now
"record a video"
要打开只有录制模式的相机应用,请使用
Action
intent事例:
intent filter事例:
要让用户选择联系人并让你的应用访问所有的联系人信息,请使用
在回传给你的
Provider读取联系人信息的临时权限,尽管你的应用没有包含
提示:如果你只需要访问联系人的部分信息,比如电话号码和电子邮件地址,请参阅下一章节select
specific contact data。
Action
intent事例:
更过关于在拥有联系人URI的情况下如何获取联系人详细内容的信息,请参阅Retrieving
Details for a Contact。请牢记, 当你使用上面的intent从联系人URI中抽取信息时,你不需要
要想使用户选择联系人的特定信息,比如电话号码、电子邮件地址或其他数据类型,请使用
type来指定MIME类型, 比如
如果你只需要从通讯录中获取某种类型的数据,使用ContactsContract.CommonDataKinds类来指定
Provider执行更多复杂的查询。
在回传给你的onActivityResult()回调中的结果
Action
或者是ContactsContract里的其他
intent事例:
要显示一个已知联系人的相信信息,请使用
data中使用
获取联系人URI的方法主要有两种:
使用ACTION_PICK返回的联系人URI,就像上一章节里展示的那样(不需要任何应用权限)。
直接访问包含所有联系人的列表,就像在Retrieving a List of Contacts中介绍的那样(需要READ_CONTACTS权限)。
Action
intent事例:
要编辑一个已有的联系人,请使用
data中使用
获取联系人URI的方法主要有两种:
使用ACTION_PICK返回的联系人URI,就像上一章节里展示的那样(不需要任何应用权限)。
直接访问包含所有联系人的列表,就像在Retrieving a List of Contacts中介绍的那样(需要READ_CONTACTS权限)。
Action
intent事例:
更多关于如何编辑联系人的信息,请参阅Modifying Contacts Using Intents。
要添加一个新的联系人,请使用
Action
intent事例:
更多关于如何新建一个联系人的信息,请参阅Modifying Contacts Using Intents。
要编写一封电子邮件,请根据是否包含附件选择下面的action,并且在intent中使用下面列举的extra键指定电子邮件的详细信息,例如收件人和主题等。
Action
Extras
intent事例:
如果你想确保你的intent只会被电子邮件应用处理(而不是其他文本消息应用或社交应用),那么请使用
scheme设置为
intent filter事例:
要请求用户选择某个文件,例如文档或图片,然后把引用返回给你的应用,请使用
在回传给你的
provider(一种
在Android 4.3(API级别18)和更高版本的平台上,你还可以通过把EXTRA_ALLOW_MULTIPLE添加到intent并设置为true来让用户可以选择多个文件。然后你可以在getClipData()方法返回的ClipData对象中访问每个被选中的文件。
Action
Category (可选)
获取照片的intent事例:
返回照片的intent filter事例:
和
<category android:name="android.intent.category.OPENABLE" />
</intent-filter>
</activity>[/code]
当运行在Android 4.4或更高版本的平台上时,可以不像前面打开文件那样必须在应用中复制一份文件拷贝(通过使用ACTION_GET_CONTENT action),而是可以请求打开其他应用管理的文件,只要使用
然而通过ACTION_GET_CONTENT action在回传给你的onActivityResult()方法的intent中,可能返回一个是任何类型的URI,但是通过
返回的URI给你的应用授予了长时间读取该文件的权限(也可能是编写权限)。所以当你想读取一个已存在的文件并且不想在你的应用中复制一份拷贝,或者你想在某个地方打开并编辑一个文件时,
通过在intent中添加EXTRA_ALLOW_MULTIPLE并赋值true,你就能让用户选择多个文件了。如果用户只选择了一项,那么你可以直接从getData()获取该项目。如果用户选中了多项,那么getData()会返回null,你必须通过getClipData()来获取ClipData对象,然后从中获取每个项目。
注意:你的intent必须制定MIME类型,必须声明
Action
Category
获取照片的intent事例:
第三方应用实际上时不能响应使用
要在这个UI中显示你应用的文件并用户其他应用可以打开它们,你必须实现一个
filter。例如:
更多关于如何使你的应用管理的文件可以从其他应用中打开的信息,请参阅theStorage
Access Framework指南。
Google Now
"start cycling"
"start my bike ride"
"stop cycling"
要追踪骑单车,请使用
Action
intent事例:
intent filter事例:
Google Now
"track my run"
"start running"
"stop running"
要追踪跑步,请使用
Action
intent事例:
intent filter事例:
Google Now
"start a workout"
"track my workout"
"stop workout"
要追踪锻炼,请使用
Action
intent事例:
intent filter事例:
Google Now
"what's my heart rate?"
"what's my bpm?"
要显示用户的心率,请使用
类型。
Action
intent事例:
intent filter事例:
Google Now
"how many steps have I taken?"
"what's my step count?"
要显示用户的步数,请使用
Action
intent事例:
intent filter事例:
Google Now
"get me a taxi"
"call me a car"
(Android Wear only)
需要叫车,请使用
注意:在完成action前,应用必须要询问用户得到确定才行。
Action
intent事例:
intent filter事例:
要打开地图,请使用
data中指定位置信息。
Action
事例:
事例:
事例:
事例:
注意:所有传入
MIME Type无
intent事例:
intent filter事例:
要播放音乐文件,请使用
data中指定文件的URI位置。
Action
MIME Type
intent事例:
intent filter事例:
Google Now
"play michael jackson billie jean"
要根据搜索请求播放音乐,请使用
这个intent应该包含
Action
用来指定检索模式(用来指定用户想要查询指定的艺术家、专辑、歌曲或播放列表)。大部分检索模式都需要附加的extra。例如,如果用户感兴趣听某首指定的歌,那么这个intent可能需要三个附加extra:歌曲标题、艺术家和专辑。针对的EXTRA_MEDIA_FOCUS里的值,该intent支持下列检索模式:
任意 -
播放任何音乐。接收的应用应该基于智能选测来播放一些音乐,比如用户最近听过的播放列表。
附加extra:
- 空字符串。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
非结构化 -
根据某个非结构化的检索查询播放指定的歌曲、专辑或类型。如果应用无法辨识用户想听的音乐类型,那就可以使用这种检索模式创建intent。应用应该尽可能的使用更多指定的检索模式。
附加extra:
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。
风格 -
播放指定风格的音乐。
附加extra:
风格。
- 风格。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
艺术家 -
播放指定艺术家的音乐。
附加extras:
- 艺术家。
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
专辑 -
播放指定专辑的音乐。
附加extra:
- 专辑。
艺术家。
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
歌曲 -
播放指定的歌曲。
附加extras:
专辑。
艺术家。
- 歌曲名称。
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
播放列表 -
播放指定的播放列表或匹配附加extra指定的标准的播放列表。
附加extras:
专辑。
艺术家。
播放列表参考的歌曲名称。
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
intent事例:
如果用户想听指定艺术家的音乐,那么检索应用可能生成下面的intent:
intent filter事例:
在处理这个intent时,你的activity应该检查在传入的Intent中EXTRA_MEDIA_FOCUS extra的值来确定检索模式。一旦你的activity辨别出检索模式了,就应该读取那个特定的检索模式对应的附加extra的值。有了这些信息,你的应用就能在自己的曲库中播放那些匹配检索查询条件的歌曲了。例如:
要打开电话应用并拨号,请使用
scheme指定电话号码。当电话应用打开时,它已经显示了该电话号码,但是用户必须按下拨号键才会开始拨号。
Google Now
"call 555-5555"
"call bob"
"call voicemail”
要想直接拨打电话,请使用
scheme指定电话号码。 当电话应用打开时,它就直接拨号了,用户不需要再去按拨号键了。
Action
打开拨号或电话应用。
直接拨号(需要
Data URI Scheme
MIME Type无
合法的电话号码是像the IETF RFC 3966中定义的那样。下面列举一些合法的事例:
电话拨号应用擅长规范格式,例如电话号码。所以在Uri.parse()方法中并没有要求使用严格定义的scheme。然而,如果你没有试过某个scheme或者不确定它能否被处理,请换用
intent事例:
Google Now
"search for cat videos on myvideoapp"
要支持在你应用的上下文里搜索,请像下面的intent filter事例那样在你的应用中使用
Action
Extras
intent filter事例:
要使用网络搜索,请使用
Action
intent事例:
当你的应用需要打开系统设置中的窗口让用户修改的时候,请在intent action中使用对应的action名称打开设置窗口。
Action
请参阅
Data URI Scheme无MIME Type无
intent事例:
要编写一条SMS或MMS文本消息,请使用下面其中一种intent action,并使用下面列举的extra键来指定消息细节,例如电话号码、主题、消息内容等。
Action
这些scheme可以用同样的方式处理。
MIME Type
Extras
intent事例:
如果你想确保你的intent只能背文本消息应用处理(而不是其他的邮件或社交应用),那么请使用
scheme。例如:
intent filter事例:
注意:如果你正在开发一款SMS/MMS消息应用,为了能在Android 4.4或更高版本的平台上作为系统的默认SMS应用,你必须实现针对许多额外action的intent filter。更多信息,请参阅
Google Now
"open example.com”
要打开网络页面,请使用
data中注定网络URL。
Action
intent事例:
intent filter事例:
提示:如果你的Android应用提供的功能和你的网站差不多,请为指向你网站的URL指定一个intent filter。然后,如果用户安装了你的应用,那么在邮件或其他网页中打开指向你网站站点的超链接时,会直接打开你的Android应用,而不是你的网页。
要验证你的应用能否响应那些你想要支持的intent,你可以使用
把Android设备设置为开发者模式(development),或使用虚拟设备(virtual
device)。
安装应用,该版本可以处理你想要支持的intent。
使用
例如:
如果你已经定义了必须的intent filter,那么你的应用应该就能处理到该intent了。
更多信息,请参阅Using activity manager (am)。
Google Now可以辨识出许多语音命令并为它们发出对应的intent。像这样,如果你的应用声明了相应的intent filter,用户就能通过Google Now语音命令来启动你的应用了。例如,如果你的引用可以设置闹钟(set
an alarm)并且你在manifest文件中添加了相应的intent filter,那么当用户需要设置闹钟时,Google Now就能让用户选择你的应用了,如图1所示。
图1. Google Now让用户从支持给定action的已安装应用里挑选。
Google Now识别针对表1所列举的action的语音命令。更多关于每种intent filter声明的信息,请点击相关action描述。
表1. Google Now可以识别的语音命令(Google Search应用v3.6).
访问Android API指南目录索引查看全部翻译
常用intent
intent可以让你启动其他应用的activity,你只需在Intent对象里描述你想要执行的操作就可以了(比如“查看地图”或“拍照“)。这种类型的intent被称为隐式intent,因为它不是指定要启动的应用组件,而是指定action和提供执行action处理的一些数据。
当你调用
startActivity()或
startActivityForResult()并传参隐式intent时,系统会解析该intent(resolves
the intent)给能处理该intent的应用,启动相关的
Activity。如果不止一个应用可以处理该intent,系统会给用户显示一个对话框,让用户来选择使用哪个应用。
这篇文档描述了一些隐式intent,你可以使用它们来执行常用操作,按照处理intent的应用类型进行归类。每个章节还介绍了如何通过创建intent filter来告诉系统你的应用有处理相同操作的能力。
注意:如果当前设备上没有可以接收某个隐式intent的应用,那么你的应用在调用startActivity()时就会崩溃掉。为了验证是否存在能接收该intent的应用,请对你的Intent对象调用resolveActivity()。如果结果是非null的,说明至少有一个应用可以处理该intent,调用startActivity()是安全的。如果结果是null,那么你不应该使用该intent,并且如果可能的话,你应该关闭那些会调用该intent的功能。
如果你还不熟悉如何创建intent和intent filter,你应该先阅读Intents and Intent Filters。
要了解如何从开发主机上使用这篇文档中列举的intent,请参阅Verify Intents with the Android Debug Bridge。
Google Now
Google Now使用这篇文档中列举的一些intent来响应语音命令。更多信息,请参阅Intents
Fired by Google Now。
闹钟
创建闹钟
Google Now
"set an alarm for 7 am"
要创建一个新的闹钟,请使用
ACTION_SET_ALARMaction并使用下面的extra设置诸如时间和信息等闹钟的详细信息。
注意:小时、分钟和信息extra只有在Android 2.3(API级别9)或更高的平台上可用。其他的extra是在后续版本的平台上引入的。
Action
ACTION_SET_ALARMData URI无MIME Type无Extras
EXTRA_HOUR闹钟的小时。
EXTRA_MINUTES闹钟的分钟。
EXTRA_MESSAGE标识闹钟的自定义信息。
EXTRA_DAYS一个包含了闹钟在每周的哪几天重复的
ArrayList。每天都必须使用Calendar类中定义的整型值来表示,例如
MONDAY。
如果是一次性闹钟,请不要指定该extra。
EXTRA_RINGTONE一个
content:类型的URI,用来指定闹钟使用的铃声,如果不需要铃声的话,使用VALUE_RINGTONE_SILENT。
如果要使用默认铃声,请不要指定该extra。
EXTRA_VIBRATE布尔值,用来指定闹钟是否需要震动功能。A boolean specifying whether to vibrate for this alarm.
EXTRA_SKIP_UI布尔值,用来指定响应的应用在设置闹钟时是否跳过自身的UI。如果是true,应用会跳过所有确认UI,直接设置需要的闹钟。
intent事例:
public void createAlarm(String message, int hour, int minutes) { Intent intent = new Intent(AlarmClock.ACTION_SET_ALARM) .putExtra(AlarmClock.EXTRA_MESSAGE, message) .putExtra(AlarmClock.EXTRA_HOUR, hour) .putExtra(AlarmClock.EXTRA_MINUTES, minutes); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
注意:
为了调用
ACTION_SET_ALARMintent,你的应用必须拥有
SET_ALARM权限:
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.SET_ALARM" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
创建计时器
Google Now
"set timer for 5 minutes"
要创建一个倒计时计时器,请使用
ACTION_SET_TIMERaction并使用下面的extra设置诸如持续时长等计时器详细信息。
注意:该intent时从Android 4.4(API级别19)开始引入的。
Action
ACTION_SET_TIMERData URI无MIME Type无Extras
EXTRA_LENGTH计时器的时长,单位秒。
EXTRA_MESSAGE标识计时器的自定义信息。
EXTRA_SKIP_UI布尔值,用来指定响应的应用在设置计时器时是否跳过自身的UI。如果是true,应用会直接跳过所有的确认UI,直接启动需要的计时器。
intent事例:
public void startTimer(String message, int seconds) { Intent intent = new Intent(AlarmClock.ACTION_SET_TIMER) .putExtra(AlarmClock.EXTRA_MESSAGE, message) .putExtra(AlarmClock.EXTRA_LENGTH, seconds) .putExtra(AlarmClock.EXTRA_SKIP_UI, true); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
注意:
为了调用
ACTION_SET_TIMERintent,你的应用必须拥有
SET_ALARM权限:
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.SET_TIMER" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
显示所有闹钟
要显示闹钟列表,请使用ACTION_SHOW_ALARMSaction。
虽然会调用该intent的应用不会很多(它主要是给系统应用使用的),任何有闹钟功能的应用都应该实现该intent filter,以便能显示当前所有的闹钟列表。
注意:该intent是从Android 4.4(API级别19)开始引入的。
Action
ACTION_SHOW_ALARMSData URI无MIME Type无
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.SHOW_ALARMS" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
日历
添加日历事件
为了在用户的日历中添加一个新的时间,请使用ACTION_INSERTaction并用Events.CONTENT_URI来指定data
URI。你可以使用下面定义的extra来指定多种事件的详情。
Action
ACTION_INSERTData URI
Events.CONTENT_URIMIME Type
"vnd.android.cursor.dir/event"Extras
EXTRA_EVENT_ALL_DAY布尔值,用来指定是否为全天事件
EXTRA_EVENT_BEGIN_TIME事件的开始时间(从UNIX计时元年开始以来的毫秒值,UNIX的计时元年也就是1970年1月1日的0点0分0秒0毫秒)。
EXTRA_EVENT_END_TIME事件的结束时间(从UNIX计时元年开始以来的毫秒值)。
TITLE事件的标题。
DESCRIPTION事件的描述。
EVENT_LOCATION事件的位置。
EXTRA_EMAIL用来指定受邀请人的电子邮件地址,用逗号隔开。
可以使用在CalendarContract.EventsColumns类中定义的常量来指定更多的事件细节。
intent事例:
public void addEvent(String title, String location, Calendar begin, Calendar end) { Intent intent = new Intent(Intent.ACTION_INSERT) .setData(Events.CONTENT_URI) .putExtra(Events.TITLE, title) .putExtra(Events.EVENT_LOCATION, location) .putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, begin) .putExtra(CalendarContract.EXTRA_EVENT_END_TIME, end); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.INSERT" /> <data android:mimeType="vnd.android.cursor.dir/event" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
相机
拍照或录像并返回结果
为了打开相机应用并接收到返回的照片或视频,请使用ACTION_IMAGE_CAPTURE或
ACTION_VIDEO_CAPTUREaction。记得在EXTRA_OUTPUT extra中指定你想要相机保存照片或视频的位置。
Action
ACTION_IMAGE_CAPTURE或
ACTION_VIDEO_CAPTUREData URI Scheme无MIME Type无Extras
EXTRA_OUTPUT相机你敢用保存图片或视频文件的URI地址(Uri对象)。
当焦点重新从相机应用返回到你的activity时(你的应用会接收到onActivityResult()回调),你可以从你在EXTRA_OUTPUT值里指定的URI位置访问那些照片和视频。
注意:当你使用
ACTION_IMAGE_CAPTURE来拍照时,相机可能会在结果Intent里返回照片的一个缩小尺寸的拷贝(缩略图),存储在名为”data”的extra中的Bitmap里。
intent事例:
static final int REQUEST_IMAGE_CAPTURE = 1; static final Uri mLocationForPhotos; public void capturePhoto(String targetFilename) { Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.withAppendedPath(mLocationForPhotos, targetFilename); if (intent.resolveActivity(getPackageManager()) != null) { startActivityForResult(intent, REQUEST_IMAGE_CAPTURE); } } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) { Bitmap thumbnail = data.getParcelable("data"); // 处理保存在mLocationForPhotos中的全尺寸照片 ... } }
更多关于如何使用intent拍照的信息,包括如何为输出路径创建合适的
Uri,请阅读Taking
Photos Simply or Taking Videos Simply。
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.media.action.IMAGE_CAPTURE" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
在处理该intent时,你的activity应该检查传入Intent中的
EXTRA_OUTPUTextra,然后把捕获的图片或视频保存在extra指定的路径中,最后调用setResult(),并传入那个在”data” extra中包含压缩缩略图的Intent。
启动只有拍照模式的相机应用
Google Now
"take a picture"
要打开只有拍照模式的相机应用,请使用
INTENT_ACTION_STILL_IMAGE_CAMERAaction。
Action
INTENT_ACTION_STILL_IMAGE_CAMERAData URI Scheme无MIME Type无Extras无
intent事例:
public void capturePhoto() { Intent intent = new Intent(MediaStore.INTENT_ACTION_STILL_IMAGE_CAMERA); if (intent.resolveActivity(getPackageManager()) != null) { startActivityForResult(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.media.action.STILL_IMAGE_CAMERA" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
启动只有录制模式的相机应用
Google Now
"record a video"
要打开只有录制模式的相机应用,请使用
INTENT_ACTION_VIDEO_CAMERAaction。
Action
INTENT_ACTION_VIDEO_CAMERAData URI Scheme无MIME Type无Extras无
intent事例:
public void capturePhoto() { Intent intent = new Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA); if (intent.resolveActivity(getPackageManager()) != null) { startActivityForResult(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.media.action.VIDEO_CAMERA" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
通讯录/联系人应用
选择联系人
要让用户选择联系人并让你的应用访问所有的联系人信息,请使用ACTION_PICKaction并把MIME类型指定为
Contacts.CONTENT_TYPE。
在回传给你的
onActivityResult()回调中的结果
Intent中,包含了指向被选择联系人的
content:URI。响应的应用还会给你的应用授予使用Contacts
Provider读取联系人信息的临时权限,尽管你的应用没有包含
READ_CONTACTS权限。
提示:如果你只需要访问联系人的部分信息,比如电话号码和电子邮件地址,请参阅下一章节select
specific contact data。
Action
ACTION_PICKData URI Scheme无MIME Type
Contacts.CONTENT_TYPE
intent事例:
static final int REQUEST_SELECT_CONTACT = 1; public void selectContact() { Intent intent = new Intent(Intent.ACTION_PICK); intent.setType(ContactsContract.Contacts.CONTENT_TYPE); if (intent.resolveActivity(getPackageManager()) != null) { startActivityForResult(intent, REQUEST_SELECT_CONTACT); } } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == REQUEST_SELECT_CONTACT && resultCode == RESULT_OK) { Uri contactUri = data.getData(); // 处理存储在contactUri中被选中的联系人信息 ... } }
更过关于在拥有联系人URI的情况下如何获取联系人详细内容的信息,请参阅Retrieving
Details for a Contact。请牢记, 当你使用上面的intent从联系人URI中抽取信息时,你不需要
READ_CONTACTS权限就能读取那个联系人的详细信息了。
选择联系人的特定数据
要想使用户选择联系人的特定信息,比如电话号码、电子邮件地址或其他数据类型,请使用ACTION_PICKaction并使用下面列举的某个content
type来指定MIME类型, 比如
CommonDataKinds.Phone.CONTENT_TYPE来获取联系人的电话号码。
如果你只需要从通讯录中获取某种类型的数据,使用ContactsContract.CommonDataKinds类来指定
CONTENT_TYPE比使用Contacts.CONTENT_TYPE(就像前一章节展示的那样)更高效,因为返回的结果可以让你直接访问目标数据,而不需要对Contacts
Provider执行更多复杂的查询。
在回传给你的onActivityResult()回调中的结果
Intent中,包含了指向被选中联系人数据的
content:URI。响应的应用还会给你的应用授予读取联系人数据的临时权限,尽管你的应用没有包含
READ_CONTACTS权限。
Action
ACTION_PICKData URI Scheme无MIME Type
CommonDataKinds.Phone.CONTENT_TYPE从联系人信息中挑选电话号码。
CommonDataKinds.Email.CONTENT_TYPE从联系人信息中挑选电子邮件地址。
CommonDataKinds.StructuredPostal.CONTENT_TYPE从联系人信息中挑选邮寄地址。
或者是ContactsContract里的其他
CONTENT_TYPE值。
intent事例:
static final int REQUEST_SELECT_PHONE_NUMBER = 1; public void selectContact() { // 启动一个activity供用户从通讯录中选取一个电话号码 Intent intent = new Intent(Intent.ACTION_PICK); intent.setType(CommonDataKinds.Phone.CONTENT_TYPE); if (intent.resolveActivity(getPackageManager()) != null) { startActivityForResult(intent, REQUEST_SELECT_PHONE_NUMBER); } } protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == REQUEST_SELECT_PHONE_NUMBER && resultCode == RESULT_OK) { // 获取URI并在content provider中查询该电话号码 Uri contactUri = data.getData(); String[] projection = new String[]{CommonDataKinds.Phone.NUMBER}; Cursor cursor = getContentResolver().query(contactUri, projection, null, null, null); // 如果返回的游标有效,获取电话号码 if (cursor != null && cursor.moveToFirst()) { int numberIndex = cursor.getColumnIndex(CommonDataKinds.Phone.NUMBER); String number = cursor.getString(numberIndex); // 处理电话号码 ... } } }
查看联系人
要显示一个已知联系人的相信信息,请使用ACTION_VIEWaction并在intent
data中使用
content:URI指定联系人。
获取联系人URI的方法主要有两种:
使用ACTION_PICK返回的联系人URI,就像上一章节里展示的那样(不需要任何应用权限)。
直接访问包含所有联系人的列表,就像在Retrieving a List of Contacts中介绍的那样(需要READ_CONTACTS权限)。
Action
ACTION_VIEWData URI Scheme
content:<URI>MIME Type无。类型可以从联系人URI推测出来。
intent事例:
public void viewContact(Uri contactUri) { Intent intent = new Intent(Intent.ACTION_VIEW, contactUri); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
编辑已有的联系人
要编辑一个已有的联系人,请使用ACTION_EDITaction,在intent
data中使用
content:URI来指定联系人,并且使用ContactsContract.Intents.Insert里的常量在extra中指定所有已知的联系人信息。
获取联系人URI的方法主要有两种:
使用ACTION_PICK返回的联系人URI,就像上一章节里展示的那样(不需要任何应用权限)。
直接访问包含所有联系人的列表,就像在Retrieving a List of Contacts中介绍的那样(需要READ_CONTACTS权限)。
Action
ACTION_EDITData URI Scheme
content:<URI>MIME Type类型可以从联系人URI中推测出来Extras在
ContactsContract.Intents.Insert中还定义了其他extra,你可以用来填充联系人的详细信息。
intent事例:
public void editContact(Uri contactUri, String email) { Intent intent = new Intent(Intent.ACTION_EDIT); intent.setData(contactUri); intent.putExtra(Intents.Insert.EMAIL, email); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
更多关于如何编辑联系人的信息,请参阅Modifying Contacts Using Intents。
添加联系人
要添加一个新的联系人,请使用ACTION_INSERTaction,用
Contacts.CONTENT_TYPE指定MIME类型,并且使用ContactsContract.Intents.Insert里的常量在extra中指定所有已知的联系人信息。
Action
ACTION_INSERTData URI Scheme无MIME Type
Contacts.CONTENT_TYPEExtras在
ContactsContract.Intents.Insert中定义了许多extra。
intent事例:
public void insertContact(String name, String email) { Intent intent = new Intent(Intent.ACTION_INSERT); intent.setType(Contacts.CONTENT_TYPE); intent.putExtra(Intents.Insert.NAME, name); intent.putExtra(Intents.Insert.EMAIL, email); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
更多关于如何新建一个联系人的信息,请参阅Modifying Contacts Using Intents。
电子邮件
编写可选附件的电子邮件
要编写一封电子邮件,请根据是否包含附件选择下面的action,并且在intent中使用下面列举的extra键指定电子邮件的详细信息,例如收件人和主题等。Action
ACTION_SENDTO(针对不带附件)或
ACTION_SEND(针对带一个附件)或
ACTION_SEND_MULTIPLE(针对带多个附件)Data URI Scheme无MIME Type
PLAIN_TEXT_TYPE("text/plain")
"*/*"
Extras
Intent.EXTRA_EMAIL字符串数组,包含所有收件人的电子邮件地址。
Intent.EXTRA_CC字符串数据,包含所有抄送收件人的电子邮件地址。
Intent.EXTRA_BCC字符串数组,包含所有密送收件人的电子邮件地址。
Intent.EXTRA_SUBJECT电子邮件主题字符串。
Intent.EXTRA_TEXT电子邮件正文字符串。
Intent.EXTRA_STREAM指定附件的
Uri。如果使用的是
ACTION_SEND_MULTIPLEaction,那么这里应该使用包含多个Uri对象的ArrayList替代。
intent事例:
public void composeEmail(String[] addresses, String subject, Uri attachment) { Intent intent = new Intent(Intent.ACTION_SEND); intent.setType("*/*"); intent.putExtra(Intent.EXTRA_EMAIL, addresses); intent.putExtra(Intent.EXTRA_SUBJECT, subject); intent.putExtra(Intent.EXTRA_STREAM, attachment); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
如果你想确保你的intent只会被电子邮件应用处理(而不是其他文本消息应用或社交应用),那么请使用
ACTION_SENDTOaction并且把data
scheme设置为
"mailto:”。例如:
public void composeEmail(String[] addresses, String subject) { Intent intent = new Intent(Intent.ACTION_SENDTO); intent.setData(Uri.parse("mailto:")); // 只有电子邮件应用可以处理 intent.putExtra(Intent.EXTRA_EMAIL, addresses); intent.putExtra(Intent.EXTRA_SUBJECT, subject); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.SEND" /> <data android:type="*/*" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> <intent-filter> <action android:name="android.intent.action.SENDTO" /> <data android:scheme="mailto" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
文件存储
获取指定类型的文件
要请求用户选择某个文件,例如文档或图片,然后把引用返回给你的应用,请使用ACTION_GET_CONTENTaction并指定你期望的MIME类型。返回给你应用的文件引用对你activity当前的生命周期来说是瞬时的,所以如果你想要晚点再访问的话,你必须把它复制一个拷贝文件中以供晚点访问。这个intent也允许用户在当前进程中创建新的文件(例如,用户可以不选取已存在的照片,而是使用相机拍照)。
在回传给你的
onActivityResult()方法中的结果
Intent中,包含指向文件的URI数据。该URI可能是任何类型的,例如
http:URI,
file:URI或
content:URI。然而,如果你想把可选文件限制为只能通过content
provider(一种
content:URI)访问并且可以作为文件流给openFileDescriptor()使用,那么你应该把CATEGORY_OPENABLE添加到你的intent中。
在Android 4.3(API级别18)和更高版本的平台上,你还可以通过把EXTRA_ALLOW_MULTIPLE添加到intent并设置为true来让用户可以选择多个文件。然后你可以在getClipData()方法返回的ClipData对象中访问每个被选中的文件。
Action
ACTION_GET_CONTENTData URI Scheme无MIME TypeMIME类型与用户应该选择的文件类型一致。Extras
EXTRA_ALLOW_MULTIPLE布尔值,用来声明用户能否同时选择多个文件。
EXTRA_LOCAL_ONLY布尔值,用来声明返回的文件是否必须能从设备直接访问,而不是需要从远程服务器上下载。
Category (可选)
CATEGORY_OPENABLE只返回“可打开的”文件,也就是可以被openFileDescriptor()当做文件流使用的。
获取照片的intent事例:
static final int REQUEST_IMAGE_GET = 1; public void selectImage() { Intent intent = new Intent(Intent.ACTION_GET_CONTENT); intent.setType("image/*"); if (intent.resolveActivity(getPackageManager()) != null) { startActivityForResult(intent, REQUEST_IMAGE_GET); } } protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == REQUEST_IMAGE_GET && resultCode == RESULT_OK) { Bitmap thumbnail = data.getParcelable("data"); Uri fullPhotoUri = data.getData(); // 处理保存在ullPhotoUri中的图片信息 ... } }
返回照片的intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.GET_CONTENT" /> <data android:type="image/*" /> <category android:name="android.intent.category.DEFAULT" /> <!-- OPENABLE category声明了它返回的文件是可以从content provider中访问的,支持[code]OpenableColumns
和
ContentResolver.openFileDescriptor()-->
<category android:name="android.intent.category.OPENABLE" />
</intent-filter>
</activity>[/code]
打开指定类型的文件
当运行在Android 4.4或更高版本的平台上时,可以不像前面打开文件那样必须在应用中复制一份文件拷贝(通过使用ACTION_GET_CONTENT action),而是可以请求打开其他应用管理的文件,只要使用ACTION_OPEN_DOCUMENTaction并指定MIME类型即可。同样可以使用ACTION_CREATE_DOCUMENT action来让用户创建一个你的应用可编写的新的文档。例如,ACTION_CREATE_DOCUMENT intent不是从已存在的PDF文档中选取,而是让用户选择他们想在哪里创建新的文档(在其他管理文档存储的应用中),然后你的应用就会接收到URI位置,它描述了你可以编写的新文档的位置。
然而通过ACTION_GET_CONTENT action在回传给你的onActivityResult()方法的intent中,可能返回一个是任何类型的URI,但是通过
ACTION_OPEN_DOCUMENT和
ACTION_CREATE_DOCUMENT返回的结果intent却总是指定了被选中的文件的格式,
content:URI,可以通过DocumentsProvider来回溯。你可以使用openFileDescriptor()打开文件,使用DocumentsContract.Document里的列查询它的详细信息。
返回的URI给你的应用授予了长时间读取该文件的权限(也可能是编写权限)。所以当你想读取一个已存在的文件并且不想在你的应用中复制一份拷贝,或者你想在某个地方打开并编辑一个文件时,
ACTION_OPEN_DOCUMENTaction更有用(而不是使用ACTION_GET_CONTENT)。
通过在intent中添加EXTRA_ALLOW_MULTIPLE并赋值true,你就能让用户选择多个文件了。如果用户只选择了一项,那么你可以直接从getData()获取该项目。如果用户选中了多项,那么getData()会返回null,你必须通过getClipData()来获取ClipData对象,然后从中获取每个项目。
注意:你的intent必须制定MIME类型,必须声明
CATEGORY_OPENABLEcategory。如果合适的话,你可以通过把MIME类型数组指定给
EXTRA_MIME_TYPESextra来添加多个MIME类型,如果你要这么做的话,必须在setType()中设置主要的MIME类型为
"*/*”。
Action
ACTION_OPEN_DOCUMENT或
ACTION_CREATE_DOCUMENTData URI Scheme无MIME TypeMIME类型与用户应该原则的文件类型一致。Extras
EXTRA_MIME_TYPESMIME类型数组,与你的应用请求的文件类型一致。当你使用这个extra时,你必须在setType()中设置主要的MIME类型为
"*/*”。
EXTRA_ALLOW_MULTIPLE布尔值,用来指定用户是否能同时选取多个文件。
EXTRA_TITLE在使用
ACTION_CREATE_DOCUMENT时来指定初始化的文件名称。
EXTRA_LOCAL_ONLY布尔值,用来声明返回的文件是否必须能从设备直接访问,而不是需要从远程服务器上下载。
Category
CATEGORY_OPENABLE只返回“可打开的”文件,也就是可以被openFileDescriptor()当做文件流使用的。
获取照片的intent事例:
static final int REQUEST_IMAGE_OPEN = 1; public void selectImage() { Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); intent.setType("image/*"); intent.addCategory(Intent.CATEGORY_OPENABLE); // 只有系统能接收到这个ACTION_OPEN_DOCUMENT,所以不需要测试了。 startActivityForResult(intent, REQUEST_IMAGE_OPEN); } protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == REQUEST_IMAGE_OPEN && resultCode == RESULT_OK) { Uri fullPhotoUri = data.getData(); // 处理保存在fullPhotoUri中的未压缩照片。 ... } }
第三方应用实际上时不能响应使用
ACTION_OPEN_DOCUMENTaction的intent。系统会接收到这个intent,然后在一个统一的用户界面上显示来自各种应用的可用文件。
要在这个UI中显示你应用的文件并用户其他应用可以打开它们,你必须实现一个
DocumentsProvider,然后包含一个名为
PROVIDER_INTERFACE(
"android.content.action.DOCUMENTS_PROVIDER")的intent
filter。例如:
<provider ... android:grantUriPermissions="true" android:exported="true" android:permission="android.permission.MANAGE_DOCUMENTS"> <intent-filter> <action android:name="android.content.action.DOCUMENTS_PROVIDER" /> </intent-filter> </provider>
更多关于如何使你的应用管理的文件可以从其他应用中打开的信息,请参阅theStorage
Access Framework指南。
健康
开始/结束骑单车
Google Now
"start cycling"
"start my bike ride"
"stop cycling"
要追踪骑单车,请使用
ACTION_TRACKaction和
"vnd.google.fitness.activity/biking"MIME类型,并且在开始时把
EXTRA_STATUSextra设置为
STATUS_ACTIVE,在结束时设置为
STATUS_COMPLETED。
Action
ACTION_TRACKData URI无MIME Type
"vnd.google.fitness.activity/biking"Extras
EXTRA_STATUS字符串,启动时设置为
STATUS_ACTIVE,结束时设置为
STATUS_COMPLETED。
intent事例:
public void startBikeRide() { Intent intent = new Intent(FitnessIntents.ACTION_TRACK) .setType("vnd.google.fitness.activity/biking") .putExtra(FitnessIntents.EXTRA_STATUS, FitnessIntents.STATUS_ACTIVE); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="vnd.google.fitness.TRACK" /> <data android:mimeType="vnd.google.fitness.activity/biking" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
开始/结束跑步
Google Now
"track my run"
"start running"
"stop running"
要追踪跑步,请使用
ACTION_TRACKaction和
"vnd.google.fitness.activity/running"MIME类型,并且在开始时把
EXTRA_STATUSextra设置为
STATUS_ACTIVE,在结束时设置为
STATUS_COMPLETED。
Action
ACTION_TRACKData URI无MIME Type
"vnd.google.fitness.activity/running"Extras
EXTRA_STATUS字符串,启动时设置为
STATUS_ACTIVE,结束时设置为
STATUS_COMPLETED。
intent事例:
public void startRun() { Intent intent = new Intent(FitnessIntents.ACTION_TRACK) .setType("vnd.google.fitness.activity/running") .putExtra(FitnessIntents.EXTRA_STATUS, FitnessIntents.STATUS_ACTIVE); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="vnd.google.fitness.TRACK" /> <data android:mimeType="vnd.google.fitness.activity/running" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
开始/结束锻炼
Google Now
"start a workout"
"track my workout"
"stop workout"
要追踪锻炼,请使用
ACTION_TRACKaction和
"vnd.google.fitness.activity/other"MIME类型,并且在开始时把
STATUS_ACTIVE设置为
STATUS_ACTIVE,在结束时设置为
STATUS_COMPLETED。
Action
ACTION_TRACKData URI无MIME Type
"vnd.google.fitness.activity/other"Extras
EXTRA_STATUS字符串,启动时设置为
STATUS_ACTIVE,结束时设置为
STATUS_COMPLETED。
intent事例:
public void startWorkout() { Intent intent = new Intent(FitnessIntents.ACTION_TRACK) .setType("vnd.google.fitness.activity/other") .putExtra(FitnessIntents.EXTRA_STATUS, FitnessIntents.STATUS_ACTIVE); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="vnd.google.fitness.TRACK" /> <data android:mimeType="vnd.google.fitness.activity/other" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
显示心率
Google Now
"what's my heart rate?"
"what's my bpm?"
要显示用户的心率,请使用
ACTION_VIEWaction和
"vnd.google.fitness.data_type/com.google.heart_rate.bpm"MIME
类型。
Action
ACTION_VIEWData URI无MIME Type
"vnd.google.fitness.data_type/com.google.heart_rate.bpm"Extras无
intent事例:
public void showHeartRate() { Intent intent = new Intent(FitnessIntents.ACTION_VIEW) .setType("vnd.google.fitness.data_type/com.google.heart_rate.bpm"); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="vnd.google.fitness.VIEW" /> <data android:mimeType="vnd.google.fitness.data_type/com.google.heart_rate.bpm" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
显示步数
Google Now
"how many steps have I taken?"
"what's my step count?"
要显示用户的步数,请使用
ACTION_VIEWaction和
"vnd.google.fitness.data_type/com.google.step_count.cumulative"MIME类型。
Action
ACTION_VIEWData URI无MIME Type
"vnd.google.fitness.data_type/com.google.step_count.cumulative"Extras无
intent事例:
public void showStepCount() { Intent intent = new Intent(FitnessIntents.ACTION_VIEW) .setType("vnd.google.fitness.data_type/com.google.step_count.cumulative"); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="vnd.google.fitness.VIEW" /> <data android:mimeType="vnd.google.fitness.data_type/com.google.step_count.cumulative" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
本地action
叫车
Google Now
"get me a taxi"
"call me a car"
(Android Wear only)
需要叫车,请使用
ACTION_RESERVE_TAXI_RESERVATIONaction。
注意:在完成action前,应用必须要询问用户得到确定才行。
Action
ACTION_RESERVE_TAXI_RESERVATIONData URI无MIME Type无Extras无
intent事例:
public void callCar() { Intent intent = new Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="com.google.android.gms.actions.RESERVE_TAXI_RESERVATION" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
地图
在地图上显示位置
要打开地图,请使用ACTION_VIEWaction并使用下面定义的一种scheme在intent
data中指定位置信息。
Action
ACTION_VIEWData URI Scheme
geo:latitude,longitude在地图上显示指定经纬度的的位置。
事例:
"geo:47.6,-122.3"
geo:latitude,longitude?z=zoom以某个缩放级别在地图上显示指定经纬度的位置。缩放级别1显示给定经纬度位于中心的整个地球,最高的(最近的)缩放级别是23。
事例:
"geo:47.6,-122.3?z=11"
geo:0,0?q=lat,lng(label)在指定经纬度的地图上显示字符串标签。
事例:
"geo:0,0?q=34.99,-106.61(Treasure)"
geo:0,0?q=my+street+address显示“my street address”的位置(可能是指定的地址,也可能是根据该位置的查询)。
事例:
"geo:0,0?q=1600+Amphitheatre+Parkway%2C+CA"
注意:所有传入
geoURI中的字符串都必须进行编码。例如,字符串
1st & Pike, Seattle应该变成
1st%20%26%20Pike%2C%20Seattle。字符串中的空格可以用%20编码,也可以用加号(+)来替代。
MIME Type无
intent事例:
public void showMap(Uri geoLocation) { Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(geoLocation); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.VIEW" /> <data android:scheme="geo" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
音乐或视频
播放媒体文件
要播放音乐文件,请使用ACTION_VIEWaction并在intent
data中指定文件的URI位置。
Action
ACTION_VIEWData URI Scheme
file:<URI>
content:<URI>
http:<URL>
MIME Type
"audio/*"
"application/ogg"
"application/x-ogg"
"application/itunes"或其他你的应用可能用到的格式。
intent事例:
public void playMedia(Uri file) { Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(file); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.VIEW" /> <data android:type="audio/*" /> <data android:type="application/ogg" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
根据搜索请求播放音乐
Google Now
"play michael jackson billie jean"
要根据搜索请求播放音乐,请使用
INTENT_ACTION_MEDIA_PLAY_FROM_SEARCHintent。应用在响应用户播放音乐的语音命令时可能会触发这个intent。接收该intent的应用会在它的播放清单中检索该曲目,在匹配到指定查询的内容时就会播放。
这个intent应该包含
EXTRA_MEDIA_FOCUS字符串extra,它制定了检索模式。例如,检索模式可以指定是搜索艺术家姓名还是歌曲名。
Action
INTENT_ACTION_MEDIA_PLAY_FROM_SEARCHData URI Scheme无MIME Type无Extras
MediaStore.EXTRA_MEDIA_FOCUS(必须)
用来指定检索模式(用来指定用户想要查询指定的艺术家、专辑、歌曲或播放列表)。大部分检索模式都需要附加的extra。例如,如果用户感兴趣听某首指定的歌,那么这个intent可能需要三个附加extra:歌曲标题、艺术家和专辑。针对的EXTRA_MEDIA_FOCUS里的值,该intent支持下列检索模式:
任意 -
"vnd.android.cursor.item/*"
播放任何音乐。接收的应用应该基于智能选测来播放一些音乐,比如用户最近听过的播放列表。
附加extra:
QUERY(必须)
- 空字符串。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
非结构化 -
"vnd.android.cursor.item/*"
根据某个非结构化的检索查询播放指定的歌曲、专辑或类型。如果应用无法辨识用户想听的音乐类型,那就可以使用这种检索模式创建intent。应用应该尽可能的使用更多指定的检索模式。
附加extra:
QUERY(必须)
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。
风格 -
Audio.Genres.ENTRY_CONTENT_TYPE
播放指定风格的音乐。
附加extra:
"android.intent.extra.genre” (必须) -
风格。
QUERY(必须)
- 风格。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
艺术家 -
Audio.Artists.ENTRY_CONTENT_TYPE
播放指定艺术家的音乐。
附加extras:
EXTRA_MEDIA_ARTIST(必须)
- 艺术家。
"android.intent.extra.genre"- 风格。
QUERY(必须)
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
专辑 -
Audio.Albums.ENTRY_CONTENT_TYPE
播放指定专辑的音乐。
附加extra:
EXTRA_MEDIA_ALBUM(必须)
- 专辑。
EXTRA_MEDIA_ARTIST-
艺术家。
"android.intent.extra.genre"- 风格。
QUERY(required)
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
歌曲 -
"vnd.android.cursor.item/audio"
播放指定的歌曲。
附加extras:
EXTRA_MEDIA_ALBUM-
专辑。
EXTRA_MEDIA_ARTIST-
艺术家。
"android.intent.extra.genre"- 风格。
EXTRA_MEDIA_TITLE(必须)
- 歌曲名称。
QUERY(必须)
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
播放列表 -
Audio.Playlists.ENTRY_CONTENT_TYPE
播放指定的播放列表或匹配附加extra指定的标准的播放列表。
附加extras:
EXTRA_MEDIA_ALBUM-
专辑。
EXTRA_MEDIA_ARTIST-
艺术家。
"android.intent.extra.genre"- 风格。
"android.intent.extra.playlist"- 播放列表。
EXTRA_MEDIA_TITLE-
播放列表参考的歌曲名称。
QUERY(必须)
- 字符串,包含了艺术家、专辑、歌曲名称或风格的组合。这个extra是为了向后兼容, 所以需要提供该字段:那些不了解检索模式的已有的应用可以把该intent当做非结构化检索。
intent事例:
如果用户想听指定艺术家的音乐,那么检索应用可能生成下面的intent:
public void playSearchArtist(String artist) { Intent intent = new Intent(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH); intent.putExtra(MediaStore.EXTRA_MEDIA_FOCUS, MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE); intent.putExtra(MediaStore.EXTRA_MEDIA_ARTIST, artist); intent.putExtra(SearchManager.QUERY, artist); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.media.action.MEDIA_PLAY_FROM_SEARCH" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
在处理这个intent时,你的activity应该检查在传入的Intent中EXTRA_MEDIA_FOCUS extra的值来确定检索模式。一旦你的activity辨别出检索模式了,就应该读取那个特定的检索模式对应的附加extra的值。有了这些信息,你的应用就能在自己的曲库中播放那些匹配检索查询条件的歌曲了。例如:
protected void onCreate(Bundle savedInstanceState) { ... Intent intent = this.getIntent(); if (intent.getAction().compareTo(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH) == 0) { String mediaFocus = intent.getStringExtra(MediaStore.EXTRA_MEDIA_FOCUS); String query = intent.getStringExtra(SearchManager.QUERY); // 根据检索类型而异,下面有些extra可能不可用 String album = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ALBUM); String artist = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ARTIST); String genre = intent.getStringExtra("android.intent.extra.genre"); String playlist = intent.getStringExtra("android.intent.extra.playlist"); String title = intent.getStringExtra(MediaStore.EXTRA_MEDIA_TITLE); // 确定检索模式并使用合适的extra if (mediaFocus == null) { // ‘非结构化’检索模式(向后兼容) playUnstructuredSearch(query); } else if (mediaFocus.compareTo("vnd.android.cursor.item/*") == 0) { if (query.isEmpty()) { // ‘任意’检索模式 playResumeLastPlaylist(); } else { // ‘非结构化’检索模式 playUnstructuredSearch(query); } } else if (mediaFocus.compareTo(MediaStore.Audio.Genres.ENTRY_CONTENT_TYPE) == 0) { // ‘风格’检索模式 playGenre(genre); } else if (mediaFocus.compareTo(MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE) == 0) { // ‘艺术家’检索模式 playArtist(artist, genre); } else if (mediaFocus.compareTo(MediaStore.Audio.Albums.ENTRY_CONTENT_TYPE) == 0) { // ‘专辑’检索模式 playAlbum(album, artist); } else if (mediaFocus.compareTo("vnd.android.cursor.item/audio") == 0) { // ‘歌曲’检索模式 playSong(album, artist, genre, title); } else if (mediaFocus.compareTo(MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE) == 0) { // ‘播放列表’检索模式 playPlaylist(album, artist, genre, playlist, title); } } }
电话
拨打电话
要打开电话应用并拨号,请使用ACTION_DIALaction并使用下面定义的URI
scheme指定电话号码。当电话应用打开时,它已经显示了该电话号码,但是用户必须按下拨号键才会开始拨号。
Google Now
"call 555-5555"
"call bob"
"call voicemail”
要想直接拨打电话,请使用
ACTION_CALLaction并使用下面定义的URI
scheme指定电话号码。 当电话应用打开时,它就直接拨号了,用户不需要再去按拨号键了。
ACTION_CALLaction需要你在你的manifest文件中添加
CALL_PHONE权限:
<uses-permission android:name="android.permission.CALL_PHONE" />
Action
ACTION_DIAL-
打开拨号或电话应用。
ACTION_CALL-
直接拨号(需要
CALL_PHONE权限)
Data URI Scheme
tel:<phone-number>
voicemail:<phone-number>
MIME Type无
合法的电话号码是像the IETF RFC 3966中定义的那样。下面列举一些合法的事例:
tel:2125551212
tel:(212) 555 1212
电话拨号应用擅长规范格式,例如电话号码。所以在Uri.parse()方法中并没有要求使用严格定义的scheme。然而,如果你没有试过某个scheme或者不确定它能否被处理,请换用
Uri.fromParts()。
intent事例:
public void dialPhoneNumber(String phoneNumber) { Intent intent = new Intent(Intent.ACTION_DIAL); intent.setData(Uri.parse("tel:" + phoneNumber)); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
搜索
使用指定应用来搜索
Google Now
"search for cat videos on myvideoapp"
要支持在你应用的上下文里搜索,请像下面的intent filter事例那样在你的应用中使用
SEARCH_ACTIONaction声明intent filter。
Action
"com.google.android.gms.actions.SEARCH_ACTION"支持从Google Now的搜索查询。
Extras
QUERY字符串,包含搜索查询的信息。
intent filter事例:
<activity android:name=".SearchActivity"> <intent-filter> <action android:name="com.google.android.gms.actions.SEARCH_ACTION"/> <category android:name="android.intent.category.DEFAULT"/> </intent-filter> </activity>
执行网络搜索
要使用网络搜索,请使用ACTION_WEB_SEARCHaction并在SearchManager.QUERY extra中指定要搜索的字符串。
Action
ACTION_WEB_SEARCHData URI Scheme无MIME Type无Extras
SearchManager.QUERY要搜索的字符串。
intent事例:
public void searchWeb(String query) { Intent intent = new Intent(Intent.ACTION_SEARCH); intent.putExtra(SearchManager.QUERY, query); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
设置
打开设置中的某个部分
当你的应用需要打开系统设置中的窗口让用户修改的时候,请在intent action中使用对应的action名称打开设置窗口。Action
ACTION_SETTINGS
ACTION_WIRELESS_SETTINGS
ACTION_AIRPLANE_MODE_SETTINGS
ACTION_WIFI_SETTINGS
ACTION_APN_SETTINGS
ACTION_BLUETOOTH_SETTINGS
ACTION_DATE_SETTINGS
ACTION_LOCALE_SETTINGS
ACTION_INPUT_METHOD_SETTINGS
ACTION_DISPLAY_SETTINGS
ACTION_SECURITY_SETTINGS
ACTION_LOCATION_SOURCE_SETTINGS
ACTION_INTERNAL_STORAGE_SETTINGS
ACTION_MEMORY_CARD_SETTINGS
请参阅
Settings文档了解更多可用的设置窗口。
Data URI Scheme无MIME Type无
intent事例:
public void openWifiSettings() { Intent intent = new Intent(Intent.ACTION_WIFI_SETTINGS); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
文本消息
编写带附件的SMS/MMS消息
要编写一条SMS或MMS文本消息,请使用下面其中一种intent action,并使用下面列举的extra键来指定消息细节,例如电话号码、主题、消息内容等。Action
ACTION_SENDTO或
ACTION_SEND或
ACTION_SEND_MULTIPLEData URI Scheme
sms:<phone_number>
smsto:<phone_number>
mms:<phone_number>
mmsto:<phone_number>
这些scheme可以用同样的方式处理。
MIME Type
PLAIN_TEXT_TYPE(
"text/plain")
"image/*"
"video/*"
Extras
"subject"字符串,用做消息主题(通常仅用于MMS)。
"sms_body"字符串,用做文本消息。
EXTRA_STREAM一个指向图片或视频附件的
Uri。如果使用的是
ACTION_SEND_MULTIPLEaction,那么这个extra应该是一个由指向图片/视频的
Uri组成的ArrayList。
intent事例:
public void composeMmsMessage(String message, Uri attachment) { Intent intent = new Intent(Intent.ACTION_SENDTO); intent.setType(HTTP.PLAIN_TEXT_TYPE); intent.putExtra("sms_body", message); intent.putExtra(Intent.EXTRA_STREAM, attachment); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
如果你想确保你的intent只能背文本消息应用处理(而不是其他的邮件或社交应用),那么请使用
ACTION_SENDTOaction并包含
"smsto:"data
scheme。例如:
public void composeMmsMessage(String message, Uri attachment) { Intent intent = new Intent(Intent.ACTION_SEND); intent.setData(Uri.parse("smsto:")); // This ensures only SMS apps respond intent.putExtra("sms_body", message); intent.putExtra(Intent.EXTRA_STREAM, attachment); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.SEND" /> <data android:type="text/plain" /> <data android:type="image/*" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
注意:如果你正在开发一款SMS/MMS消息应用,为了能在Android 4.4或更高版本的平台上作为系统的默认SMS应用,你必须实现针对许多额外action的intent filter。更多信息,请参阅
Telephony。
网络浏览器
加载网络URL
Google Now
"open example.com”
要打开网络页面,请使用
ACTION_VIEWaction并在intent
data中注定网络URL。
Action
ACTION_VIEWData URI Scheme
http:<URL>
https:<URL>MIME Type
PLAIN_TEXT_TYPE(
"text/plain")
"text/html"
"application/xhtml+xml"
"application/vnd.wap.xhtml+xml"
intent事例:
public void openWebPage(String url) { Uri webpage = Uri.parse(url); Intent intent = new Intent(Intent.ACTION_VIEW, webpage); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
intent filter事例:
<activity ...> <intent-filter> <action android:name="android.intent.action.VIEW" /> <!-- 如果你想要你的应用只响应自己域名的URL,只需要把这个域名属性包含进来就可以了。 --> <data android:scheme="http" android:host="www.example.com" /> <category android:name="android.intent.category.DEFAULT" /> <!-- 打开从链接打开网络页面的话,这个BROWSABLE category是必须的。 --> <category android:name="android.intent.category.BROWSABLE" /> </intent-filter> </activity>
提示:如果你的Android应用提供的功能和你的网站差不多,请为指向你网站的URL指定一个intent filter。然后,如果用户安装了你的应用,那么在邮件或其他网页中打开指向你网站站点的超链接时,会直接打开你的Android应用,而不是你的网页。
使用Android Debug Bridge验证intent
要验证你的应用能否响应那些你想要支持的intent,你可以使用adb工具来发出特定的intent:
把Android设备设置为开发者模式(development),或使用虚拟设备(virtual
device)。
安装应用,该版本可以处理你想要支持的intent。
使用
adb发出intent:
adb shell am start -a <ACTION> -t <MIME_TYPE> -d <DATA> \ -e <EXTRA_NAME> <EXTRA_VALUE> -n <ACTIVITY>
例如:
adb shell am start -a android.intent.action.DIAL \ -d tel:555-5555 -n org.example.MyApp/.MyActivity
如果你已经定义了必须的intent filter,那么你的应用应该就能处理到该intent了。
更多信息,请参阅Using activity manager (am)。
Google Now发出的intent
Google Now可以辨识出许多语音命令并为它们发出对应的intent。像这样,如果你的应用声明了相应的intent filter,用户就能通过Google Now语音命令来启动你的应用了。例如,如果你的引用可以设置闹钟(setan alarm)并且你在manifest文件中添加了相应的intent filter,那么当用户需要设置闹钟时,Google Now就能让用户选择你的应用了,如图1所示。
图1. Google Now让用户从支持给定action的已安装应用里挑选。
Google Now识别针对表1所列举的action的语音命令。更多关于每种intent filter声明的信息,请点击相关action描述。
表1. Google Now可以识别的语音命令(Google Search应用v3.6).
类别 | 详情和事例 | Action名称 |
---|---|---|
闹钟 | Set alarm(设置闹钟) "set an alarm for 7 am" | AlarmClock.ACTION_SET_ALARM |
Set timer(设置时间) "set a timer for 5 minutes" | AlarmClock.ACTION_SET_TIMER | |
联系 | Call a number(拨号) "call 555-5555" "call bob" "call voicemail" | Intent.ACTION_CALL |
健康 | Start/stop a bike ride(开始/结束骑单车) "start cycling" "start my bike ride" "stop cycling" | FitnessIntents.ACTION_TRACK |
Start/stop a run(开始/结束跑步) "track my run" "start running" "stop running" | FitnessIntents.ACTION_TRACK | |
Start/stop a workout(开始/结束锻炼) "start a workout" "track my workout" "stop workout" | FitnessIntents.ACTION_TRACK | |
Show heart rate(显示心率) "what's my heart rate" "what's my bpm" | FitnessIntents.ACTION_VIEW | |
Show step count(显示步数) "how many steps have I taken" "what's my step count" | FitnessIntents.ACTION_VIEW | |
本地 | Book a car(叫车) "call me a car" "book me a taxi" | ReserveIntents .ACTION_RESERVE_TAXI_RESERVATION |
媒体 | Play music from search(搜索并播放音乐) "play michael jackson billie jean" | MediaStore .INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH |
Take a picture(拍照) "take a picture" | MediaStore .INTENT_ACTION_STILL_IMAGE_CAMERA | |
Record a video(录视频) "record a video" | MediaStore .INTENT_ACTION_VIDEO_CAMERA | |
搜索 | Search using a specific app(使用指定应用搜索) "search for cat videos on myvideoapp" | "com.google.android.gms.actions .SEARCH_ACTION" |
网络浏览器 | Open URL(打开URL) "open example.com" | Intent.ACTION_VIEW |
相关文章推荐
- android 代码实现控件之间的间距
- android FragmentPagerAdapter的“标准”配置
- Android"解决"onTouch和onClick的冲突问题
- android:installLocation简析
- 解決Linux下Android开发真机调试设备不被识别问题
- [Android]在代码里运行另一个程序的方法
- [软件咨询]WPS2012正式版已发布 金山Office移动版4.0发布
- Android笔记-Linux Kernel Ftrace (Function Trace)解析
- 一个小型js框架myJSFrame附API使用帮助
- 详细分析交换机、路由器、集线器的区别和联系
- 批处理的api WMIC学习体会有感第1/2页
- 批处理 API实现文件下载的代码第1/2页
- 强制删除工具 xdelbox xdelbox1.5正式版下载
- 揪出交换机端口背后“凶手”导致网速太慢
- 电脑重启后突然检测不到硬盘的原因分析与解决办法
- PQ分区出错! 巧用Ghost急速补救的绝妙办法
- android USB如何修改VID具体实现
- Android增量升级的方法和原理详细介绍
- Android Mouse实现过程详细笔记
- 深入Android Browser配置管理的详解