Pozwól innym aplikacjom uruchamiać Twoją aktywność

Jeśli Twoja aplikacja może wykonać działanie, które może być przydatne dla innej aplikacji, przygotuj ją do reagowania na żądania działania, określając odpowiedni filtr intencji w aktywności.

Jeśli na przykład tworzysz aplikację społecznościową, która może udostępniać wiadomości lub zdjęcia znajomym użytkownika, obsługuj intencję ACTION_SEND. Gdy użytkownicy zainicjują działanie „udostępnij” w innej aplikacji, Twoja aplikacja pojawi się jako opcja w oknie wyboru (nazywanym też oknem uściślania), jak pokazano na rysunku 1.

Rysunek 1. Okno wyboru.

Aby umożliwić innym aplikacjom uruchamianie aktywności w ten sposób, musisz dodać element <intent-filter> w pliku manifestu dla odpowiedniego elementu <activity>.

Gdy aplikacja instalowana zostanie zainstalowana na urządzeniu, system zidentyfikuje filtry intencji i doda te informacje do wewnętrznego katalogu intencji obsługiwanych przez wszystkie zainstalowane aplikacje. Gdy aplikacja wywołuje startActivity() lub startActivityForResult() z niejawną intencją, system sprawdza, czy są dostępne aktywności, które mogą na nią odpowiedzieć.

Dodawanie filtra intencji

Aby prawidłowo określić, które intencje może obsługiwać aktywność, każdy dodany filtr intencji powinien być jak najbardziej szczegółowy pod względem typu działania i danych, które akceptuje aktywność.

System może wysłać dany obiekt Intent do aktywności, jeśli ma ona filtr intencji, który spełnia te kryteria obiektu Intent:

Działanie
Ciąg tekstowy określający działanie, które ma zostać wykonane. Zwykle jest to jedna z wartości zdefiniowanych przez platformę, np. ACTION_SEND lub ACTION_VIEW.

Określ to w filtrze intencji za pomocą elementu <action>. Wartość podana w tym elemencie musi być pełną nazwą działania w postaci ciągu znaków, a nie stałą interfejsu API, jak pokazano w przykładach na tej stronie.

Dane
Opis danych powiązanych z intencją.

Określ to w filtrze intencji za pomocą elementu <data>. Za pomocą co najmniej 1 atrybutu w tym elemencie możesz określić typ MIME, prefiks identyfikatora URI, schemat URI lub kombinację tych i innych elementów, które wskazują akceptowany typ danych.

Uwaga: jeśli nie musisz deklarować szczegółów dotyczących danych Uri, np. gdy aktywność obsługuje inny rodzaj „dodatkowych” danych, zamiast identyfikatora URI podaj tylko atrybut android:mimeType, aby zadeklarować typ danych obsługiwanych przez aktywność, np. text/plain lub image/jpeg.

Kategoria
Udostępnia dodatkowy sposób na scharakteryzowanie aktywności obsługującej intencję, zwykle powiązanej z gestem użytkownika lub lokalizacją, z której została uruchomiona. System obsługuje kilka różnych kategorii, ale większość z nich jest rzadko używana. Jednak wszystkie intencje niejawne są domyślnie definiowane za pomocą CATEGORY_DEFAULT.

Określ to w filtrze intencji za pomocą elementu <category>.

W filtrze intencji możesz zadeklarować, które kryteria akceptuje Twoja aktywność, deklarując każde z nich za pomocą odpowiednich elementów XML zagnieżdżonych w elemencie <intent-filter>.

Oto przykład aktywności z filtrem intencji, który obsługuje intencję ACTION_SEND, gdy typ danych to tekst lub obraz:

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

Wskazówka: jeśli chcesz, aby ikona w oknie wyboru różniła się od domyślnej ikony aktywności, dodaj android:icon w elemencie <intent-filter>.

Każda przychodząca intencja określa tylko jedno działanie i jeden typ danych, ale w każdym elemencie <intent-filter> można zadeklarować wiele instancji elementów <action>, <category> i <data>.

Jeśli jakieś 2 pary działania i danych wykluczają się wzajemnie, utwórz osobne filtry intencji, aby określić, które działania są dopuszczalne w przypadku poszczególnych typów danych.

Załóżmy na przykład, że Twoja aktywność obsługuje zarówno tekst, jak i obrazy w przypadku intencji ACTION_SEND i ACTION_SENDTO. W takim przypadku musisz zdefiniować 2 osobne filtry intencji dla tych 2 działań, ponieważ intencja ACTION_SENDTO musi używać danych Uri, aby określić adres odbiorcy za pomocą schematu URI send lub sendto. Zostało to przedstawione w tym przykładzie:

