Intent.ActionOpenDocument 필드

정의

활동 작업: 사용자가 하나 이상의 기존 문서를 선택하고 반환할 수 있도록 허용합니다.

[Android.Runtime.Register("ACTION_OPEN_DOCUMENT")]
public const string ActionOpenDocument;
[<Android.Runtime.Register("ACTION_OPEN_DOCUMENT")>]
val mutable ActionOpenDocument : string

필드 값

구현

특성

설명

활동 작업: 사용자가 하나 이상의 기존 문서를 선택하고 반환할 수 있도록 허용합니다. 호출될 때 시스템은 디바이스에 설치된 다양한 DocumentsProvider 인스턴스를 표시하여 사용자가 대화형으로 탐색할 수 있도록 합니다. 이러한 문서에는 사진 및 비디오와 같은 로컬 미디어와 설치된 클라우드 스토리지 공급자가 제공하는 문서가 포함됩니다.

각 문서는 로 백업되는 DocumentsProviderURI로 content:// 표시되며, 를 사용하여 스트림ContentResolver#openFileDescriptor(Uri, String)으로 열거나 메타데이터를 android.provider.DocumentsContract.Document 쿼리할 수 있습니다.

선택한 모든 문서는 지속 가능한 읽기 및 쓰기 권한 부여를 사용하여 호출 애플리케이션에 반환됩니다. 디바이스를 다시 부팅할 때 문서에 대한 액세스를 유지하려면 를 사용하여 ContentResolver#takePersistableUriPermission(Uri, int)지속 가능한 권한을 명시적으로 사용해야 합니다.

호출자는 를 통해 #setType(String)허용되는 문서 MIME 형식을 나타내야 합니다. 예를 들어 사진을 선택하려면 를 사용합니다 image/*. 서로 연결되지 않는 여러 MIME 형식이 허용되는 경우 및 #setType(String) 에서 #EXTRA_MIME_TYPES */*로 정의합니다.

호출자가 반환된 여러 항목(사용자가 여러 선택을 수행함)을 처리할 수 있는 경우 를 지정 #EXTRA_ALLOW_MULTIPLE 하여 이를 나타낼 수 있습니다.

호출자는 를 사용하여 열 수 있는 URI를 가져오려면 의도에 ContentResolver#openFileDescriptor(Uri, String)를 포함 #CATEGORY_OPENABLE 해야 합니다.

호출자는 를 통해 DocumentsContract#EXTRA_INITIAL_URI 문서 URI를 설정하여 문서 탐색기의 초기 위치를 나타낼 수 있습니다. 시스템이 폴더인 경우 지정된 문서에서 탐색기를 시작하거나 지정한 문서가 포함된 폴더(그렇지 않은 경우)를 실행하기 위해 최선을 다합니다.

출력: 에서 반환 #getData()된 선택된 항목의 URI입니다. 모든 수신기가 content:// 액세스할 수 있도록 URI여야 합니다. 여러 문서를 선택한 경우 에서 #getClipData()반환됩니다.

에 대한 Java 설명서입니다 android.content.Intent.ACTION_OPEN_DOCUMENT.

이 페이지의 일부는 만들고 공유하며 에 설명된 용어에 따라 사용되는 작업을 기반으로 수정됩니다.

적용 대상

추가 정보