android 应用组件[通用 Intent---打开特定类型的文件] 十二

在 Android 4.4 或更高版本上运行时，您可以不必检索必须导入应用的文件副本（使用 ACTION_GET_CONTENT 操作），而是使用 ACTION_OPEN_DOCUMENT 操作并指定 MIME 类型，请求打开由另一个应用管理的文件。如果还需要允许用户创建应用可写入的新文档，可改用 ACTION_CREATE_DOCUMENT 操作。例如，ACTION_CREATE_DOCUMENT Intent 允许用户选择他们想在哪里创建新 PDF 文档（在另一个管理文档存储的应用内），而不是从现有文档中进行选择 — 您的应用随后会收到其可以写入新文档的 URI 位置。

尽管从 ACTION_GET_CONTENT 操作传递至您的 onActivityResult() 方法的 Intent 可能返回任何类型的 URI，来自 ACTION_OPEN_DOCUMENT 和ACTION_CREATE_DOCUMENT 的结果 Intent 始终将所选文件指定为 DocumentsProvider 支持的 content: URI。您可以通过 openFileDescriptor() 打开该文件，并使用 DocumentsContract.Document 中的列查询其详细信息。

返回的 URI 会为您的应用授予对文件的长期读取权限（还可能会授予写入权限）。 因此，如果您想读取现有文件而不将其副本导入您的应用，或者您想就地打开和编辑文件，特别适合使用ACTION_OPEN_DOCUMENT操作（而不是使用 ACTION_GET_CONTENT）。

您还可以通过为 Intent 添加 EXTRA_ALLOW_MULTIPLE 并将其设置为 true，允许用户选择多个文件。如果用户只选择一项，您就可以从 getData() 检索该项目。如果用户选择多项，则 getData() 返回 null，此时您必须改为从 getClipData() 返回的 ClipData 对象检索每个项目。

注：您的 Intent 必须指定 MIME 类型，并且必须声明 CATEGORY_OPENABLE 类别。必要时，您可以使用 EXTRA_MIME_TYPES extra 添加一个 MIME 类型数组来指定多个 MIME 类型 — 如果您这样做，必须将 setType() 中的主 MIME 类型设置为 "*/*"。

操作

ACTION_OPEN_DOCUMENT 或
ACTION_CREATE_DOCUMENT

数据 URI 架构

无

MIME 类型

与用户应选择的文件类型对应的 MIME 类型。

Extra

EXTRA_MIME_TYPES

与您的应用请求的文件类型对应的 MIME 类型数组。 当您使用此 extra 时，必须在  setType() 中将主 MIME 类型设置为  "*/*"。

EXTRA_ALLOW_MULTIPLE

一个布尔型值，声明用户是否可以一次选择多个文件。

EXTRA_TITLE

供与  ACTION_CREATE_DOCUMENT 配合使用，用于指定初始文件名。

EXTRA_LOCAL_ONLY

一个布尔型值，声明是否返回的文件必须直接存在于设备上，而不是需要从远程服务下载。

类别

CATEGORY_OPENABLE

只返回可通过  openFileDescriptor() 以文件流形式表示的“可打开”文件。

用于获取照片的示例 Intent：

static final int REQUEST_IMAGE_OPEN = 1;

public void selectImage() {
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
    intent.setType("image/*");
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    // Only the system receives the ACTION_OPEN_DOCUMENT, so no need to test.
    startActivityForResult(intent, REQUEST_IMAGE_OPEN);
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_IMAGE_OPEN && resultCode == RESULT_OK) {
        Uri fullPhotoUri = data.getData();
        // Do work with full size photo saved at fullPhotoUri
        ...
    }
}

第三方应用实际上无法通过 ACTION_OPEN_DOCUMENT 操作响应 Intent，而是由系统接收此 Intent，然后在统一用户界面中显示各类应用提供的所有文件。

如需在该 UI 中提供您的应用的文件，并允许其他应用打开它们，您必须实现一个 DocumentsProvider，并加入一个 PROVIDER_INTERFACE Intent 过滤器 ("android.content.action.DOCUMENTS_PROVIDER")。例如：

<provider ...
    android:grantUriPermissions="true"
    android:exported="true"
    android:permission="android.permission.MANAGE_DOCUMENTS">
    <intent-filter>
        <action android:name="android.content.action.DOCUMENTS_PROVIDER" />
    </intent-filter>
</provider>

如需了解有关如何实现从其他应用打开您的应用管理的文件的详细信息，请阅读 存储访问框架 指南。