Android开发-API指南-常用Intent原创译文 网络原创文学写作指南

Common Intents

英文原文:http://developer.android.com/guide/components/intents-common.html
采集(更新)日期:2014-7-16

在本文中

  1. 闹钟
    1. 创建闹钟
    2. 创建计时器
    3. 显示所有闹钟
  2. 日历
    1. 添加日历事件
  3. 摄像头
    1. 拍照或摄像并返回结果
  4. 通讯录/联系人应用
    1. 选择联系人
    2. 选择联系人的指定信息
    3. 查看联系人
    4. 编辑已有联系人
    5. 添加联系人
  5. Email
    1. 撰写可带附件的邮件
  6. 文件存储
    1. 查找某类文件
    2. 打开某类文件
  7. 地图
    1. 在地图上显式地理位置
  8. 音乐和视频
    1. 播放音频文件
    2. 根据检索请求播放音乐
  9. 电话
    1. 拨打电话
  10. 设置
    1. 打开系统设置中的某个项目
  11. 文字短信
    1. 撰写带附件的SMS/MMS 信息
  12. Web 浏览器
    1. 载入 WebURL
    2. 执行 Web搜索

参阅

  1. Intent 和Intent 过滤器

通过 Intent 可以启动其他应用程序中的 Activity ,只要在此 Intent 对象中给出需要执行的操作即可(比如“查看地图”或“拍照”)。由于这里未指定需要启动的组件,而只是给出了 Action 和执行 Action 所用到的 数据,这种 Intent 就被称为隐式 Intent。

在把隐式 Intent 作为参数调用 startActivity()startActivityForResult() 时,系统会 解析该Intent 并发送给能够处理该 Intent 的应用程序,并启动相应的 Activity。如果能够处理该 Intent 的应用程序超过一个,系统会给出对话框供用户选择。

本文介绍了多个用于执行常见 Action 的隐式 Intent,并按照处理这些 Intent 的应用程序进行了归类。每个章节还介绍了如何通过创建 Intent过滤器 来对应用程序的 Action 处理能力进行公布。

提醒: 如果当前设备上不存在可接收某种隐式 Intent 的应用程序,则调用startActivity() 的应用程序将会崩溃。 为了预先判断一下是否存在可接收 Intent的应用程序,请调用 Intent 对象的 resolveActivity()。 如果结果非空,则表示至少存在一个可处理该 Intent的应用程序,并且可安全调用 startActivity()。 如果结果为 null ,请勿再使用该 Intent,并尽可能关闭那些会发起该Intent 的功能。

如果还不清楚 Intent 和 Intent 过滤器的创建过程,请先去阅读 Intent 和Intent 过滤器。

闹钟


创建闹钟

要新建一个闹钟,请使用ACTION_SET_ALARM并设置闹钟的详细参数,包括在 Intent 的附件(extra)中给出时间和文字信息,如下所示。

注意: 在 Android 2.3 (API 级别 9)版本中,附件里只能包含小时、分钟和文字信息。其他类型的附件是在后续版本的系统中加入的。

Action
ACTION_SET_ALARM
数据 URI
MIME 类型
附件
EXTRA_HOUR
闹钟的小时数。
EXTRA_MINUTES
闹钟的分钟数
EXTRA_MESSAGE
用于标识闹钟的文字信息。
EXTRA_DAYS
一个 ArrayList对象, 存放了本闹钟需要在每周的星期几重复触发。 每一天用 Calendar类中定义的整数值来表示,比如 MONDAY

如果是一次性的闹钟,请勿给出该附件。

EXTRA_RINGTONE
一个 content: URI ,用于指定闹钟所用的铃声。 如果不需要铃声则为VALUE_RINGTONE_SILENT

如果要使用默认的铃声,就不需要指定本附件。

EXTRA_VIBRATE
布尔值,指明闹钟是否需要振动。
EXTRA_SKIP_UI
布尔值,指明应用程序在设定闹钟时是否要跳过用户交互过程。 如果设为 True,则应用程序将会跳过所有的确认界面,直接设定所需的闹钟。

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_ALARM Intent,应用程序必须拥有 SET_ALARM 权限:

< uses-permission android:name="com.android.alarm.permission.SET_ALARM" / > 

