【Android Developers Training】 33. 接收来自其它应用的简单数据

注：本文翻译自Google官方的Android Developers Training文档，译者技术一般，由于喜爱安卓而产生了翻译的念头，纯属个人兴趣爱好。

原文链接：http://developer.android.com/training/sharing/receive.html

既然你的应用可以向其它应用发送数据，那么你的应用也可以接收来自其它应用的数据。您需要思考一下用户是如何与你的应用交互的，以及你希望接收来自其它应用什么样的数据。例如，一个社交网络应用可能会期望收到来自其它应用的文本内容，比如一个感兴趣的网页URL。而Google+ Android application即接收文本和单个或多个图像。这样一来，用户就可以轻松的再Google+上发布来自Android图库应用中的照片了。

一）. 更新你的清单文件

intent过滤器会告知系统，应用组件期望接收什么样的intents。如在课程Sending Simple Data to Other Apps（博客链接：http://www.cnblogs.com/jdneo/p/3473170.html）你构造一个具有ACTION_SEND的intent类似。你可以创建intent过滤器来接收这一行为的intent。你在你的清单文件中使用<intent-filter>标签定义一个intent过滤器。例如，如果你的应用能处理接收文本内容，一个单一的任何类型的图片，或者多张不同类型的图片，你的清单文件看上去应该是这样的：

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

Note：

更多intent过滤器以及intent解析的内容，可以阅读：Intents and Intent Filters

当另一个应用通过构造一个intent并且将它传递给startActivity()，来尝试分享任何这些数据时，你的应用将会在intent选择器中列出来。如果用户选择了你的应用，响应的activity（在上例中是“.ui.MyActivity”）将会被启动。之后合理地处理内容就要看你的代码和UI的设计了。

二）. 处理接收的内容

为了处理Intent发送的数据，可以调用getIntent()来获取Intent对象。一旦你获取了对象，你可以检查它的内容来决定下一步做什么。记住如果该activity能够被其他系统的某个部分启动，比如启动器，当你要检验这个intent时，你需要将这部分内容考虑进去。

void onCreate (Bundle savedInstanceState) {
    ...
    // Get intent, action and MIME type
    Intent intent = getIntent();
    String action = intent.getAction();
    String type = intent.getType();

    if (Intent.ACTION_SEND.equals(action) && type != null) {
        if ("text/plain".equals(type)) {
            handleSendText(intent); // Handle text being sent
        } else if (type.startsWith("image/")) {
            handleSendImage(intent); // Handle single image being sent
        }
    } else if (Intent.ACTION_SEND_MULTIPLE.equals(action) && type != null) {
        if (type.startsWith("image/")) {
            handleSendMultipleImages(intent); // Handle multiple images being sent
        }
    } else {
        // Handle other intents, such as being started from the home screen
    }
    ...
}

void handleSendText(Intent intent) {
    String sharedText = intent.getStringExtra(Intent.EXTRA_TEXT);
    if (sharedText != null) {
        // Update UI to reflect text being shared
    }
}

void handleSendImage(Intent intent) {
    Uri imageUri = (Uri) intent.getParcelableExtra(Intent.EXTRA_STREAM);
    if (imageUri != null) {
        // Update UI to reflect image being shared
    }
}

void handleSendMultipleImages(Intent intent) {
    ArrayList<Uri> imageUris = intent.getParcelableArrayListExtra(Intent.EXTRA_STREAM);
    if (imageUris != null) {
        // Update UI to reflect multiple images being shared
    }
}

Caution：

检验接收的数据要额外关注，因为你永远都预测不到其他应用会发给你什么数据。例如，错误的MIME类型可能被设置，或者发送的图片可能特别大。另外，要记住在另一个线程执行二进制数据，而不是在主线程（“UI线程”）。

更新一个UI可能简单到填充一个EditText，也有可能复杂到在一幅图片上应用一个滤镜效果。下一步如何执行完全取决于你的应用。