Popularne intencje

val REQUEST_IMAGE_CAPTURE = 1

private fun dispatchTakePictureIntent() {
    val takePictureIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE)
    } catch (e: ActivityNotFoundException) {
        // Display error state to the user.
    }
}

static final int REQUEST_IMAGE_CAPTURE = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);
    } catch (ActivityNotFoundException e) {
        // Display error state to the user.
    }
}
</section></div>

Więcej informacji o używaniu tego zamiaru do robienia zdjęć, w tym o tworzeniu odpowiedniego Uri dla lokalizacji wyjściowej, znajdziesz w artykule Robienie zdjęć lub Robienie filmów.

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.IMAGE_CAPTURE" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Podczas obsługi tej intencji sprawdź, czy w przychodzącym Intent jest dodatkowy element EXTRA_OUTPUT, a następnie zapisz zrobione zdjęcie lub nagrany film w lokalizacji określonej przez ten dodatkowy element i wywołaj setResult() z Intent, który zawiera skompresowany miniaturę w dodatkowym elemencie o nazwie "data".

Uruchom aplikację aparatu w trybie zdjęć

Komendy głosowe Google

• „zrób zdjęcie”

Aby otworzyć aplikację aparatu w trybie zdjęć, użyj działania INTENT_ACTION_STILL_IMAGE_CAMERA.

Czynność

INTENT_ACTION_STILL_IMAGE_CAMERA

Schemat URI danych

Brak

Typ MIME

Brak

Dodatki

Brak

Przykład intencji:

private fun dispatchTakePictureIntent() {
    val takePictureIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE)
    } catch (e: ActivityNotFoundException) {
        // Display error state to the user.
    }
}

public void capturePhoto(String targetFilename) {
    Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    intent.putExtra(MediaStore.EXTRA_OUTPUT,
            Uri.withAppendedPath(locationForPhotos, targetFilename));
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.STILL_IMAGE_CAMERA" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Uruchom aplikację aparatu w trybie wideo.

Komendy głosowe Google

• „Nagrywanie filmu”

Aby otworzyć aplikację aparatu w trybie wideo, użyj działania INTENT_ACTION_VIDEO_CAMERA.

Czynność

INTENT_ACTION_VIDEO_CAMERA

Schemat URI danych

Brak

Typ MIME

Brak

Dodatki

Brak

Przykład intencji:

fun capturePhoto() {
    val intent = Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA)
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE)
    }
}

public void capturePhoto() {
    Intent intent = new Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.VIDEO_CAMERA" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Aplikacja Kontakty/Osoby

Poniżej znajdziesz typowe działania związane z aplikacjami do zarządzania kontaktami, w tym informacje potrzebne do utworzenia filtra intencji, aby reklamować możliwość wykonania danego działania przez aplikację.

Wybierz kontakt

Aby umożliwić użytkownikowi wybranie kontaktu i udostępnienie aplikacji dostępu do wszystkich informacji o nim, użyj działania ACTION_PICK i wskaż typ MIME jako Contacts.CONTENT_TYPE.

Wynik Intent zwrócony do wywołania zwrotnego onActivityResult() zawiera identyfikator URI content: wskazujący wybrany kontakt. Odpowiedź przyznaje Twojej aplikacji tymczasowe uprawnienia do odczytu tego kontaktu za pomocą interfejsu Contacts Provider API, nawet jeśli aplikacja nie zawiera uprawnienia READ_CONTACTS.

Wskazówka: jeśli potrzebujesz dostępu tylko do określonych informacji kontaktowych, takich jak numer telefonu lub adres e-mail, zapoznaj się z następnym rozdziałem, aby wybrać określone dane kontaktowe.

Czynność

ACTION_PICK

Schemat URI danych

Brak

Typ MIME

Contacts.CONTENT_TYPE

Przykład intencji:

const val REQUEST_SELECT_CONTACT = 1

fun selectContact() {
    val intent = Intent(Intent.ACTION_PICK).apply {
        type = ContactsContract.Contacts.CONTENT_TYPE
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_SELECT_CONTACT)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_SELECT_CONTACT && resultCode == RESULT_OK) {
        val contactUri: Uri = data.data
        // Do something with the selected contact at contactUri.
        //...
    }
}

static final int REQUEST_SELECT_CONTACT = 1;

public void selectContact() {
    Intent intent = new Intent(Intent.ACTION_PICK);
    intent.setType(ContactsContract.Contacts.CONTENT_TYPE);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_SELECT_CONTACT);
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_SELECT_CONTACT && resultCode == RESULT_OK) {
        Uri contactUri = data.getData();
        // Do something with the selected contact at contactUri.
        ...
    }
}

Informacje o tym, jak poznać szczegóły kontaktu, gdy znasz jego identyfikator URI, znajdziesz w artykule Pobieranie szczegółów kontaktu.

Gdy pobierasz identyfikator URI kontaktu za pomocą tego zamiaru, zazwyczaj nie musisz mieć uprawnieńREAD_CONTACTSdo odczytu podstawowych informacji o tym kontakcie, takich jak wyświetlana nazwa czy oznaczenie gwiazdką. Jeśli jednak chcesz odczytywać bardziej szczegółowe dane o danym kontakcie, np. jego numer telefonu lub adres e-mail, musisz mieć uprawnienie READ_CONTACTS.

Wybierz konkretne dane kontaktowe

Aby użytkownik mógł wybrać konkretny element informacji o kontaktach, np. numer telefonu, adres e-mail lub inny typ danych, użyj działania ACTION_PICK i określ typ MIME jako jeden z tych typów treści, np. CommonDataKinds.Phone.CONTENT_TYPE, aby uzyskać numer telefonu kontaktu.

Uwaga: w wielu przypadkach aplikacja musi mieć uprawnienie READ_CONTACTS do wyświetlania określonych informacji o kontakcie.

Jeśli chcesz pobrać tylko 1 typ danych z kontaktu, ta metoda z użyciem funkcji CONTENT_TYPE z klasy ContactsContract.CommonDataKinds jest bardziej wydajna niż użycie funkcji Contacts.CONTENT_TYPE, jak pokazano w poprzedniej sekcji. Wynik daje bezpośredni dostęp do odpowiednich danych bez konieczności wykonywania bardziej złożonego zapytania do dostawcy kontaktów.

Wynik Intent zwrócony do wywołania zwrotnego onActivityResult() zawiera identyfikator URI content: wskazujący wybrane dane kontaktowe. Odpowiedź przyznaje Twojej aplikacji tymczasowe uprawnienia do odczytu tych danych kontaktów, nawet jeśli aplikacja nie ma uprawnienia READ_CONTACTS.

Czynność

ACTION_PICK

Schemat URI danych

Brak

Typ MIME

CommonDataKinds.Phone.CONTENT_TYPE

Wybierz kontakt z numerem telefonu.

CommonDataKinds.Email.CONTENT_TYPE

Wybierz kontakty z adresem e-mail.