Intent 过滤器示例:

< activity ... >  
< intent-filter >
< action android:name="android.intent.action.SET_ALARM" / >
< category android:name="android.intent.category.DEFAULT" / >
< /intent-filter >
< /activity >

创建计时器

要创建一个倒计时的计时器,请使用 ACTION_SET_TIMER 并在附件中设定计时器的详细参数,比如时长,如下所示。

注意:本 Intent 自 Android 4.4 (API 级别 19)开始引入。

Action
ACTION_SET_TIMER
数据 URI
MIME 类型
附件
EXTRA_LENGTH
计时器的时长,单位为秒。
EXTRA_MESSAGE
用于标识该计时器的自定义文字信息。
EXTRA_SKIP_UI
布尔值,指明应用程序在设定计时器时是否要跳过用户交互过程。 如果设为 True,则应用程序将会跳过所有的确认界面,直接设定所需的计时器。

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_TIMER Intent ,应用程序必须拥有 SET_ALARM 权限:

< uses-permission android:name="com.android.alarm.permission.SET_ALARM" / > 

Intent 过滤器示例:

< activity ... >  
< intent-filter >
< action android:name="android.intent.action.SET_TIMER" / >
< category android:name="android.intent.category.DEFAULT" / >
< /intent-filter >
< /activity >

列出所有闹钟

要显示所有闹钟的列表,请使用 ACTION_SHOW_ALARMS

虽然用到本 Intent 的应用程序应该不会很多(主要用于系统应用), 所有当作闹钟使用的应用程序都必须实现本 Intent过滤器,以便能列出当前所有的闹钟。

注意: 本 Intent 自 Android 4.4 (API 级别 19)开始引入。

Action
ACTION_SHOW_ALARMS
数据 URI
MIME 类型

Intent 过滤器示例:

< activity ... >  
< intent-filter >
< action android:name="android.intent.action.SHOW_ALARMS" / >
< category android:name="android.intent.category.DEFAULT" / >
< /intent-filter >
< /activity >

Calendar


添加日历事件

为了在用户的日历中加入一个新事件,请使用 ACTION_INSERT 并用 Events.CONTENT_URI 指定数据 URI 。还可以在附件中设定事件的各种细节参数,如下所示。

Action
ACTION_INSERT
数据 URI
Events.CONTENT_URI
MIME 类型
"vnd.android.cursor.dir/event"
附件
EXTRA_EVENT_ALL_DAY
布尔值,指明是否为全天性事件。
EXTRA_EVENT_BEGIN_TIME
事件的起始时间(自公元纪年开始的毫秒数)。
EXTRA_EVENT_END_TIME
事件的终止时间(自公元纪年开始的毫秒数)。
TITLE
事件的标题。
DESCRIPTION
事件的说明。
EVENT_LOCATION
事件的地点。
EXTRA_EMAIL
受邀者的 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 过滤器示例:

< 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_CAPTUREACTION_VIDEO_CAPTURE 。 并且在附件 EXTRA_OUTPUT 中,还需要指定照片或视频的保存位置 URI 。

Action
ACTION_IMAGE_CAPTURE
ACTION_VIDEO_CAPTURE
数据 URI Scheme
MIME 类型
附件
EXTRA_OUTPUT
摄像头应用将把照片或视频文件保存到 URI 指定的位置 (以 Uri对象的方式给出)。

一旦摄像头应用成功返回到调用 Activity (应用程序收到 onActivityResult() 回调方法),就可以在由 EXTRA_OUTPUT 值指定的 URI 位置访问到照片或视频文件。

注意: 当使用 ACTION_IMAGE_CAPTURE 拍照时,摄像头可以在结果 Intent 中同时返回一张小尺寸的缩略图,位于附件中的“data”字段中,格式为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);
}
}

Android开发-API指南-常用Intent[原创译文] 网络原创文学写作指南
@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,请参阅 拍照初步和 摄像初步。

Intent 过滤器:

< 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_OUTPUT ,然后把捕获到的图像或视频保存到该其指定的位置,并用包含了缩略图的Intent 调用 setResult() ,缩略图数据应存放在 Intent 附件的“data”部分。

通讯录/联系人应用


选择联系人

