让你的Android应用与外部元素互动起来

一个Android应用程序通常有几个activities。每个act显示一个用户接口允许用户执行一个指定的任务。用户从一个act到另一个act,你的App必须使用一个Intent对象来定义你App想做些什么事。当你通过一个Intent调用startActivity()方法时,系统会使用Intent来鉴定和启动合适的App组件。一个Intent可以明确的启动一个特定的组件(如一个特定的act实例)或隐式启动任何可以处理预定动作的组件,本章我们将讲述怎么使用Intent来执行与其他Apps的一些交互,例如启动另一个App,从那个App接收结果。并使你的应用程序能够响应来自其他App的intents。
1发送用户到另一个App Android最重要的一个特性之一就是发送用户到另一个App并基于“动作”来执行它的能力。例如,如果你的app有商业地址想要显示在地图上,你不得不在你的App中新建一个activity来显示地图。其实更好的办法是使用Intent发送一个查看地图的外部请求。Android系统会启动那个能查看地址的App。通常,我们使用一个明确的Intent,它定义的明确的类名。然而,当你想有一个单独的应用程序执行时,如“查看地图”,你必须使用一个隐式的Intent。本节讲述如何为一个特定的动作创建隐含的意图,以及怎样用它来启动执行另一个应用程序中的Activity。
1.1构建一个隐式的Intent 隐式intents不用申明启动组件的类名,但需要申明执行的动作。动作指定你想要做的事情,如view(查看),edit(编辑),send(发送)或获得某事物。Intents经常包托一些与动作相关联的税局,如你想要查看的地址,或者你想要发送的email信息。这取决于你想要创建的Intent所发送的数据,数据可能是一个Uri或intent根本不需要数据也能发送。
使用Uri数据拨打电话:

[java] view plaincopyprint?

1. Uri number = Uri.parse(“tel:5551234”);
2. Intent callIntent = new Intent(Intent.ACTION_DIAL, number);

当你的app通过startActivity()调用intent时,电话app根据给定的电话号码发起呼叫。
查看一个地图:

[java] view plaincopyprint?

1. // 基于地址的地图点
2. Uri location = Uri.parse(“geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California”);
3. // 或基于经纬度的地图点
4. // Uri location = Uri.parse(“geo:37.422219,-122.08364?z=14”); // z参数表示缩放级别
5. Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

查看一个web页面:

[java] view plaincopyprint?

1. Uri webpage = Uri.parse(“http://www.android.com”);
2. Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);

其他种类的隐式intents需要”extra”数据来提供不同的数据类型,如一个字符串。你能使用putExtra()方法来添加一个或更多extra 数据。默认的,系统通过基于Uri的intent来确定适当的MIME(Multipurpose Internet Mail Extensions)类型。如果你在intent中不包含一个Uri,你应该使用setType()来指定intent相关联的数据类型。设置MIME类型来进一步指定activities将要接收的intent类型。
发送带有附件的电子邮件:

[java] view plaincopyprint?

1. Intent emailIntent = new Intent(Intent.ACTION_SEND);
2. //没有Uri的intent,所以需要声明”text/plain”的MIME类型
3. emailIntent.setType(HTTP.PLAIN_TEXT_TYPE);
4. emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {“jon@example.com”}); // 收件人
5. emailIntent.putExtra(Intent.EXTRA_SUBJECT, “Email subject”);
6. emailIntent.putExtra(Intent.EXTRA_TEXT, “Email message text”);
7. emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse(“content://path/to/email/attachment”));

创建一个日历事件:

[java] view plaincopyprint?

1. Intent calendarIntent = new Intent(Intent.ACTION_INSERT, Events.CONTENT_URI);
2. Calendar beginTime = Calendar.getInstance().set(2012, 0, 19, 7, 30);
3. Calendar endTime = Calendar.getInstance().set(2012, 0, 19, 10, 30);
4. calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.getTimeInMillis());
5. calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.getTimeInMillis());
6. calendarIntent.putExtra(Events.TITLE, “Ninja class”);
7. calendarIntent.putExtra(Events.EVENT_LOCATION, “Secret dojo”);

注意: 对于日历事件的intent只在API Level或更高版本下才支持。
1.2验证一个App接收的Intent 我们总是应该在调用一个intent之前先包含一个验证。这是一个好的习惯,因为如果你在app中调用intent后,如果没有可用的设备,那么你的app会崩溃.为了验证那个activity可用,我们可以调用queryIntentActivities()来获得一个list,如果返回的List不为空,那么你能安全的使用intent。

