Develop -- Training(九) -- 分享简单数据

发送简单的数据给其他应用程序

发送文本内容

Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send.");
sendIntent.setType("text/plain");
startActivity(sendIntent);

如果你的设备上安装的应用能够匹配到的行为是 ACTION_SEND 和MIME 类型是 text/plain，Android 系统就会打开这个应用。

如果有多个应用程序匹配它，Android 系​​统会显示一个对话框，让用户去选择想要打开的应用程序。

注意：如果没有任何应用程序可以匹配的话，也就是没有相应的 Intent，你的应用程序就会报错，所以，我们最好加上系统中有没有这个 Intent 的判断。

Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send.");
sendIntent.setType("text/plain");
startActivity(Intent.createChooser(sendIntent, getResources().getText(R.string.send_to)));

如果你调用 Intent.createChooser() 方法，会出现一个显示选择器。

- 即使用户已经选择了默认操作，仍然会显示选择器。

- 如果没有应用程序匹配，Android 会显示一个系统消息。

- 可以指定选择器对话框的标题。

发送二进制内容

Intent shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND);
shareIntent.putExtra(Intent.EXTRA_STREAM, uriToImage);
shareIntent.setType("image/jpeg");
startActivity(Intent.createChooser(shareIntent, getResources().getText(R.string.send_to)));

发送二进制数据，需要使用的 Action 为 Intent.ACTION_SEND

携带参数的 URI 数据名称为： Intent.EXTRA_STREAM

如果共享图像数据，MIME 类型为：image/jpeg

如果共享任何类型的数据，MIME 类型为： * / *

发送多件内容

ArrayList<Uri> imageUris = new ArrayList<Uri>();
imageUris.add(imageUri1); // Add your image URIs here
imageUris.add(imageUri2);

Intent shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND_MULTIPLE);
shareIntent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris);
shareIntent.setType("image/*");
startActivity(Intent.createChooser(shareIntent, "Share images to.."));

发送多个内容，需要使用 Action 为 Intent.ACTION_SEND_MULTIPLE

如果是单个类型的多个数据，如图像类型，MIME 类型为：image/jpeg

如果是图像的类型的混合数据，MIME 类型为：image/*

从其他的应用程序接收简单的数据

更新你的 Manifest

为了接收前面所创建的 intent，我们需要在 Manifest 清单文件中做一些配置操作。 需要在 < activity >元素节点 里添加 intent 过滤器，使用< intent-filter > 。

例如，如果你的应用程序可以处理任何类型的单个图像，接收文本内容，或任何类型的多个图像。

<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>

处理传入的内容

通过 getIntent() 方法得到需要处理的 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
}
}

注意：如果是处理二进制数据的话，需要在子线程中处理，而不是在 UI 线程中。

添加一个简单的分享动作

更新菜单声明

ShareActionProvider：在API等级14及更高版本。



这个就是 ShareActionProvider 的使用效果。

在 res\menu 资源目录下创建一个 menu 的 xml 文件，在< item >里添加 android:actionProviderClass 属性。

<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item
android:id="@+id/menu_item_share"
android:showAsAction="ifRoom"
android:title="Share"
android:actionProviderClass=
"android.widget.ShareActionProvider" />
...
</menu>

设置分享意图

private ShareActionProvider mShareActionProvider;
...

@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate menu resource file.
getMenuInflater().inflate(R.menu.share_menu, menu);

// Locate MenuItem with ShareActionProvider
MenuItem item = menu.findItem(R.id.menu_item_share);

// Fetch and store ShareActionProvider
mShareActionProvider = (ShareActionProvider) item.getActionProvider();

// Return true to display menu
return true;
}

// Call to update the share intent
private void setShareIntent(Intent shareIntent) {
if (mShareActionProvider != null) {
mShareActionProvider.setShareIntent(shareIntent);
}
}

通过 MenuItem.getActionProvider() 得到 ShareActionProvider 实例，然后调用 mShareActionProvider.setShareIntent(shareIntent) 发送意图。