要让用户选择联系人并访问其所有数据,请使用 ACTION_PICK ,并把 MIME 类型设定为 Contacts.CONTENT_TYPE

在传给回调方法 onActivityResult() 的结果 Intent 中,包含了指向所选的联系人数据的 content: URI 。这时还向调用方应用临时授予读取通讯录的权限,这是通过 Contacts Provider API 来完成的,即使该应用没有包含 READ_CONTACTS 权限也没有关系。

提示: 如果只需要访问联系人的部分信息,比如电话号码或 Email 地址,请参阅下一章节选择联系人的指定信息。

Action
ACTION_PICK
数据 URI Scheme
MIME 类型
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 之后,如何读取联系人详细数据的详细内容,请参阅 读取联系人详细数据。 请记住,用上述 Intent 访问联系人 URI时,读取详细信息是不需要 READ_CONTACTS 权限的。

选择联系人的指定信息

为了能让用户选择联系人的部分信息,比如电话、Email 地址或其他数据,请使用 ACTION_PICK ,并指定下述的数据 MIME 类型,比如 CommonDataKinds.Phone.CONTENT_TYPE 就是用于获取联系人电话号码的。

如果只需要从通讯录中读取某一类数据,则用 ContactsContract.CommonDataKinds 类中定义的CONTENT_TYPE 会比上一节提到的 Contacts.CONTENT_TYPE 效率更高,因为返回的结果直接就是目标数据,不需要再在Contacts Provider 上执行更复杂的查询。

在传给回调方法 onActivityResult() 的结果 Intent 中,包含了指向所选的联系人数据的 content: URI 。这时还向调用方应用临时授予读取通讯录的权限,即使该应用没有包含 READ_CONTACTS 权限也没有关系。

Action
ACTION_PICK
数据 URI Scheme
MIME 类型
CommonDataKinds.Phone.CONTENT_TYPE
读取联系人电话号码。
CommonDataKinds.Email.CONTENT_TYPE
读取联系人 email 地址。
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);
}
}

@Override
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_VIEW ,同时在 Intent 的数据部分中用 content:指定联系人。

获得联系人 URI 的方法主要有两种:

Action
ACTION_VIEW
数据 URI Scheme
content: < URI >
MIME 类型
无。类型可由联系人的 URI 得出。

Intent 示例:

public void viewContact(Uri contactUri) { 
Intent intent = new Intent(Intent.ACTION_VIEW, contactUri);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}

编辑已有联系人

要编辑已有联系人,请使用 ACTION_EDIT ,在 Intent 的数据部分用 content: 指定content: URI , 在 Intent 的附件部分用 ContactsContract.Intents.Insert 定义的常量给出已知联系人的信息。

获得联系人 URI 的方式主要有两种:

Action
ACTION_EDIT
数据 URI Scheme
content: < URI >
MIME 类型
从联系人 URI 中得出。
附件
ContactsContract.Intents.Insert中给出了很多附件常量的定义,可用来声明联系人信息的各个字段。

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

关于编辑联系人的更多信息,请参阅 利用 Intent 修改通讯录。

添加联系人

要添加一个新的联系人,请使用 ACTION_INSERT ,用 Contacts.CONTENT_TYPE 指定 MIME 类型,在附件部分用 ContactsContract.Intents.Insert 中定义的常量指定已知的联系人信息。

Action
ACTION_INSERT
数据 URI Scheme
MIME 类型
Contacts.CONTENT_TYPE
附件
一个或多个由 ContactsContract.Intents.Insert 定义的附件数据。

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

关于添加联系人的更多信息,请参阅 利用 Intent 修改通讯录。

Email


撰写可带附件的 Email

要撰写一封 Email,请根据是否包含邮件附件来选用一种下述的 Action , 并且在 Intent 附件中用下述键值给出Email 的详细信息,比如收件人和主题等。

Action
ACTION_SENDTO (不带邮件附件时)或
ACTION_SEND (带有一个邮件附件时)或
ACTION_SEND_MULTIPLE (带有多个邮件附件时)
数据 URI Scheme
MIME 类型
PLAIN_TEXT_TYPE ("text/plain")
"**");
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);
}
}
如果要确保仅能由 Email 应用来处理 Intent (不允许其他文字信息或社交类应用进行处理), 请使用
ACTION_SENDTO ,并将数据 URI Scheme 给定为"mailto:"。例如:

public void composeEmail(String[] addresses, String subject) { 
Intent intent = new Intent(Intent.ACTION_SENDTO);
intent.setData(Uri.parse("mailto:")); // 只允许 Email 应用来处理
intent.putExtra(Intent.EXTRA_EMAIL, addresses);
intent.putExtra(Intent.EXTRA_SUBJECT, subject);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}

Intent 过滤器示例:

< activity ... >  
< intent-filter >
< action android:name="android.intent.action.SEND" / >
< data android:type="**”。
Action
ACTION_OPEN_DOCUMENT
ACTION_CREATE_DOCUMENT
数据 URI Scheme
MIME 类型
MIME 类型与用户选择的文件类型相对应。
附件
EXTRA_MIME_TYPES
MIME 类型的数组,对应于应用程序需要的文件类型。 如果使用了该附件数据,就必须把主 MIME 类型用setType() 设为 “*/*”。
EXTRA_ALLOW_MULTIPLE
布尔值,标明用户是否可以一次选取多个文件。
EXTRA_TITLE
使用 ACTION_CREATE_DOCUMENT 时用来指定初始文件名称。
EXTRA_LOCAL_ONLY
布尔值,标明返回的文件是否可从设备直接访问,而不需要从远程服务中下载。
类型
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);
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == REQUEST_IMAGE_OPEN && resultCode == RESULT_OK) {
Uri fullPhotoUri = data.getData();
// 用 fullPhotoUri 中的全尺寸图片文件执行某些操作
...
}
}

其实,第三方应用无法真正响应 Action 为ACTION_OPEN_DOCUMENT的 Intent 。而是由系统接收此类 Intent ,并在统一的用户界面中显示来自各个应用的所有可用文件。
为了能在这个系统界面中显示出文件,并允许其他应用程序打开这些文件,应用程序必须实现一个DocumentsProvider对象,其中包含了PROVIDER_INTERFACEIntent 过滤器("android.content.action.DOCUMENTS_PROVIDER")。例如:
< 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 >

关于如何让自己的文件可以被其他应用程序打开的更多信息,请参阅存储访问架构指南。

地图


在地图上显示地理位置


要打开地图,请使用ACTION_VIEW并在 Intent 数据部分给出位置信息,数据的 Scheme 在下述内容中选取一个。
Action
ACTION_VIEW
数据 URI Scheme
geo:latitude,longitude
显示指定经纬度位置的地图。

例如"geo:47.6,-122.3"

geo:latitude,longitude?z=zoom
以某个缩放级别显示给定经纬度位置的地图。 放大级别为 1 表示整个地球,以给定的latlng 为中心。 最高(最大)的放大级别为 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,+CA"

注意: geo URI 中的所有字符串必须经过转码。 例如,字符串1st & Pike, Seattle 应该写为 1st & Pike,Seattle。 字符串中的空格可以用 转码,也可以用加号代替(+)。

MIME 类型

Intent 示例:
public void showMap(Uri geoLocation) { 
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(geoLocation);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}

Intent 过滤器示例:
< 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_VIEW并在 Intent 数据部分指定文件的 URI 位置。
Action
ACTION_VIEW
数据 URI Scheme
file: < URI >
content: < URI >
http: < URL >
MIME 类型
"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 过滤器示例:
< 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 >

根据搜索请求播放音频


要根据搜索请求播放音频,请使用INTENT_ACTION_MEDIA_PLAY_FROM_SEARCHIntent。在响应用户的语音命令来播放音乐时,应用程序就可以触发该类 Intent。接收本 Intent 的应用程序会在其音乐库中进行检索,如果找到匹配的内容就会开始播放。
本类 Intent 应该包含字符串型的附件EXTRA_MEDIA_FOCUS,用于指定检索模式。例如,可以指定检索艺术家名字还是歌名。
Action
INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH
数据 URI Scheme
MIME 类型
附件
MediaStore.EXTRA_MEDIA_FOCUS (必填项)

指明检索模式(用户是否要查找特定的艺术家、专辑、播放列表或广播频道)。 大部分检索模式都需要给出额外的附件数据。例如:如果用户对某首歌感兴趣, Intent 就可能包含三部分额外附件数据:歌名、艺术家和专辑名。 利用 EXTRA_MEDIA_FOCUS 键值,本 Intent 可提供以下检索模式:

任意"vnd.android.cursor.item/*"

播放任何音乐。 接收方应用将会智能选择要播放的音乐,比如用户最后一次听过的播放列表。

额外附件数据:

非结构化"vnd.android.cursor.item/*"

根据一个非结构化的检索请求播放特定的歌曲、专辑或某风格的音乐。如果应用程序无法辨识用户需要的音乐类型,那就可以用这种搜索模式创建 Intent 。当然,应用程序还是应该尽可能地使用更为确切的检索模式。

额外附件数据:

风格 - Audio.Genres.ENTRY_CONTENT_TYPE

播放指定风格的音乐。

额外附件数据:

艺术家Audio.Artists.ENTRY_CONTENT_TYPE

播放指定艺术家的音乐。

额外附件数据:

专辑 - Audio.Albums.ENTRY_CONTENT_TYPE

播放指定专辑。

额外附件数据:

歌曲名称"vnd.android.cursor.item/audio"

播放指定歌曲。

额外附件数据:

广播频道"vnd.android.cursor.item/radio"

播放指定频道广播或者匹配附件数据给定规则的频道。

额外附件数据:

播放列表Audio.Playlists.ENTRY_CONTENT_TYPE

播放指定列表或匹配附件数据给定规则的列表。

额外附件数据:


Intent 示例:
如果用户需要收听正在播放指定艺术家歌曲的广播电台,检索应用程序就可以创建以下 Intent:
public void playSearchRadioByArtist(String artist) { 
Intent intent = new Intent(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH);
intent.putExtra(MediaStore.EXTRA_MEDIA_FOCUS,
"vnd.android.cursor.item/radio");
intent.putExtra(MediaStore.EXTRA_MEDIA_ARTIST, artist);
intent.putExtra(SearchManager.QUERY, artist);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}

Intent 过滤器示例:
< 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。一旦 Activity 识别出了检索模式,就应该读取该模式下的额外附件数据。利用这些信息,应用程序就可以在自己的曲库中查找并播放符合要求的音乐。例如:
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);

// 根据检索模式的不同,有些附件数据可能不可用
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 rchannel = intent.getStringExtra("android.intent.extra.radio_channel");
String title = intent.getStringExtra(MediaStore.EXTRA_MEDIA_TITLE);

// 检测搜索模式并采用相应的附件数据
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("vnd.android.cursor.item/radio") == 0) {
// “广播频道” 检索模式
playRadioChannel(album, artist, genre, rchannel, title);

} else if (mediaFocus.compareTo(MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE) == 0) {
// “播放列表” 检索模式
playPlaylist(album, artist, genre, playlist, title);
}
}
}

电话


拨打电话


要打开电话应用并拨打一个电话号码,请使用ACTION_DIAL并用下述的 URI Scheme 给出电话号码。电话应用在打开时会显示这个号码,但用户必须按下Call按钮(译者注:大部分手机的“拨打”键都是个话机图标)才会开始拨打电话。
Action
ACTION_DIAL
数据 URI Scheme
tel: < phone-number >
MIME 类型

合法的电话号码由the IETF RFC 3966标准定义。示例如下:

拨号应用对于电话号码的格式识别已经很完美了。因此在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);
}
}

设置


打开系统设置中的某个项目


如果要让用户修改某些设置,就要打开系统设置中的对应窗口,请使用以下 Action 的 Intent 来完成, 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

关于其他设置窗口对应的 Action,请参阅 设置 文档。

数据 URI Scheme
MIME 类型

Intent 示例:
public void openWifiSettings() { 
Intent intent = new Intent(Intent.ACTION_WIFI_SETTINGS);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}

文字短消息


撰写带有附件的 SMS/MMS 消息


要新建一条 SMS 或 MMS 消息,请使用以下 Action 的 Intent ,并利用下述的附件键值给出短消息的细节,比如电话号码、主题、消息内容等。
Action
ACTION_SENDTO
ACTION_SEND
ACTION_SEND_MULTIPLE
数据 URI Scheme
sms: < phone_number >
smsto: < phone_number >
mms: < phone_number >
mmsto: < phone_number >

这些 Scheme 是同时处理的。

MIME 类型
PLAIN_TEXT_TYPE"text/plain"
"image/*"
"video/*"
附件
"subject"
用作短信主题的字符串(通常仅用于 MMS)。
"sms_body"
用作短信内容的字符串。
EXTRA_STREAM
指向图片或视频附件的 Uri。如果使用 ACTION_SEND_MULTIPLE ,则本 Intent 附件应该是一个由指向图片、视频的Uri组成的 ArrayList

Intent 示例:
public void composeMmsMessage(String message, Uri attachment) { 
Intent intent = new Intent(Intent.ACTION_SEND);
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 只允许由短信应用(而不是其他 Email 或社交类应用)进行处理,请使用ACTION_SENDTO并将数据 Scheme 给定为 “smsto:” 。例如:
public void composeMmsMessage(String message, Uri attachment) { 
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setData(Uri.parse("smsto:")); // 这就确保只有 SMS 应用才能响应
intent.putExtra("sms_body", message);
intent.putExtra(Intent.EXTRA_STREAM, attachment);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}

Intent 过滤器示例:
< 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 过滤器。详情请参阅文档Telephony

Web 浏览器


载入 Web URL


要打开一个网页,请使用ACTION_VIEW并在 Intent 数据部分指定 Web URL。
Action
ACTION_VIEW
数据 URI Scheme
http: < URL >
https: < URL >
MIME 类型
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 过滤器示例:
< activity ... >  
< intent-filter >
< action android:name="android.intent.action.VIEW" / >
< !-- Include the host attribute if you want your app to respond
only to URLs with your app's domain. -- >
< data android:scheme="http" android:host="www.example.com" / >
< category android:name="android.intent.category.DEFAULT" / >
< !-- The BROWSABLE category is required to get links from web pages. -- >
< category android:name="android.intent.category.BROWSABLE" / >
< /intent-filter >
< /activity >

提示:如果你的 Android 应用的功能与你的 Web 网站类似,请为指向你的网站的 URL 声明一条 Intent 过滤器。这样,如果用户已经安装了你的应用,则在邮件或其他网页中点击你的网站链接,就会直接打开你的 Android 应用,而不是你的网站。

执行 Web 搜索


要启动一次 Web 搜索,请使用ACTION_WEB_SEARCH并在附件SearchManager.QUERY中指定搜索字符串。
Action
ACTION_WEB_SEARCH
数据 URI Scheme
MIME 类型
附件
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);
}
}

  

爱华网本文地址 » http://www.aihuau.com/a/25101012/126474.html

更多阅读

android开发工程师的工资待遇如何 测试开发工程师待遇

?行业薪酬的影响因素包括行业内、外部因素及员工个人的因素,同样,在IT行业中,要想了解android开发工程师的薪资待遇情况如何,我们也可以从这几个因素入手,加以了解。首先,企业自身的状况如何直接影响到员工的工资水平如何。企业负担能力

Android安卓开发环境搭建详细教程 android开发环境搭建

Android安卓开发环境搭建详细教程——简介注:本教程是讲解在Windows XP下搭建安卓开发环境的。安装目录:步骤1 安装JDK步骤2 安装 Android SDK步骤3 安装Tomcat步骤4 安装Ant步骤5 安装Eclipse步骤6 安装Eclipse的ADT插件步骤7 在图形

细致完整的Android开发环境搭建教程 android源码环境搭建

??????? 相信学习Android开发的程序猿们都晓得,?首先就是android开发环境搭建。这一课说起来简单,但是对不少Android开发入门的小白来说还是一个难点,在安卓环境搭建过程中会遇到各种各样的问题,今天就来为大家汇总归纳关于android

OA系统开发设计原则 android开发设计原则

OA系统开发设计原则——简介 市场上的标准软件已经不适合企业发展,不能满足企业的要求,这时企业就需要找软件开发商来定制开发软件,那么定制软件中,软件开发商要注意的几个主流的设计原则,伟创软件是国内第一家全息智能信息系统服务商,以

声明:《Android开发-API指南-常用Intent原创译文 网络原创文学写作指南》为网友树深时见鹿分享!如侵犯到您的合法权益请联系我们删除