允许其他应用程序来开始你的活动

前两个课程集中在一侧的故事:从你的应用程序启动另一个应用程序的活动。但是如果你的应用程序可以执行一个动作,可能有用到另一个应用程序,应用程序应该准备应对行动来自其他应用程序的请求。例如,如果您构建一个社会与用户应用程序可以共享信息或照片的朋友,在你的最佳利益支持ACTION_SEND意图,用户可以发起一个“共享”行动从另一个应用程序和启动应用程序执行的行动。

允许其他应用程序开始你的活动,你需要添加一个<intent>元素)在清单文件中相应的<activity>元素。

在设备上安装应用程序时,系统识别你的意图过滤器并将信息添加到一个内部目录所有已安装的应用程序支持的意图。当一个应用程序调用startActivity()或startActivityForResult(),隐性意图,系统发现哪个活动(或活动)可以应对的意图。

添加一个意图过滤器

为了正确地定义哪些意图可以处理你的活动,eac h意图过滤器添加应尽可能具体的行动和活动接受数据的类型。

系统可能发送一个给定的意图的活动,如果活动有一个意图对象的意图过滤器满足以下标准:

行动

一个字符串命名操作执行。通常一个如ACTION_SEND或ACTION_VIEW平台定义的值。

指定该在你的意图过滤器<行动>元素。您所指定的值在这个元素必须完整的字符串名称的行动,而不是API的常数(见下面的例子)。

数据

数据的描述与意图。

指定该在你的意图过滤器<数据>元素。在这个元素使用一个或多个属性,你可以指定MIME类型,只是一个URI的前缀,只是一个URI方案,或这些方法的组合和其他表示接受的数据类型。

注意:如果您不需要声明的细节数据Uri(例如当你的活动处理其他类型的“额外的”数据,而不是一个Uri),你应该只指定android:mimeType属性声明的数据类型处理你的活动,例如文本/平原或图像/ jpeg。

类别

提供了一个额外的方法描述活动处理的目的,通常与用户手势或从它的开始位置。有几种不同类别的支持系统,但是大部分都很少使用。然而,默认所有与CATEGORY_DEFAULT定义隐式意图。

指定该在你的意图过滤器<目录>元素。

在你的意图过滤器,您可以声明的标准活动接受通过声明他们每个人对应的XML元素嵌套在<意图过滤器>元素。

例如,这里有一个活动的意图过滤器处理ACTION_SEND意图时,数据类型是文本或图像:

<activity android:name="ShareActivity">
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain"/>
        <data android:mimeType="image/*"/>
    </intent-filter>
</activity>

每个传入的意图只指定一个行动,一个数据类型,但是没关系要申报的多个实例<行动>,<目录>,<数据>元素在每个<意图过滤器>。

如果有两双行动和行为数据是相互排斥的,您应该创建单独的意图过滤器指定哪些行为是可以接受的,搭配的数据类型。

例如,假设你的活动处理文本和图像ACTION_SEND和ACTION_SENDTO意图。在这种情况下,您必须定义两个单独的意图过滤器的两个动作,因为ACTION_SENDTO意图必须使用数据Uri指定收件人的地址使用发送或sendto Uri方案。例如:

<activity android:name="ShareActivity">
    <!-- filter for sending text; accepts SENDTO action with sms URI schemes -->
    <intent-filter>
        <action android:name="android.intent.action.SENDTO"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:scheme="sms" />
        <data android:scheme="smsto" />
    </intent-filter>
    <!-- filter for sending text or images; accepts SEND action and text or image data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="image/*"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
</activity>

注意:为了得到隐含的意图,你必须包括CATEGORY_DEFAULT类别的意图过滤器。方法startActivity()和startActivityForResult()对所有的意图,好像他们宣布CATEGORY_DEFAULT类别。如果你不声明意图过滤器,不隐式意图将解决你的活动。

更多信息发送和接收ACTION_SEND执行社交分享行为的意图,看到课收到来自其他应用程序的简单的数据。

处理活动的意图

为了决定采取何种方法时,在你的活动,你可以阅读的目的是用来启动它。

作为你的活动开始,调用getIntent()来检索意图开始活动。可以在任何时间在活动的生命周期,但是你应该在早期通常这样做回调等onCreate()或onStart()。

例如:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    setContentView(R.layout.main);

    // Get the intent that started this activity
    Intent intent = getIntent();
    Uri data = intent.getData();

    // Figure out what to do based on the intent type
    if (intent.getType().indexOf("image/") != -1) {
        // Handle intents with image data ...
    } else if (intent.getType().equals("text/plain")) {
        // Handle intents with text ...
    }
}

返回一个结果

如果你想要你的调用返回结果的活动,只是叫setResult()指定结果代码和结果的目的。当1441年你的操作完成后,用户应该回到原来的活动,叫完成()关闭并摧毁你的活动。例如:

// Create intent to deliver some kind of result data
Intent result = new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri");
setResult(Activity.RESULT_OK, result);
finish();

您必须指定一个结果代码与结果。一般来说,它是RESULT_OK或RESULT_CANCELED。你可以提供额外的数据与一个意图,是必要的。

注意:设置为默认RESULT_CANCELED结果。所以,如果用户按下后退按钮之前完成行动,之前设置的结果,原来的活动收到“取消”的结果。

如果你只需要返回一个整数,表示几个结果选项之一,您可以设置结果代码的任何值高于0。如果你使用结果代码提供一个整数和你没有需要包括目的,你可以叫setResult()和通过只有一个结果代码。例如:

setResult(RESULT_COLOR_RED);
finish();

在这种情况下,可能会有少数可能的结果,所以结果代码是一个本地定义整数(大于0)。这是当你返回一个结果,一个活动在您自己的应用程序,因为收到的活动结果可以参考公众常数确定结果代码的价值。

注意:不需要检查你的活动是否开始startActivity()或startActivityForResult()。简单地调用setResult()开始活动的意图是否期望结果。如果原始活动称为startActivityForResult(),那么系统将其结果你供应setResult();否则,结果被忽略。