Menerima data sederhana dari aplikasi lain

Seperti halnya aplikasi dapat mengirim data ke aplikasi lain, aplikasi juga dapat menerima data dari aplikasi lain. Pikirkan tentang cara pengguna berinteraksi dengan aplikasi Anda dan jenis data apa yang ingin Anda terima dari aplikasi lain. Misalnya, aplikasi jaringan sosial mungkin tertarik untuk menerima konten teks, seperti URL web yang menarik, dari aplikasi lain.

Pengguna aplikasi lain sering mengirim data ke aplikasi Anda melalui Android Sharesheet atau intent resolver. Aplikasi yang mengirim data ke aplikasi Anda harus menetapkan jenis MIME untuk data tersebut. Aplikasi Anda dapat menerima data yang dikirim oleh aplikasi lain dengan cara berikut:

  • Activity dengan tag intent-filter yang cocok di manifes
  • Sharing Shortcut yang dipublikasikan oleh aplikasi Anda.

Target Berbagi Langsung adalah deep link ke Aktivitas tertentu dalam aplikasi Anda. Target ini sering mewakili seseorang atau grup, dan Android Sharesheet menunjukkannya. Misalnya, aplikasi pesan dapat menyediakan target Berbagi Langsung untuk orang yang melakukan deep link langsung ke percakapan dengan orang tersebut. Lihat Menyediakan target Berbagi Langsung untuk petunjuk detail.

Mendukung jenis MIME

Idealnya, aplikasi harus dapat menerima rentang jenis MIME seluas mungkin. Misalnya, aplikasi pesan yang dirancang untuk mengirim teks, gambar, dan video idealnya mendukung penerimaan text/*, image/*, dan video/*. Berikut ini beberapa jenis MIME umum untuk mengirim dan menerima data sederhana di Android.

Penerima mendaftar untuk Pengirim mengirim
text/*
  • text/plain
  • text/rtf
  • text/html
  • text/json
`image/*`
  • image/jpg
  • image/png
  • image/gif
video/*
  • video/mp4
  • video/3gp
Ekstensi file yang didukung application/pdf

Lihat registry resmi IANA untuk jenis media MIME.

Buat target berbagi yang bagus

Saat pengguna mengetuk target berbagi yang terkait dengan aktivitas tertentu, mereka harus dapat mengonfirmasi dan mengedit konten yang dibagikan sebelum menggunakannya. Hal ini sangat penting untuk data teks.

Menerima data dengan aktivitas

Menerima data dengan aktivitas melibatkan update manifes, menangani konten yang masuk, dan memastikan bahwa pengguna mengenali aplikasi Anda.

Mengupdate manifes Anda

Filter intent memberi tahu sistem intent mana yang diterima komponen aplikasi. Serupa dengan cara membuat intent dengan tindakan ACTION_SEND di pelajaran Mengirimkan data sederhana ke aplikasi lain, Anda membuat filter intent untuk menerima intent dengan tindakan ini. Anda menentukan filter intent dalam manifes menggunakan elemen <intent-filter>. Misalnya, jika aplikasi Anda menangani penerimaan konten teks, manifes yang menyertakan satu atau beberapa gambar dari jenis apa pun akan terlihat seperti cuplikan berikut:

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

Saat aplikasi lain mencoba membagikan salah satu hal ini dengan membuat intent dan meneruskannya ke startActivity(), aplikasi Anda akan tercantum sebagai opsi di Android Sharesheet atau resolver intent. Jika pengguna memilih aplikasi Anda, tindakan ini akan memulai aktivitas yang sesuai (.ui.MyActivity dalam contoh sebelumnya). Selanjutnya, Andalah yang harus menangani konten tersebut dengan tepat dalam kode dan UI.

Menangani konten yang masuk

Untuk menangani konten yang dikirim oleh Intent, panggil getIntent() untuk mendapatkan objek Intent. Setelah mendapatkan objek ini, Anda dapat memeriksa isinya untuk menentukan langkah selanjutnya. Jika aktivitas ini dapat dimulai dari bagian sistem lainnya (seperti peluncur), pertimbangkan hal ini saat memeriksa intent tersebut.

Harap berhati-hati untuk memeriksa data yang masuk, Anda tidak pernah tahu apa yang mungkin dikirim oleh aplikasi lain. Misalnya, jenis MIME yang ditetapkan mungkin salah, atau gambar yang dikirim mungkin sangat besar. Selain itu, ingatlah untuk memproses data biner dalam thread terpisah, bukan di thread utama ("UI").

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    when {
        intent?.action == Intent.ACTION_SEND -> {
            if ("text/plain" == intent.type) {
                handleSendText(intent) // Handle text being sent
            } else if (intent.type?.startsWith("image/") == true) {
                handleSendImage(intent) // Handle single image being sent
            }
        }
        intent?.action == Intent.ACTION_SEND_MULTIPLE
                && intent.type?.startsWith("image/") == true -> {
                handleSendMultipleImages(intent) // Handle multiple images being sent
        }
        else -> {
            // Handle other intents, such as being started from the home screen
        }
    }
    ...
}

private fun handleSendText(intent: Intent) {
    intent.getStringExtra(Intent.EXTRA_TEXT)?.let {
        // Update UI to reflect text being shared
    }
}

private fun handleSendImage(intent: Intent) {
    (intent.getParcelableExtra<Parcelable>(Intent.EXTRA_STREAM) as? Uri)?.let {
        // Update UI to reflect image being shared
    }
}

private fun handleSendMultipleImages(intent: Intent) {
    intent.getParcelableArrayListExtra<Parcelable>(Intent.EXTRA_STREAM)?.let {
        // Update UI to reflect multiple images being shared
    }
}

Java

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

Mengupdate UI setelah menerima data dapat semudah mengisi EditText, atau bisa lebih rumit seperti menerapkan filter foto yang menarik ke gambar. Aplikasi Anda dapat memilih apa yang terjadi selanjutnya.

Memastikan pengguna mengenali aplikasi Anda

Aplikasi Anda direpresentasikan oleh ikon dan label di Android Sharesheet dan intent resolver. Keduanya didefinisikan dalam manifes. Anda dapat menetapkan label filter aktivitas atau intent untuk memberikan lebih banyak konteks.

Mulai Android 10 (API level 29), Android Sharesheet hanya menggunakan ikon yang ditetapkan dalam manifes pada tag application Anda. Android mengabaikan ikon yang ditetapkan pada tag intent-filter dan activity.

Sebelumnya
Mengirimkan data sederhana ke aplikasi lain
Berikutnya
Memberikan target Berbagi Langsung