CommonDataKinds.StructuredPostal.CONTENT_TYPE

Wybierz kontakty z adresem pocztowym.

Możesz też użyć jednej z wielu innych wartości CONTENT_TYPE pod ContactsContract.

Przykład intencji:

const val REQUEST_SELECT_PHONE_NUMBER = 1

fun selectContact() {
    // Start an activity for the user to pick a phone number from contacts.
    val intent = Intent(Intent.ACTION_PICK).apply {
        type = CommonDataKinds.Phone.CONTENT_TYPE
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_SELECT_PHONE_NUMBER)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_SELECT_PHONE_NUMBER && resultCode == Activity.RESULT_OK) {
        // Get the URI and query the content provider for the phone number.
        val contactUri: Uri = data.data
        val projection: Array<String> = arrayOf(CommonDataKinds.Phone.NUMBER)
        contentResolver.query(contactUri, projection, null, null, null).use { cursor ->
            // If the cursor returned is valid, get the phone number.
            if (cursor.moveToFirst()) {
                val numberIndex = cursor.getColumnIndex(CommonDataKinds.Phone.NUMBER)
                val number = cursor.getString(numberIndex)
                // Do something with the phone number.
                ...
            }
        }
    }
}

static final int REQUEST_SELECT_PHONE_NUMBER = 1;

public void selectContact() {
    // Start an activity for the user to pick a phone number from contacts.
    Intent intent = new Intent(Intent.ACTION_PICK);
    intent.setType(CommonDataKinds.Phone.CONTENT_TYPE);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_SELECT_PHONE_NUMBER);
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_SELECT_PHONE_NUMBER && resultCode == RESULT_OK) {
        // Get the URI and query the content provider for the phone number.
        Uri contactUri = data.getData();
        String[] projection = new String[]{CommonDataKinds.Phone.NUMBER};
        Cursor cursor = getContentResolver().query(contactUri, projection,
                null, null, null);
        // If the cursor returned is valid, get the phone number.
        if (cursor != null && cursor.moveToFirst()) {
            int numberIndex = cursor.getColumnIndex(CommonDataKinds.Phone.NUMBER);
            String number = cursor.getString(numberIndex);
            // Do something with the phone number.
            //...
        }
    }
}

Wyświetlanie kontaktu

Aby wyświetlić szczegóły znanego kontaktu, użyj działania ACTION_VIEW i jako dane intencji podaj URI kontaktu content:.

Istnieją 2 podstawowe sposoby początkowego pobrania identyfikatora URI kontaktu:

• Użyj identyfikatora URI kontaktu zwróconego przez działanie ACTION_PICK pokazane w poprzedniej sekcji. Takie podejście nie wymaga żadnych uprawnień aplikacji.
• Otwórz listę wszystkich kontaktów bezpośrednio, jak opisano w sekcji Pobieranie listy kontaktów. To podejście wymaga uprawnienia READ_CONTACTS.

Czynność

ACTION_VIEW

Schemat URI danych

content:<URI>

Typ MIME

Brak. Typ jest określany na podstawie identyfikatora URI kontaktu.

Przykład intencji:

