Intent.ActionGetContent Bidang
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Tindakan Aktivitas: Izinkan pengguna untuk memilih jenis data tertentu dan mengembalikannya.
[Android.Runtime.Register("ACTION_GET_CONTENT")]
public const string ActionGetContent;
[<Android.Runtime.Register("ACTION_GET_CONTENT")>]
val mutable ActionGetContent : string
Nilai Bidang
Penerapan
- Atribut
Keterangan
Tindakan Aktivitas: Izinkan pengguna untuk memilih jenis data tertentu dan mengembalikannya. Ini berbeda dari #ACTION_PICK
di sini kita hanya mengatakan jenis data apa yang diinginkan, bukan URI data yang ada dari mana pengguna dapat memilih. ACTION_GET_CONTENT dapat memungkinkan pengguna untuk membuat data saat berjalan (misalnya mengambil gambar atau merekam suara), membiarkan mereka menelusuri web dan mengunduh data yang diinginkan, dll.
Ada dua cara utama untuk menggunakan tindakan ini: jika Anda menginginkan jenis data tertentu, seperti kontak orang, Anda mengatur jenis MIME ke jenis data yang Anda inginkan dan meluncurkannya dengan Context#startActivity(Intent)
. Sistem kemudian akan meluncurkan aplikasi terbaik untuk memilih data semacam itu untuk Anda.
Anda mungkin juga tertarik pada salah satu dari sekumpulan jenis konten yang dapat dipilih pengguna. Misalnya, aplikasi email yang ingin memungkinkan pengguna menambahkan lampiran ke pesan email dapat menggunakan tindakan ini untuk memunculkan daftar semua jenis konten yang dapat dilampirkan pengguna.
Dalam hal ini, Anda harus membungkus niat GET_CONTENT dengan pemilih (melalui #createChooser
), yang akan memberikan antarmuka yang tepat bagi pengguna untuk memilih cara mengirim data Anda dan memungkinkan Anda menentukan permintaan yang menunjukkan apa yang mereka lakukan. Anda biasanya akan menentukan jenis MIME yang luas (seperti gambar/* atau */*), menghasilkan berbagai jenis konten yang dapat dipilih pengguna.
Saat menggunakan tindakan GET_CONTENT yang luas seperti itu, sering kali diinginkan untuk hanya memilih dari data yang dapat direpresentasikan sebagai aliran. Hal ini dilakukan dengan mengharuskan #CATEGORY_OPENABLE
dalam Niat.
Penelepon dapat secara opsional menentukan #EXTRA_LOCAL_ONLY
untuk meminta bahwa pemilih konten yang diluncurkan hanya mengembalikan hasil yang mewakili data yang tersedia secara lokal di perangkat. Misalnya, jika ekstra ini diatur ke true, maka pemilih gambar tidak boleh menampilkan gambar apa pun yang tersedia dari server jarak jauh tetapi belum ada di perangkat lokal (sehingga mengharuskan mereka diunduh saat dibuka).
Jika pemanggil dapat menangani beberapa item yang dikembalikan (pengguna melakukan beberapa pilihan), maka pemanggil dapat menentukan #EXTRA_ALLOW_MULTIPLE
untuk menunjukkan hal ini.
Input: #getType
adalah jenis MIME yang diinginkan untuk diambil. Perhatikan bahwa tidak ada URI yang disediakan dalam niat, karena tidak ada batasan di mana data yang dikembalikan awalnya berasal. Anda juga dapat menyertakan #CATEGORY_OPENABLE
jika Anda hanya dapat menerima data yang dapat dibuka sebagai aliran. Anda dapat menggunakan #EXTRA_LOCAL_ONLY
untuk membatasi pilihan konten ke data lokal. Anda dapat menggunakan #EXTRA_ALLOW_MULTIPLE
untuk mengizinkan pengguna memilih beberapa item.
Output: URI item yang dipilih. Ini harus berupa konten: URI sehingga setiap penerima dapat mengaksesnya.
Dokumentasi Java untuk android.content.Intent.ACTION_GET_CONTENT
.
Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.