<activity android:name="ShareActivity">
    <!-- Filter for sending text; accepts SENDTO action with sms URI schemes -->
    <intent-filter>
        <action android:name="android.intent.action.SENDTO"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:scheme="sms" />
        <data android:scheme="smsto" />
    </intent-filter>
    <!-- Filter for sending text or images; accepts SEND action and text or image data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="image/*"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
</activity>

Uwaga: aby otrzymywać intencje niejawne, musisz uwzględnić w filtrze intencji kategorię CATEGORY_DEFAULT. Metody startActivity() i startActivityForResult() traktują wszystkie intencje tak, jakby deklarowały kategorię CATEGORY_DEFAULT. Jeśli nie zadeklarujesz jej w filtrze intencji, żadne intencje niejawne nie będą prowadzić do Twojej aktywności.

Więcej informacji o wysyłaniu i odbieraniu intencji ACTION_SEND, które wykonują działania związane z udostępnianiem społecznościowym, znajdziesz w artykule Odbieranie prostych danych z innych aplikacji. Przydatne informacje o udostępnianiu danych znajdziesz też w artykułach Udostępnianie prostych danych i Udostępnianie plików.

Obsługa intencji w aktywności

Aby zdecydować, jakie działanie podjąć w ramach aktywności, przeczytaj Intent, który służy do jej rozpoczęcia.

Gdy aktywność się rozpocznie, wywołaj getIntent(), aby pobrać Intent, który ją uruchomił. Możesz to zrobić w dowolnym momencie cyklu życia aktywności, ale zwykle robi się to podczas wczesnych wywołań zwrotnych, takich jak onCreate() lub onStart().

Zostało to przedstawione w tym przykładzie:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    setContentView(R.layout.main)

    val data: Uri? = intent?.data

    // Figure out what to do based on the intent type
    if (intent?.type?.startsWith("image/") == true) {
        // Handle intents with image data
    } else if (intent?.type == "text/plain") {
        // Handle intents with text
    }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    setContentView(R.layout.main);

    // Get the intent that started this activity
    Intent intent = getIntent();
    Uri data = intent.getData();

    // Figure out what to do based on the intent type
    if (intent.getType().indexOf("image/") != -1) {
        // Handle intents with image data
    } else if (intent.getType().equals("text/plain")) {
        // Handle intents with text
    }
}

Zwracanie wyniku

Jeśli chcesz zwrócić wynik do aktywności, która wywołała Twoją, wywołaj setResult(), aby określić kod wyniku i wynik Intent. Gdy operacja zostanie zakończona, a użytkownik wróci do pierwotnej aktywności, wywołaj finish(), aby zamknąć i zniszczyć aktywność. Zostało to przedstawione w tym przykładzie:

Kotlin

// Create intent to deliver some kind of result data
Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")).also { result ->
    setResult(Activity.RESULT_OK, result)
}
finish()

Java

// Create intent to deliver some kind of result data
Intent result = new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri"));
setResult(Activity.RESULT_OK, result);
finish();

Zawsze musisz podać kod wyniku. Zwykle jest to RESULT_OK lub RESULT_CANCELED. W razie potrzeby możesz przesłać dodatkowe dane za pomocą Intent.

Uwaga: domyślnie wynik jest ustawiony na RESULT_CANCELED. Jeśli więc użytkownik kliknie przycisk Wstecz przed zakończeniem działania i przed ustawieniem wyniku, pierwotna aktywność otrzyma wynik „anulowano”.

Jeśli chcesz po prostu zwrócić liczbę całkowitą, która wskazuje jedną z kilku opcji wyniku, możesz ustawić kod wyniku na dowolną wartość większą niż 0. Jeśli używasz kodu wyniku do dostarczenia liczby całkowitej i nie musisz uwzględniać Intent, możesz wywołać setResult() i przekazać tylko kod wyniku:

Kotlin

setResult(RESULT_COLOR_RED)
finish()

Java

setResult(RESULT_COLOR_RED);
finish();

W takim przypadku może być tylko kilka możliwych wyników, więc kod wyniku jest lokalnie zdefiniowaną liczbą całkowitą (większą niż 0). To rozwiązanie sprawdza się, gdy zwracasz wynik do aktywności we własnej aplikacji, ponieważ aktywność, która otrzymuje wynik, może odwoływać się do stałej publicznej, aby określić wartość kodu wyniku.

Uwaga: nie musisz sprawdzać, czy aktywność została rozpoczęta za pomocą startActivity() czy startActivityForResult(). Jeśli intencja, która uruchomiła aktywność, może oczekiwać wyniku, po prostu wywołaj setResult(). Jeśli aktywność, z której pochodzi wywołanie, wywołała metodę startActivityForResult(), system dostarczy jej wynik podany w metodzie setResult(). W przeciwnym razie wynik zostanie zignorowany.