[java] view plaincopyprint?

1. PackageManager packageManager = getPackageManager();
2. List activities = packageManager.queryIntentActivities(intent, 0);
3. boolean isIntentSafe = activities.size() > 0;

如isIntentSafe为true,那么表示至少有一个app能响应我们的intent。如果false,表示没有一个app能处理这个intent。
1.3使用Intent启动一个Activity 你可以创建intent并设置extra的信息,然后调用startActivity()。如果系统识别有多个activity能处理这个intent,那么它会显示一个对话框让你自主选择。如果只有一个activity的话,系统会立即启动这个activity。

让我们看看如下的代码,看它是怎么启动activity的:

[java] view plaincopyprint?

1. // 构建intent
2. Uri location = Uri.parse(“geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California”);
3. Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);
4. // 验证上面的mapIntent
5. PackageManager packageManager = getPackageManager();
6. List activities = packageManager.queryIntentActivities(mapIntent, 0);
7. boolean isIntentSafe = activities.size() > 0;
8. // 如果它是安全的就启动这个activity
9. if (isIntentSafe) {
10. startActivity(mapIntent);
11. }

1.4显示APP选择器 注意当你通过intent使用startActivity()启动activity时,如果有多个app响应,如果多个应用可以处理我们的操作,并且用户可能想要每次启动不同的app,比如一个”分享”的动作,分享的渠道可能有多个app组成,这样用户每次可能使用不同的app。那么我们可以使用createChooser()来创建显示选择器。

[java] view plaincopyprint?

1. Intent intent = new Intent(Intent.ACTION_SEND);
2. …
3. // 用于标题的文本资源例如”Share this photo with”
4. String title = getResources().getText(R.string.chooser_title);
5. // 创建并启动chooser
6. Intent chooser = Intent.createChooser(intent, title);
7. startActivity(chooser);

2从Activity获得结果 启动另一个activity并不一定是单向的。我们还可以启动另一个activity,并接收返回结果.。如果需要接收返回结果,我们可以使用startActivityForResult()。L例如。你的应用启动一个摄像机app并接收拍摄照片的结果。当然,获得响应的activity必须被设计为返回一个结果,当它这么做时,它发送一个intent对象的结果。你的activity在onActivityResult()回调方法中会接收到这个intent。虽然我们可以使用明确的和隐式的intent,但这里实际建议你应该使用一个明确的intent,以确保收到了预期的结果。
2.1启动Activity 使用startActivityForResult()方法,需要传递一个额外的int参数。Int参数的意思为”request code”,就是标识一个请求。当收到intent结果时,回调提供了相同的请求的代码,使应用程序可以正确识别结果,并决定如何处理它。
如何启动一个activity并允许用户选择一个联系人:

[java] view plaincopyprint?

