启动另一个Activity并不是单向的操作,您也可以启动另一个Activity并获取返回结果。startActivity()只启动另一个Activity,startActivityForResult()启动另一个Activity且获取返回结果。
例如,您的APP可以启动相机APP,并获取捕获的照片。或者,您的APP启动联系人APP,以便用户选择联系人,然后您的APP将收到用户所选联系人的详细信息。
当然,另一个Activity必须设计为能返回结果,并用Intent对象来发送这个结果。您的Activity在onActivityResult()回调中接收返回结果。
注意:当您调用startActivityForResult()时,可以使用显式或隐式Intent。当您启动的是您APP内的Activity时,您应该使用显式Intent来确保您收到预期的结果。
要启动Activity并获取返回结果,只需给startActivityForResult()方法传递一个额外的整型参数,Intent的使用方法同startActivity()。整型参数是一个“request code”,用于标识您的请求。当您收到结果Intent时,回调函数提供相同的“request code”,以便您的APP可以正确识别结果并确定如何处理它。
例如,以下是启动一个让用户选择联系人的Activity:
static final int PICK_CONTACT_REQUEST = 1; // The request code
...
private void pickContact() {
Intent pickContactIntent = new Intent(Intent.ACTION_PICK, Uri.parse("content://contacts"));
pickContactIntent.setType(Phone.CONTENT_TYPE); // Show user only contacts w/ phone numbers
startActivityForResult(pickContactIntent, PICK_CONTACT_REQUEST);
}
当用户在启动的Activity中完成操作并返回时,系统将调用您的Activity的onActivityResult()方法。这个方法包括三个参数:
•传递给startActivityForResult()的request code
。
•由第二个Activity指定的result code
。如果操作成功,则为RESULT_OK,如果用户退出或由于某种原因操作失败,则为RESULT_CANCELED。
•携带返回数据的Intent
。
例如,以下展示如何处理“选择联系人”Intent的结果:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
// Check which request we're responding to
if (requestCode == PICK_CONTACT_REQUEST) {
// Make sure the request was successful
if (resultCode == RESULT_OK) {
// The user picked a contact.
// The Intent's data Uri identifies which contact was selected.
// Do something with the contact here (bigger example below)
}
}
}
在此示例中,Android的“联系人”APP返回的结果Intent提供了用于标识用户所选联系人的Uri。
为了成功处理结果,您必须了解结果Intent的格式是什么。如果返回结果的Activity是自定义Activity,那么结果Intent的格式是自定义的;如果返回结果的Activity是Android平台提供的APP,则需要在其API中查阅Intent格式。例如,联系人APP返回的结果包含标识所选联系人的URI,而Camera应用程序会在“data”中返回一个Bitmap(请参阅有关 Capturing Photos的类)。
上面的代码显示了如何从联系人APP获取结果,并没有详细介绍如何从结果中读取数据,这涉及关于content providers的更高级的讨论。下面的代码显示如何查询结果数据,从所选联系人获取电话号码:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
// Check which request it is that we're responding to
if (requestCode == PICK_CONTACT_REQUEST) {
// Make sure the request was successful
if (resultCode == RESULT_OK) {
// Get the URI that points to the selected contact
Uri contactUri = data.getData();
// We only need the NUMBER column, because there will be only one row in the result
String[] projection = {Phone.NUMBER};
// Perform the query on the contact to get the NUMBER column
// We don't need a selection or sort order (there's only one result for the given URI)
// CAUTION: The query() method should be called from a separate thread to avoid blocking
// your app's UI thread. (For simplicity of the sample, this code doesn't do that.)
// Consider using CursorLoader to perform the query.
Cursor cursor = getContentResolver()
.query(contactUri, projection, null, null, null);
cursor.moveToFirst();
// Retrieve the phone number from the NUMBER column
int column = cursor.getColumnIndex(Phone.NUMBER);
String number = cursor.getString(column);
// Do something with the phone number...
}
}
}
注意:在Android 2.3(API等级9)之前,在Contacts Provider上执行查询(如上所示)要求您的应用程序声明READ_CONTACTS权限(请参阅 Security and Permissions)。然而,从Android 2.3开始,“联系人”APP在返回结果时,会授予您的APP临时权限以从Contacts Provider中读取联系人信息。临时权限仅适用于请求的特定联系人,因此除非您声明了READ_CONTACTS权限,否则您无法查询除Intent Uri指定的联系人之外的联系人。