fun viewContact(contactUri: Uri) {
    val intent = Intent(Intent.ACTION_VIEW, contactUri)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void viewContact(Uri contactUri) {
    Intent intent = new Intent(Intent.ACTION_VIEW, contactUri);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Edytowanie istniejącego kontaktu

Aby edytować znany kontakt, użyj działania ACTION_EDIT, określ kontakt za pomocą identyfikatora URI content: jako danych o intencji i uwzględnij wszystkie znane informacje kontaktowe w elementach dodatkowych określonych za pomocą stałych w ContactsContract.Intents.Insert.

Istnieją 2 podstawowe sposoby początkowego pobrania identyfikatora URI kontaktu:

• Użyj identyfikatora URI kontaktu zwróconego przez działanie ACTION_PICK pokazane w poprzedniej sekcji. Takie podejście nie wymaga żadnych uprawnień aplikacji.
• Otwórz listę wszystkich kontaktów bezpośrednio, jak opisano w sekcji Pobieranie listy kontaktów. To podejście wymaga uprawnienia READ_CONTACTS.

Czynność

ACTION_EDIT

Schemat URI danych

content:<URI>

Typ MIME

Typ jest określany na podstawie identyfikatora URI kontaktu.

Dodatki

Co najmniej 1 z opcji dodatkowych zdefiniowanych w sekcji ContactsContract.Intents.Insert, aby wypełnić pola danych kontaktowych.

Przykład intencji:

fun editContact(contactUri: Uri, email: String) {
    val intent = Intent(Intent.ACTION_EDIT).apply {
        data = contactUri
        putExtra(ContactsContract.Intents.Insert.EMAIL, email)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void editContact(Uri contactUri, String email) {
    Intent intent = new Intent(Intent.ACTION_EDIT);
    intent.setData(contactUri);
    intent.putExtra(Intents.Insert.EMAIL, email);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Więcej informacji o edytowaniu kontaktu znajdziesz w artykule Modyfikowanie kontaktów za pomocą intencji.

Wstawianie kontaktu

Aby wstawić nowy kontakt, użyj działania ACTION_INSERT, określ Contacts.CONTENT_TYPE jako typ MIME i dodaj znane informacje o kontakcie w dodatkowych danych określonych za pomocą stałych w ContactsContract.Intents.Insert.

Czynność

ACTION_INSERT

Schemat URI danych

Brak

Typ MIME

Contacts.CONTENT_TYPE

Dodatki

Co najmniej 1 z dodatków zdefiniowanych w ContactsContract.Intents.Insert.

Przykład intencji:

fun insertContact(name: String, email: String) {
    val intent = Intent(Intent.ACTION_INSERT).apply {
        type = ContactsContract.Contacts.CONTENT_TYPE
        putExtra(ContactsContract.Intents.Insert.NAME, name)
        putExtra(ContactsContract.Intents.Insert.EMAIL, email)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void insertContact(String name, String email) {
    Intent intent = new Intent(Intent.ACTION_INSERT);
    intent.setType(Contacts.CONTENT_TYPE);
    intent.putExtra(Intents.Insert.NAME, name);
    intent.putExtra(Intents.Insert.EMAIL, email);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Więcej informacji o wstawianiu kontaktu znajdziesz w artykule Modyfikowanie kontaktów za pomocą intencji.

Wysyłając e-mailem

Tworzenie e-maila z opcjonalnymi załącznikami jest typową czynnością w aplikacjach poczty e-mail. Utwórz filtr intencji, aby reklamować możliwość wykonania tego działania przez aplikację. Aby to zrobić, skorzystaj z informacji w następnej sekcji.

Tworzenie e-maila z opcjonalnymi załącznikami

Aby stworzyć e-maila, użyj jednej z tych czynności w zależności od tego, czy chcesz dołączyć załączniki, a także podaj szczegóły e-maila, takie jak odbiorca i temat, za pomocą wymienionych dodatkowych kluczy.

Czynność

ACTION_SENDTO (jeśli nie ma załącznika) lub
ACTION_SEND (jeśli jest jeden załącznik) lub
ACTION_SEND_MULTIPLE (jeśli jest więcej niż jeden załącznik)

Schemat URI danych

Brak

Typ MIME

"text/plain"

"*/*"

Dodatki

Intent.EXTRA_EMAIL

Tablica ciągów znaków zawierająca wszystkie adresy e-mail odbiorców z pola „Do”.

Intent.EXTRA_CC

Tablica ciągów tekstowych zawierająca wszystkie adresy e-mail odbiorców w kopii.

Intent.EXTRA_BCC

Tablica ciągów znaków zawierająca wszystkie adresy e-mail odbiorców w kopii „UDW”.

Intent.EXTRA_SUBJECT

Ciąg tekstowy z tematem e-maila.

Intent.EXTRA_TEXT

Ciąg tekstowy z treścią e-maila.

Intent.EXTRA_STREAM

Uri wskazujący załącznik. Jeśli używasz czynności ACTION_SEND_MULTIPLE, jest to obiekt ArrayList zawierający wiele obiektów Uri.

Przykład intencji:

fun composeEmail(addresses: Array<String>, subject: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SEND).apply {
        type = "*/*"
        putExtra(Intent.EXTRA_EMAIL, addresses)
        putExtra(Intent.EXTRA_SUBJECT, subject)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void composeEmail(String[] addresses, String subject, Uri attachment) {
    Intent intent = new Intent(Intent.ACTION_SEND);
    intent.setType("*/*");
    intent.putExtra(Intent.EXTRA_EMAIL, addresses);
    intent.putExtra(Intent.EXTRA_SUBJECT, subject);
    intent.putExtra(Intent.EXTRA_STREAM, attachment);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Jeśli chcesz mieć pewność, że Twoja intencja jest obsługiwana tylko przez aplikację poczty e-mail, a nie przez aplikację do obsługi wiadomości tekstowych ani aplikację społecznościową, użyj działania ACTION_SENDTO i uwzględnij schemat danych "mailto:", jak w tym przykładzie:

fun composeEmail(addresses: Array<String>, subject: String) {
    val intent = Intent(Intent.ACTION_SENDTO).apply {
        data = Uri.parse("mailto:") // Only email apps handle this.
        putExtra(Intent.EXTRA_EMAIL, addresses)
        putExtra(Intent.EXTRA_SUBJECT, subject)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void composeEmail(String[] addresses, String subject) {
    Intent intent = new Intent(Intent.ACTION_SENDTO);
    intent.setData(Uri.parse("mailto:")); // Only email apps handle this.
    intent.putExtra(Intent.EXTRA_EMAIL, addresses);
    intent.putExtra(Intent.EXTRA_SUBJECT, subject);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <data android:type="*/*" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.SENDTO" />
        <data android:scheme="mailto" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Miejsce na pliki

Poniżej znajdziesz typowe działania związane z aplikacjami do przechowywania plików, w tym informacje potrzebne do utworzenia filtra intencji, który reklamuje możliwość wykonania danej czynności przez aplikację.

Pobieranie określonego typu pliku

Aby poprosić użytkownika o wybranie pliku, np. dokumentu lub zdjęcia, i zwrócenie odwołania do Twojej aplikacji, użyj działania ACTION_GET_CONTENT i określ odpowiedni typ MIME. Odwołanie do pliku zwrócone do aplikacji jest tymczasowe w ramach bieżącego cyklu życia aktywności, więc jeśli chcesz uzyskać do niego dostęp później, musisz zaimportować kopię, którą możesz odczytać w późniejszym czasie.

Ta intencja umożliwia też użytkownikowi utworzenie nowego pliku. Na przykład zamiast wybierać istniejące zdjęcie, użytkownik może zrobić nowe zdjęcie aparatem.

Intencją wyniku dostarczoną do metody onActivityResult() są dane z identyfikatorem URI wskazującym na plik. Identyfikator URI może być dowolny, np. http:, file: lub content:. Jeśli jednak chcesz ograniczyć pliki do tych, które są dostępne od dostawcy treści (identyfikator URI content:) i są dostępne jako strumień plików z openFileDescriptor(), dodaj kategorię CATEGORY_OPENABLE do swojej intencji.

Na Androidzie 4.3 (poziom interfejsu API 18) i nowszych możesz też zezwolić użytkownikowi na wybranie wielu plików, dodając do intencji element EXTRA_ALLOW_MULTIPLE z wartością true. Następnie możesz uzyskać dostęp do wszystkich wybranych plików w obiekcie ClipDatazwróconym przez funkcję getClipData().

Czynność

ACTION_GET_CONTENT

Schemat URI danych

Brak

Typ MIME

Typ MIME odpowiadający typowi pliku, który musi wybrać użytkownik.

Dodatki

EXTRA_ALLOW_MULTIPLE

Wartość logiczna określająca, czy użytkownik może wybrać więcej niż 1 plik naraz.

EXTRA_LOCAL_ONLY

Wartość logiczna określająca, czy zwrócony plik musi być dostępny bezpośrednio z urządzenia, a nie wymagać pobrania z usługi zdalnej.

Kategoria (opcjonalnie)

CATEGORY_OPENABLE

Aby zwrócić tylko „otwieralne” pliki, które można przedstawić jako strumień plików za pomocą openFileDescriptor().

Przykład intencjonalnego działania:

const val REQUEST_IMAGE_GET = 1

fun selectImage() {
    val intent = Intent(Intent.ACTION_GET_CONTENT).apply {
        type = "image/*"
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_GET)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_IMAGE_GET && resultCode == Activity.RESULT_OK) {
        val thumbnail: Bitmap = data.getParcelableExtra("data")
        val fullPhotoUri: Uri = data.data
        // Do work with photo saved at fullPhotoUri.
        ...
    }
}

static final int REQUEST_IMAGE_GET = 1;

public void selectImage() {
    Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
    intent.setType("image/*");
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_GET);
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_IMAGE_GET && resultCode == RESULT_OK) {
        Bitmap thumbnail = data.getParcelable("data");
        Uri fullPhotoUri = data.getData();
        // Do work with photo saved at fullPhotoUri.
        ...
    }
}

Przykład filtra intencji z celem zwrócenia zdjęcia:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.GET_CONTENT" />
        <data android:type="image/*" />
        <category android:name="android.intent.category.DEFAULT" />
        <!-- The OPENABLE category declares that the returned file is accessible
             from a content provider that supports OpenableColumns
             and ContentResolver.openFileDescriptor(). -->
        <category android:name="android.intent.category.OPENABLE" />
    </intent-filter>
</activity>

Otwieranie określonego typu pliku

Zamiast pobierać kopię pliku, który musisz zaimportować do aplikacji, za pomocą działania ACTION_GET_CONTENT, gdy aplikacja działa na Androidzie 4.4 lub nowszym, możesz zamiast tego poprosić o otworzenie pliku zarządzanego przez inną aplikację, używając działania ACTION_OPEN_DOCUMENT i określając typ MIME. Aby umożliwić użytkownikowi utworzenie nowego dokumentu, do którego Twoja aplikacja będzie mogła zapisywać dane, użyj zamiast tego działania ACTION_CREATE_DOCUMENT.

Na przykład zamiast wybierać spośród istniejących dokumentów PDF, za pomocą intencji ACTION_CREATE_DOCUMENTużytkownicy mogą wybrać, gdzie chcą utworzyć nowy dokument, na przykład w innej aplikacji, która zarządza miejscem na dane dokumentu. Aplikacja otrzymuje lokalizację identyfikatora URI, w której może zapisać nowy dokument.

Intencje przekazywane do metody onActivityResult() z działania ACTION_GET_CONTENT mogą zwracać identyfikator URI dowolnego typu, ale intencje zwracane przez ACTION_OPEN_DOCUMENT i ACTION_CREATE_DOCUMENT zawsze wskazują wybrany plik jako identyfikator URI content:, który jest powiązany z elementem DocumentsProvider. Możesz otworzyć plik za pomocą openFileDescriptor() i zapytać o jego szczegóły za pomocą kolumn z DocumentsContract.Document.

Zwrócony identyfikator URI przyznaje aplikacji długoterminowy dostęp do pliku z możliwością odczytu, a także ewentualnie z możliwością zapisu. Działanie ACTION_OPEN_DOCUMENT jest szczególnie przydatne, gdy chcesz odczytać istniejący plik bez tworzenia jego kopii w aplikacji lub gdy chcesz otworzyć i zmodyfikować plik w miejscu.

Możesz też pozwolić użytkownikowi wybrać wiele plików, dodając do intencji element EXTRA_ALLOW_MULTIPLE z wartością true. Jeśli użytkownik wybierze tylko jeden element, możesz go pobrać z getData(). Jeśli użytkownik wybierze więcej niż 1 element, funkcja getData() zwróci wartość null. Zamiast tego musisz pobrać każdy element z obiektu ClipData zwracanego przez funkcję getClipData().

Uwaga: intencja musi określać typ MIME i musi deklarować kategorię CATEGORY_OPENABLE. W razie potrzeby możesz określić więcej niż jeden typ MIME, dodając tablicę typów MIME z dodatkową wartością EXTRA_MIME_TYPES. W takim przypadku musisz ustawić podstawowy typ MIME w elemencie setType() jako "*/*".

Czynność

ACTION_OPEN_DOCUMENT lub
ACTION_CREATE_DOCUMENT

Schemat URI danych

Brak

Typ MIME

Typ MIME odpowiadający typowi pliku, który musi wybrać użytkownik.

Dodatki

EXTRA_MIME_TYPES

Tablica typów MIME odpowiadających typom plików, których aplikacja potrzebuje. Jeśli korzystasz z tej opcji dodatkowej, musisz ustawić podstawowy typ MIME w elemencie setType() na "*/*".

EXTRA_ALLOW_MULTIPLE

Wartość logiczna określająca, czy użytkownik może wybrać więcej niż 1 plik naraz.

EXTRA_TITLE

Do użycia z opcją ACTION_CREATE_DOCUMENT w celu podania początkowej nazwy pliku.

EXTRA_LOCAL_ONLY

Wartość logiczna określająca, czy zwrócony plik musi być dostępny bezpośrednio z urządzenia, a nie wymagać pobrania z usługi zdalnej.

Kategoria

CATEGORY_OPENABLE

Aby zwrócić tylko „otwieralne” pliki, które można przedstawić jako strumień plików za pomocą openFileDescriptor().

Przykład intencjonalnego działania:

const val REQUEST_IMAGE_OPEN = 1

fun selectImage2() {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
        type = "image/*"
        addCategory(Intent.CATEGORY_OPENABLE)
    }
    // Only the system receives the ACTION_OPEN_DOCUMENT, so no need to test.
    startActivityForResult(intent, REQUEST_IMAGE_OPEN)
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_IMAGE_OPEN && resultCode == Activity.RESULT_OK) {
        val fullPhotoUri: Uri = data.data
        // Do work with full size photo saved at fullPhotoUri.
        ...
    }
}

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

Aplikacje innych firm nie mogą odpowiadać na intencje z działaniem ACTION_OPEN_DOCUMENT. Zamiast tego system otrzymuje tę intencję i wyświetla wszystkie pliki dostępne w różnych aplikacjach w ujednoliconym interfejsie użytkownika.

Aby udostępniać pliki aplikacji w tym interfejsie i umożliwiać ich otwieranie innym aplikacjom, musisz zaimplementować DocumentsProvider i uwzględnić filtr intencji PROVIDER_INTERFACE("android.content.action.DOCUMENTS_PROVIDER"), jak pokazano w tym przykładzie:

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

Więcej informacji o tym, jak umożliwić otwieranie plików zarządzanych przez Twoją aplikację z innych aplikacji, znajdziesz w artykule Otwieranie plików za pomocą platformy Storage Access Framework.

Działania lokalne

Zamawianie taksówki to typowe działanie lokalne. Utwórz filtr intencji, aby reklamować możliwość wykonania tego działania w aplikacji. Aby to zrobić, skorzystaj z informacji w następnej sekcji.

Zamów taksówkę

Komendy głosowe Google

• „Zamów mi taksówkę”
• „Zadzwoń po taksówkę”

(dotyczy tylko Wear OS)

Aby zamówić taksówkę, użyj czynności ACTION_RESERVE_TAXI_RESERVATION.

Uwaga: aplikacje muszą poprosić użytkownika o potwierdzenie przed wykonaniem tej czynności.

Czynność

ACTION_RESERVE_TAXI_RESERVATION

Identyfikator URI danych

Brak

Typ MIME

Brak

Dodatki

Brak

Przykład intencji:

fun callCar() {
    val intent = Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void callCar() {
    Intent intent = new Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="com.google.android.gms.actions.RESERVE_TAXI_RESERVATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Mapy

Wyświetlanie lokalizacji na mapie jest typowym działaniem w przypadku aplikacji mapowych. Utwórz filtr intencji, aby reklamować możliwość wykonania tego działania przez aplikację. Aby to zrobić, skorzystaj z informacji w następnej sekcji.

Wyświetlanie lokalizacji na mapie

Aby otworzyć mapę, użyj działania ACTION_VIEW i określ informacje o lokalizacji w danych intencji za pomocą jednego z tych schematów.

Czynność

ACTION_VIEW

Schemat URI danych

geo:latitude,longitude

Pokaż mapę w danej szerokości i długości geograficznej.

Przykład: "geo:47.6,-122.3"

geo:latitude,longitude?z=zoom

Pokaż mapę na danej długości i szerokości geograficznej przy określonym powiększeniu. Poziom powiększenia 1 pokazuje całą Ziemię, z centrum w danym punkcie lat,lng. Najwyższy (najbliższy) poziom powiększenia to 23.

Przykład: "geo:47.6,-122.3?z=11"

geo:0,0?q=lat,lng(label)

Wyświetlanie mapy na podanej długości i szerokości geograficznej z etykietą ciągu znaków.

Przykład: "geo:0,0?q=34.99,-106.61(Treasure)"

geo:0,0?q=my+street+address

Pokaż lokalizację „mój adres ulicy”, która może być konkretnym adresem lub zapytaniem o lokalizację.

Przykład: "geo:0,0?q=1600+Amphitheatre+Parkway%2C+CA"

Uwaga: wszystkie ciągi znaków przekazywane w URI geo muszą być zakodowane. Na przykład ciąg tekstowy 1st & Pike, Seattle zmieni się na 1st%20%26%20Pike%2C%20Seattle. Spacje w ciągu są kodowane za pomocą znaku %20 lub zastępowane znakiem plusa (+).

Typ MIME

Brak

Przykład intencji:

fun showMap(geoLocation: Uri) {
    val intent = Intent(Intent.ACTION_VIEW).apply {
        data = geoLocation
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void showMap(Uri geoLocation) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setData(geoLocation);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="geo" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Muzyka lub film

Poniżej znajdziesz najczęstsze działania w przypadku aplikacji muzycznych i wideo, w tym informacje potrzebne do utworzenia filtra intencji, aby reklamować możliwość wykonania danego działania w aplikacji.

Odtwarzanie pliku multimedialnego

Aby odtworzyć plik muzyczny, użyj działania ACTION_VIEW i określ lokalizację identyfikatora URI pliku w danych intencji.

Czynność

ACTION_VIEW

Schemat URI danych

file:<URI>

content:<URI>

http:<URL>

Typ MIME

"audio/*"

"application/ogg"

"application/x-ogg"

"application/itunes"

lub innych, których wymaga Twoja aplikacja.

Przykład intencji:

fun playMedia(file: Uri) {
    val intent = Intent(Intent.ACTION_VIEW).apply {
        data = file
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void playMedia(Uri file) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setData(file);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <data android:type="audio/*" />
        <data android:type="application/ogg" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

odtwarzanie muzyki na podstawie zapytania wyszukiwania;

Komendy głosowe Google

• „play michael jackson billie jean”

Aby odtwarzać muzykę na podstawie zapytania wyszukiwania, użyj intencji INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH. Aplikacja może wywołać tę intencję w odpowiedzi na polecenie głosowe użytkownika dotyczące odtwarzania muzyki. Aplikacja, która otrzymuje ten intencjonalny obiekt, wyszukuje w swoim katalogu treści pasujące do podanego zapytania i odtwarza je.

W tym zamiarze należy uwzględnić dodatkowy ciąg znaków EXTRA_MEDIA_FOCUS, który określa docelowy tryb wyszukiwania. Na przykład tryb wyszukiwania może określać, czy wyszukiwanie dotyczy nazwy wykonawcy czy utworu.

Czynność

INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH

Schemat URI danych

Brak

Typ MIME

Brak

Dodatki

MediaStore.EXTRA_MEDIA_FOCUS (pole wymagane)

Wskazuje tryb wyszukiwania: czy użytkownik szuka konkretnego wykonawcy, albumu, utworu czy playlisty. Większość trybów wyszukiwania wymaga dodatkowych informacji. Jeśli na przykład użytkownik chce posłuchać konkretnego utworu, jego zamiar może zawierać 3 dodatkowe elementy: tytuł utworu, wykonawcę i album. Ta intencja obsługuje te tryby wyszukiwania dla każdej wartości EXTRA_MEDIA_FOCUS:

Dowolny – "vnd.android.cursor.item/*"

odtwarzać dowolną muzykę, Aplikacja odbiorcza odtwarza muzykę na podstawie inteligentnego wyboru, np. ostatniej playlisty odsłuchanej przez użytkownika.

Dodatkowe funkcje:

• QUERY (wymagany): pusty ciąg znaków. Ta opcja jest zawsze udostępniana ze względu na zgodność wsteczną. Istniejące aplikacje, które nie znają trybów wyszukiwania, mogą przetwarzać ten zamiar jako wyszukiwanie nieustrukturyzowane.

Nieustrukturowany – "vnd.android.cursor.item/*"

odtworzyć konkretny utwór, album lub gatunek na podstawie nieustrukturyzowanego zapytania; Aplikacje mogą generować zamiar w tym trybie wyszukiwania, gdy nie mogą zidentyfikować typu treści, które użytkownik chce odsłuchać. W miarę możliwości używaj bardziej szczegółowych trybów wyszukiwania.

Dodatkowe funkcje:

• QUERY (wymagany): ciąg znaków zawierający dowolną kombinację wykonawcy, albumu, tytułu utworu lub gatunku.

Gatunek –Audio.Genres.ENTRY_CONTENT_TYPE

odtwarzanie muzyki określonego gatunku;

Dodatkowe funkcje:

• "android.intent.extra.genre" (wymagany) – gatunek.
• QUERY (wymagany): gatunek. Ta opcja jest zawsze dostępna ze względu na zgodność wsteczną. Istniejące aplikacje, które nie znają trybów wyszukiwania, mogą przetwarzać ten zamiar jako wyszukiwanie nieustrukturyzowane.

Artysta –Audio.Artists.ENTRY_CONTENT_TYPE

odtwarzanie muzyki konkretnego wykonawcy;

Dodatkowe funkcje:

• EXTRA_MEDIA_ARTIST (wymagany): wykonawca.
• "android.intent.extra.genre": gatunek.
• QUERY (wymagany): ciąg znaków zawierający dowolną kombinację wykonawcy lub gatunku. Ta opcja jest zawsze udostępniana ze względu na zgodność wsteczną. Istniejące aplikacje, które nie znają trybów wyszukiwania, mogą przetwarzać ten zamiar jako wyszukiwanie nieustrukturyzowane.

Album – Audio.Albums.ENTRY_CONTENT_TYPE

odtwarzanie muzyki z konkretnego albumu;

Dodatkowe funkcje:

• EXTRA_MEDIA_ALBUM (wymagany): album.
• EXTRA_MEDIA_ARTIST: wykonawca.
• "android.intent.extra.genre": gatunek.
• QUERY (wymagany): ciąg znaków zawierający dowolną kombinację albumu lub wykonawcy. Ta opcja jest zawsze udostępniana ze względu na zgodność wsteczną. Istniejące aplikacje, które nie znają trybów wyszukiwania, mogą przetwarzać ten zamiar jako wyszukiwanie nieustrukturyzowane.

Utwór – "vnd.android.cursor.item/audio"

odtworzenie konkretnego utworu;

Dodatkowe funkcje:

• EXTRA_MEDIA_ALBUM: album.
• EXTRA_MEDIA_ARTIST: wykonawca.
• "android.intent.extra.genre": gatunek.
• EXTRA_MEDIA_TITLE (wymagany): nazwa utworu.
• QUERY (wymagany): ciąg znaków zawierający dowolną kombinację albumu, wykonawcy, gatunku lub tytułu. Ta opcja jest zawsze dostępna ze względu na zgodność wsteczną. Istniejące aplikacje, które nie znają trybów wyszukiwania, mogą przetwarzać ten zamiar jako wyszukiwanie nieustrukturyzowane.

Playlista – Audio.Playlists.ENTRY_CONTENT_TYPE

odtwarzanie konkretnej playlisty lub playlisty, która spełnia określone kryteria, aby uzyskać dodatkowe opcje;

Dodatkowe funkcje:

• EXTRA_MEDIA_ALBUM: album.
• EXTRA_MEDIA_ARTIST: wykonawca.
• "android.intent.extra.genre": gatunek.
• "android.intent.extra.playlist": playlista.
• EXTRA_MEDIA_TITLE: nazwa utworu, na którym oparta jest playlista.
• QUERY (wymagany): ciąg znaków zawierający dowolną kombinację albumu, wykonawcy, gatunku, playlisty lub tytułu. Ta opcja jest zawsze udostępniana ze względu na zgodność wsteczną. Istniejące aplikacje, które nie znają trybów wyszukiwania, mogą przetwarzać ten zamiar jako wyszukiwanie nieustrukturyzowane.

Przykład intencji:

Jeśli użytkownik chce słuchać muzyki danego wykonawcy, aplikacja wyszukiwania może wygenerować taki zamiar:

fun playSearchArtist(artist: String) {
    val intent = Intent(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH).apply {
        putExtra(MediaStore.EXTRA_MEDIA_FOCUS, MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE)
        putExtra(MediaStore.EXTRA_MEDIA_ARTIST, artist)
        putExtra(SearchManager.QUERY, artist)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void playSearchArtist(String artist) {
    Intent intent = new Intent(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH);
    intent.putExtra(MediaStore.EXTRA_MEDIA_FOCUS,
                    MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE);
    intent.putExtra(MediaStore.EXTRA_MEDIA_ARTIST, artist);
    intent.putExtra(SearchManager.QUERY, artist);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.MEDIA_PLAY_FROM_SEARCH" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Podczas obsługi tej intencji w swojej aktywności sprawdź wartość dodatkowego parametru EXTRA_MEDIA_FOCUS w wejściowym parametrze Intent, aby określić tryb wyszukiwania. Gdy Twoja aktywność zidentyfikuje tryb wyszukiwania, zapoznaj się z wartościami dodatkowych opcji w tym trybie. Dzięki tym informacjom aplikacja może przeprowadzić wyszukiwanie w swoim katalogu, aby odtworzyć treści pasujące do zapytania. Pokazuje to poniższy przykład.

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    if (intent.action.compareTo(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH) == 0) {

        val mediaFocus: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_FOCUS)
        val query: String? = intent.getStringExtra(SearchManager.QUERY)

        // Some of these extras might not be available depending on the search mode.
        val album: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ALBUM)
        val artist: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ARTIST)
        val genre: String? = intent.getStringExtra("android.intent.extra.genre")
        val playlist: String? = intent.getStringExtra("android.intent.extra.playlist")
        val title: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_TITLE)

        // Determine the search mode and use the corresponding extras.
        when {
            mediaFocus == null -> {
                // 'Unstructured' search mode (backward compatible)
                playUnstructuredSearch(query)
            }
            mediaFocus.compareTo("vnd.android.cursor.item/*") == 0 -> {
                if (query?.isNotEmpty() == true) {
                    // 'Unstructured' search mode.
                    playUnstructuredSearch(query)
                } else {
                    // 'Any' search mode.
                    playResumeLastPlaylist()
                }
            }
            mediaFocus.compareTo(MediaStore.Audio.Genres.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Genre' search mode.
                playGenre(genre)
            }
            mediaFocus.compareTo(MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Artist' search mode.
                playArtist(artist, genre)
            }
            mediaFocus.compareTo(MediaStore.Audio.Albums.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Album' search mode.
                playAlbum(album, artist)
            }
            mediaFocus.compareTo("vnd.android.cursor.item/audio") == 0 -> {
                // 'Song' search mode.
                playSong(album, artist, genre, title)
            }
            mediaFocus.compareTo(MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Playlist' search mode.
                playPlaylist(album, artist, genre, playlist, title)
            }
        }
    }
}

protected void onCreate(Bundle savedInstanceState) {
    //...
    Intent intent = this.getIntent();
    if (intent.getAction().compareTo(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH) == 0) {

        String mediaFocus = intent.getStringExtra(MediaStore.EXTRA_MEDIA_FOCUS);
        String query = intent.getStringExtra(SearchManager.QUERY);

        // Some of these extras might not be available depending on the search mode.
        String album = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ALBUM);
        String artist = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ARTIST);
        String genre = intent.getStringExtra("android.intent.extra.genre");
        String playlist = intent.getStringExtra("android.intent.extra.playlist");
        String title = intent.getStringExtra(MediaStore.EXTRA_MEDIA_TITLE);

        // Determine the search mode and use the corresponding extras.
        if (mediaFocus == null) {
            // 'Unstructured' search mode (backward compatible).
            playUnstructuredSearch(query);

        } else if (mediaFocus.compareTo("vnd.android.cursor.item/*") == 0) {
            if (query.isEmpty()) {
                // 'Any' search mode.
                playResumeLastPlaylist();
            } else {
                // 'Unstructured' search mode.
                playUnstructuredSearch(query);
            }

        } else if (mediaFocus.compareTo(MediaStore.Audio.Genres.ENTRY_CONTENT_TYPE) == 0) {
            // 'Genre' search mode.
            playGenre(genre);

        } else if (mediaFocus.compareTo(MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE) == 0) {
            // 'Artist' search mode.
            playArtist(artist, genre);

        } else if (mediaFocus.compareTo(MediaStore.Audio.Albums.ENTRY_CONTENT_TYPE) == 0) {
            // 'Album' search mode.
            playAlbum(album, artist);

        } else if (mediaFocus.compareTo("vnd.android.cursor.item/audio") == 0) {
            // 'Song' search mode.
            playSong(album, artist, genre, title);

        } else if (mediaFocus.compareTo(MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE) == 0) {
            // 'Playlist' search mode.
            playPlaylist(album, artist, genre, playlist, title);
        }
    }
}

Nowa notatka

Tworzenie notatek to typowa czynność w przypadku aplikacji do tworzenia notatek. Utwórz filtr intencji, aby reklamować możliwość wykonania tego działania przez aplikację. Aby to zrobić, skorzystaj z informacji w następnej sekcji.

Tworzenie notatki

Aby utworzyć nową notatkę, użyj działania ACTION_CREATE_NOTE i określ szczegóły notatki, takie jak temat i tekst, za pomocą podanych poniżej dodatków.

Uwaga: aplikacje muszą poprosić użytkownika o potwierdzenie przed wykonaniem tej czynności.

Czynność

ACTION_CREATE_NOTE

Schemat URI danych

Brak

Typ MIME

PLAIN_TEXT_TYPE

"*/*"

Dodatki

EXTRA_NAME

Ciąg tekstowy wskazujący tytuł lub temat notatki.

EXTRA_TEXT

Ciąg tekstowy zawierający treść notatki.

Przykład intencji:

Kotlin

fun createNote(subject: String, text: String) {
    val intent = Intent(NoteIntents.ACTION_CREATE_NOTE).apply {
        putExtra(NoteIntents.EXTRA_NAME, subject)
        putExtra(NoteIntents.EXTRA_TEXT, text)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void createNote(String subject, String text) {
    Intent intent = new Intent(NoteIntents.ACTION_CREATE_NOTE)
            .putExtra(NoteIntents.EXTRA_NAME, subject)
            .putExtra(NoteIntents.EXTRA_TEXT, text);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="com.google.android.gms.actions.CREATE_NOTE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="*/*" />
    </intent-filter>
</activity>

Telefon

Rozpoczynanie połączeń jest częstym działaniem w przypadku aplikacji telefonicznych. Utwórz filtr intencji, aby reklamować możliwość wykonania tego działania przez aplikację. Aby to zrobić, skorzystaj z informacji w następnej sekcji.

Zainicjowanie połączenia głosowego

Aby otworzyć aplikację telefonu i wybrać numer telefonu, użyj działania ACTION_DIAL i określ numer telefonu za pomocą tego schematu URI. Po otwarciu aplikacji telefonicznej wyświetlany jest numer telefonu. Aby rozpocząć połączenie, użytkownik musi kliknąć przycisk Zadzwoń.

Komendy głosowe Google

• „Zadzwoń pod numer 555-5555”.
• „Zadzwoń do Boba”
• „wywołanie poczty głosowej”

Aby zadzwonić bezpośrednio, użyj działania ACTION_CALL i podaj numer telefonu za pomocą tego schematu URI. Gdy otworzy się aplikacja Telefon, rozpocznie się połączenie. Użytkownik nie musi klikać przycisku Zadzwoń.

Aby wykonać działanie ACTION_CALL, musisz dodać do pliku manifestu uprawnienia CALL_PHONE:

<uses-permission android:name="android.permission.CALL_PHONE" />

Czynność

• ACTION_DIAL – otwiera aplikację Telefon lub Dialer.
• ACTION_CALL – nawiązuje połączenie telefoniczne (wymaga uprawnienia CALL_PHONE).

Schemat URI danych

• tel:<phone-number>
• voicemail:<phone-number>

Typ MIME

Brak

Prawidłowe numery telefonów to te zdefiniowane w specyfikacji IETF RFC 3966. Przykłady prawidłowych treści:

• tel:2125551212
• tel:(212) 555 1212

Dialer w aplikacji Telefon dobrze radzi sobie z normalizacją schematów, takich jak numery telefonów. Oznacza to, że opisana wyżej metoda Uri.parse() nie wymaga ściśle określonego schematu. Jeśli jednak nie próbowałeś jeszcze żadnego schematu lub nie masz pewności, czy da się go zastosować, użyj zamiast tego metody Uri.fromParts().

Przykład intencji:

Kotlin

fun dialPhoneNumber(phoneNumber: String) {
    val intent = Intent(Intent.ACTION_DIAL).apply {
        data = Uri.parse("tel:$phoneNumber")
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void dialPhoneNumber(String phoneNumber) {
    Intent intent = new Intent(Intent.ACTION_DIAL);
    intent.setData(Uri.parse("tel:" + phoneNumber));
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Szukaj

Poniżej znajdziesz najczęstsze działania związane z aplikacją wyszukiwania, w tym informacje potrzebne do utworzenia filtra intencji, aby reklamować możliwość wykonania danego działania przez aplikację.

Wyszukiwanie w konkretnej aplikacji

Komendy głosowe Google

• „wyszukaj filmiki z kotami w aplikacji myvideo”

Aby umożliwić wyszukiwanie w kontekście aplikacji, zadeklaruj w niej filtr intencji z działaniem SEARCH_ACTION, jak w tym przykładzie filtra intencji.

Uwaga: nie zalecamy używania SEARCH_ACTION do wyszukiwania aplikacji. Zamiast tego zastosuj działanieGET_THING, aby skorzystać z wbudowanego w Asystencie Google mechanizmu wyszukiwania w aplikacji. Więcej informacji znajdziesz w dokumentacji Działania aplikacji dotyczącej Asystenta Google.

Czynność

"com.google.android.gms.actions.SEARCH_ACTION"

Obsługa zapytań wyszukiwania z usług komend głosowych Google.

Dodatki

QUERY

Ciąg tekstowy zawierający zapytanie.

Przykład filtra intencji:

<activity android:name=".SearchActivity">
    <intent-filter>
        <action android:name="com.google.android.gms.actions.SEARCH_ACTION"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</activity>

Wyszukiwanie w internecie

Aby rozpocząć wyszukiwanie w internecie, użyj działania ACTION_WEB_SEARCH i wskaż ciąg znaków w dodatku SearchManager.QUERY.

Czynność

ACTION_WEB_SEARCH

Schemat URI danych

Brak

Typ MIME

Brak

Dodatki

SearchManager.QUERY

Ciąg wyszukiwania.

Przykład intencji:

Kotlin

fun searchWeb(query: String) {
    val intent = Intent(Intent.ACTION_WEB_SEARCH).apply {
        putExtra(SearchManager.QUERY, query)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void searchWeb(String query) {
    Intent intent = new Intent(Intent.ACTION_WEB_SEARCH);
    intent.putExtra(SearchManager.QUERY, query);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Ustawienia

Aby otworzyć ekran w aplikacji Ustawienia, gdy aplikacja wymaga od użytkownika wprowadzenia zmian, użyj jednej z tych akcji intencyjnych:

Czynność

ACTION_SETTINGS
ACTION_WIRELESS_SETTINGS
ACTION_AIRPLANE_MODE_SETTINGS
ACTION_WIFI_SETTINGS
ACTION_APN_SETTINGS
ACTION_BLUETOOTH_SETTINGS
ACTION_DATE_SETTINGS
ACTION_LOCALE_SETTINGS
ACTION_INPUT_METHOD_SETTINGS
ACTION_DISPLAY_SETTINGS
ACTION_SECURITY_SETTINGS
ACTION_LOCATION_SOURCE_SETTINGS
ACTION_INTERNAL_STORAGE_SETTINGS
ACTION_MEMORY_CARD_SETTINGS

Aby uzyskać więcej informacji o dodatkowych ekranach ustawień, zapoznaj się z dokumentacją Settings .

Schemat URI danych

Brak

Typ MIME

Brak

Przykład intencji:

Kotlin

fun openWifiSettings() {
    val intent = Intent(Settings.ACTION_WIFI_SETTINGS)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void openWifiSettings() {
    Intent intent = new Intent(Settings.ACTION_WIFI_SETTINGS);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Wysyłanie SMS-ów

Tworzenie SMS-ów lub MMS-ów z załącznikiem jest częstym działaniem w przypadku aplikacji do obsługi wiadomości tekstowych. Utwórz filtr intencji, aby reklamować możliwość wykonania tego działania przez aplikację. Aby to zrobić, skorzystaj z informacji w następnej sekcji.

Tworzenie SMS-a/MMS-a z załącznikiem

Aby rozpocząć wysyłanie SMS-a lub MMS-a, użyj jednej z tych akcji intencyjnych i określ szczegóły wiadomości, takie jak numer telefonu, temat i treść wiadomości, za pomocą podanych niżej dodatkowych kluczy.

Czynność

ACTION_SENDTO lub
ACTION_SEND lub
ACTION_SEND_MULTIPLE

Schemat URI danych

sms:<phone_number>

smsto:<phone_number>

mms:<phone_number>

mmsto:<phone_number>

Wszystkie te schematy są obsługiwane w taki sam sposób.

Typ MIME

"text/plain"

"image/*"

"video/*"

Dodatki

"subject"

Ciąg znaków dla tematu wiadomości (zwykle tylko w przypadku MMS-ów).

"sms_body"

Tekst SMS-a.

EXTRA_STREAM

 Uri wskazujący obraz lub film do załączenia. Jeśli używasz działania ACTION_SEND_MULTIPLE, dodatkowym elementem jest ArrayList obiektów Uri wskazujących obrazy lub filmy do załączenia.

Przykład intencji:

Kotlin

fun composeMmsMessage(message: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SENDTO).apply {
        type = HTTP.PLAIN_TEXT_TYPE
        putExtra("sms_body", message)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void composeMmsMessage(String message, Uri attachment) {
    Intent intent = new Intent(Intent.ACTION_SENDTO);
    intent.setType(HTTP.PLAIN_TEXT_TYPE);
    intent.putExtra("sms_body", message);
    intent.putExtra(Intent.EXTRA_STREAM, attachment);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Jeśli chcesz mieć pewność, że Twoja intencja jest obsługiwana tylko przez aplikację do obsługi wiadomości tekstowych, a nie przez inne aplikacje do obsługi poczty e-mail lub aplikacji społecznościowych, użyj działania ACTION_SENDTO i uwzględnij schemat danych "smsto:", jak w tym przykładzie:

Kotlin

fun composeMmsMessage(message: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SEND).apply {
        data = Uri.parse("smsto:")  // Only SMS apps respond to this.
        putExtra("sms_body", message)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void composeMmsMessage(String message, Uri attachment) {
    Intent intent = new Intent(Intent.ACTION_SEND);
    intent.setData(Uri.parse("smsto:"));  // Only SMS apps respond to this.
    intent.putExtra("sms_body", message);
    intent.putExtra(Intent.EXTRA_STREAM, attachment);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Przykład filtra intencji:

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

Uwaga: jeśli opracowujesz aplikację do obsługi SMS-ów i MMS-ów, musisz zaimplementować filtry intencji dla kilku dodatkowych działań, aby była ona dostępna jako domyślna aplikacja do obsługi SMS-ów w wersji Androida 4.4 lub nowszej. Więcej informacji znajdziesz w dokumentacji na stronie Telephony.

Przeglądarka

Ładowanie adresu URL strony internetowej jest typowym działaniem w przypadku aplikacji przeglądarek internetowych. Utwórz filtr intencji, aby reklamować możliwość wykonania tego działania przez aplikację. Aby to zrobić, skorzystaj z informacji w następnej sekcji.

Ładowanie adresu URL

Komendy głosowe Google

• „open example.com”

Aby otworzyć stronę internetową, użyj działania ACTION_VIEW i wskaż adres URL witryny w danych intencji.

Czynność

ACTION_VIEW

Schemat URI danych

http:<URL>
https:<URL>

Typ MIME

"text/plain"

"text/html"

"application/xhtml+xml"

"application/vnd.wap.xhtml+xml"

Przykład intencji:

Kotlin

fun openWebPage(url: String) {
    val webpage: Uri = Uri.parse(url)
    val intent = Intent(Intent.ACTION_VIEW, webpage)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void openWebPage(String url) {
    Uri webpage = Uri.parse(url);
    Intent intent = new Intent(Intent.ACTION_VIEW, webpage);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

Przykład filtra intencji:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <!-- Include the host attribute if you want your app to respond
             only to URLs with your app's domain. -->
        <data android:scheme="http" android:host="www.example.com" />
        <category android:name="android.intent.category.DEFAULT" />
        <!-- The BROWSABLE category is required to get links from web pages. -->
        <category android:name="android.intent.category.BROWSABLE" />
    </intent-filter>
</activity>

Wskazówka: jeśli aplikacja na Androida zapewnia funkcje podobne do tych, które oferuje Twoja witryna, dodaj filtr intencji dla adresów URL, które wskazują na Twoją witrynę. Jeśli użytkownicy mają zainstalowaną Twoją aplikację, linki w e-mailach lub na innych stronach internetowych odsyłające do Twojej witryny otwierają aplikację na Androida zamiast strony internetowej. Więcej informacji znajdziesz w artykule Obsługa linków aplikacji na Androida.

Od Androida 12 (poziom interfejsu API 31) ogólny zamiar internetowy jest przekształcany w działanie w aplikacji tylko wtedy, gdy aplikacja została zatwierdzona dla konkretnej domeny zawartej w tym zamiarze internetowym. Jeśli aplikacja nie jest zatwierdzona w przypadku domeny, intencja internetowa zostanie przekierowana do domyślnej przeglądarki użytkownika.

Weryfikowanie intencji za pomocą Android Debug Bridge

Aby sprawdzić, czy aplikacja reaguje na intencje, które chcesz obsługiwać, możesz użyć narzędzia adb, aby wywołać określone intencje. W tym celu:

1. Skonfiguruj urządzenie z Androidem na potrzeby tworzenia aplikacji lub użyj urządzenia wirtualnego.
2. Zainstaluj wersję aplikacji, która obsługuje intencje, które chcesz obsługiwać.
3. Wywołaj intencję za pomocą adb:

   adb shell am start -a <ACTION> -t <MIME_TYPE> -d <DATA> \
     -e <EXTRA_NAME> <EXTRA_VALUE> -n <ACTIVITY>
   

   Na przykład:

   adb shell am start -a android.intent.action.DIAL \
     -d tel:555-5555 -n org.example.MyApp/.MyActivity
   

4. Jeśli zdefiniujesz wymagane filtry intencji, obsługuj intencję.

Więcej informacji znajdziesz w artykule Wykonywanie poleceń w powłoce.