1. static final int PICK_CONTACT_REQUEST = 1; // request code
2. …
3. private void pickContact() {
4. Intent pickContactIntent = new Intent(Intent.ACTION_PICK, new Uri(“content://contacts”));
5. pickContactIntent.setType(Phone.CONTENT_TYPE);
6. startActivityForResult(pickContactIntent, PICK_CONTACT_REQUEST);
7. }

2.2接收一个结果
[java] view plaincopyprint?

1. @Override
2. protected void onActivityResult(int requestCode, int resultCode, Intent data) {
3. // 检查响应的请求
4. if (requestCode == PICK_CONTACT_REQUEST) {
5. // 确保请求是成功的
6. if (resultCode == RESULT_OK) {
7. // Do something…
8. }
9. }
10. }

为了成功地处理结果,你必须明白,intent结果的格式将是什么。例如,People app(早些版本叫Contacts app)始终用content URI返回结果并识别被选择的联系人,Camera app在返回一个Bitmap。
将上面的代码扩展一下,让我们看下怎样读取联系人数据:

[java] view plaincopyprint?

1. @Override
2. protected void onActivityResult(int requestCode, int resultCode, Intent data) {
3. //检查响应的请求
4. if (requestCode == PICK_CONTACT_REQUEST) {
5. //确保请求是成功的
6. if (resultCode == RESULT_OK) {
7. // 获得指向选定联系人的URI
8. Uri contactUri = data.getData();
9. //我们只需要号码(NUMBER)列
10. String[] projection = {Phone.NUMBER};
11.
12. // 在联系人中执行查询,获得NUMBER column
13. // 我们不需要挑选或排序
14. // 提示: query()方法应该在单独的线程执行,避免阻塞UI线程
15. // 考虑使用CursorLoader 执行查询
16. Cursor cursor = getContentResolver()
17. .query(contactUri, projection, null, null, null);
18. cursor.moveToFirst();
19.
20. // 从NUMBER column中检索电话号码
21. int column = cursor.getColumnIndex(Phone.NUMBER);
22. String number = cursor.getString(column);
23.
24. // 使用电话号码做些事情
25. }
26. }
27. }

注意:Android 2.3 (API level 9)以前,在Contacts Provider执行一个查询需要申明READ_CONTACTS权限,虽然在2.3开始有一个临时的权限可以让你去读取Contacts Provider,但依旧不能查询。所以不管什么版本我们都申明READ_CONTACTS权限即可。
3允许其他Apps启动你的Activity 在android平台上,如果你要集成facebook的社交功能,那么你可以使用facebokk提供的一个apk,里面集成了facebook的众多功能,如分享信息照片等。在实际开发过程中,可能我们需要开发这样的一个类似的apk,别担心,android提供这样的功能并且很容易实现。
3.1添加一个Intent Filter 我们需要正确的定义intents,让activity能更好的处理。每一个intent filter应该添加具体的action类型和数据类型。系统可能会发送一个给定的intent到一个activity,如果activity有一个intent filter并符合下列条件的intent对象:
Action
一个用来执行动作的字符串名字。例如ACTION_SEND或ACTION_VIEW。在intent filter中的节点指定它。必须是全称,不能使用API常量。
Data
相关的intent中数据的描述。在intent filter中的节点指定它。在这个节点中使用一个或多个属性,你能指定MIME类型,一个URI前缀,一个URI组合,或者是以上内容的组合。如果你不需要申明指定的Uri数据,那你仅指定 android:mimeType属性即可,例如text/plain或image/jpeg。
Category
提供一种额外的方法来表示activity处理的intent,通常与用户手势和开始位置相关。系统支持几种不同的类别,但大部分都很少使用,一般在intent filter中的节点使用CATEGORY_DEFAULT。
下面的中定义的内容表示在处理ACTION_SEND的intent中使用的数据类型为文本或图像。

[html] view plaincopyprint?

1.
2.
3.
4.
5.
6.
7.

8.

每一个传入的intent只有一个动作和一种数据类型,但声明多个,,也是OK的,如果动作和数据类型相互排斥的话,你就应该分开它们。加入你的activity处理文本和图像,并且使用ACTION_SEND和ACTION_SENDTO intents。这样就是错误的,在这种情况下你应该使用两个来分开它们。因为SENDTO必须使用Uri数据,并且需要sms和smsto的scheme。

[html] view plaincopyprint?

1.
2.
3.
4.
5.
6.
7.
8.

9.
10.
11.
12.
13.
14.
15.

16.

为了接收隐式的intents,我们必须在中定义CATEGORY_DEFAULT中,如果没声明,那么你的activity不能解决处理隐式的intents。
3.2 在Activity中处理intent 为了决定在你activity中想要处理的动作,你能在启动activity时读取intent。在启动activity时,调用getIntent()方法来检索启动activity的intent。你能在任意时刻这么做,但最好在onCreate()或onStart()中这样做。

[java] view plaincopyprint?

1. @Override
2. protected void onCreate(Bundle savedInstanceState) {
3. super.onCreate(savedInstanceState);
4. setContentView(R.layout.main);
5. //获得启动activity的intent
6. Intent intent = getIntent();
7. Uri data = intent.getData();
8.
9. // 解决intent类型想做什么
10. if (intent.getType().indexOf(“image/”) != -1) {
11. //处理图像数据
12. } else if (intent.getType().equals(“text/plain”)) {
13. // 处理文本
14. }
15. }

3.3 返回一个结果 如果你想要返回一个结果到你调用的activity,最简单的就是调用setResult()方法来指定结果代码和intent结果。当你的操作完成时,用户如果想要返回到最开始的activity,调用finish()来关闭和destroy你的activity即可。

[java] view plaincopyprint?

1. // 创建intent来传递某种结果数据
2. Intent result = new Intent(“com.example.RESULT_ACTION”, Uri.parse(“content://result_uri”);
3. setResult(Activity.RESULT_OK, result);
4. finish();

我们可以只指定result code。通常是RESULT_OK或RESULT_CANCELED。你可以添加额外的intent或者不添加。默认的result code是RESULT_CANCELED。所以如果用户在你设置result之前执行Back键,那么最初的activity收到的就是RESULT_CANCELED,这并不是我们预计的结果,这个细节请注意。

发表评论

电子邮件地址不会被公开。 必填项已用*标注