Pelajaran ini menunjukkan cara menggunakan Intent
untuk menyisipkan kontak baru atau
memodifikasi data kontak. Alih-alih mengakses Penyedia Kontak secara langsung,
Intent
memulai aplikasi kontak, yang menjalankan
Activity
yang sesuai. Untuk tindakan modifikasi yang dijelaskan dalam pelajaran ini,
jika Anda mengirim data yang diperluas di Intent
, data itu akan dimasukkan ke dalam UI
Activity
yang dimulai.
Menggunakan Intent
untuk menyisipkan atau memperbarui satu kontak adalah cara yang lebih disukai untuk memodifikasi Penyedia Kontak, karena alasan berikut:
- Menghemat waktu dan upaya untuk mengembangkan UI dan kode Anda sendiri.
- Menghindari error yang disebabkan oleh modifikasi yang tidak mengikuti Aturan Penyedia Kontak.
- Hal ini mengurangi jumlah izin yang perlu Anda minta. Aplikasi Anda tidak memerlukan izin untuk menulis ke Penyedia Kontak, karena aplikasi mendelegasikan modifikasi ke aplikasi kontak, yang sudah memiliki izin tersebut.
Menyisipkan kontak baru menggunakan intent
Terkadang Anda mungkin ingin mengizinkan pengguna menyisipkan kontak baru saat aplikasi Anda menerima data baru. Sebagai misalnya, aplikasi ulasan restoran dapat memungkinkan pengguna menambahkan restoran sebagai kontak saat meninjaunya. Untuk melakukannya dengan menggunakan intent, buat intent menggunakan data sebanyak yang Anda miliki tersedia, lalu mengirim intent ke aplikasi kontak.
Menyisipkan kontak menggunakan aplikasi kontak akan menyisipkan kontak mentah baru ke dalam Kontak
Tabel ContactsContract.RawContacts
penyedia. Jika perlu,
aplikasi kontak meminta pengguna untuk memasukkan tipe akun dan akun yang akan digunakan saat membuat laporan
kontak. Aplikasi kontak juga memberi tahu pengguna jika kontak mentah sudah ada. Pengguna kemudian memiliki
untuk membatalkan penyisipan, yang dalam hal ini tidak ada kontak yang dibuat. Untuk mempelajari
selengkapnya tentang kontak mentah, lihat
Penyedia Kontak
Panduan API.
Membuat intent
Untuk memulai, buat objek Intent
baru dengan tindakan
Intents.Insert.ACTION
.
Tetapkan jenis MIME ke RawContacts.CONTENT_TYPE
. Contoh:
Kotlin
... // Creates a new Intent to insert a contact val intent = Intent(ContactsContract.Intents.Insert.ACTION).apply { // Sets the MIME type to match the Contacts Provider type = ContactsContract.RawContacts.CONTENT_TYPE }
Java
... // Creates a new Intent to insert a contact Intent intent = new Intent(ContactsContract.Intents.Insert.ACTION); // Sets the MIME type to match the Contacts Provider intent.setType(ContactsContract.RawContacts.CONTENT_TYPE);
Jika sudah memiliki detail untuk kontak, seperti nomor telepon atau alamat email, Anda dapat
menyisipkannya ke dalam intent sebagai data yang diperluas. Untuk nilai kunci, gunakan konstanta yang sesuai dari
Intents.Insert
. Aplikasi kontak
menampilkan data di layar sisipannya, yang memungkinkan pengguna melakukan pengeditan dan penambahan lebih lanjut.
Kotlin
private var emailAddress: EditText? = null private var phoneNumber: EditText? = null ... /* Assumes EditText fields in your UI contain an email address * and a phone number. * */ emailAddress = findViewById(R.id.email) phoneNumber = findViewById(R.id.phone) ... /* * Inserts new data into the Intent. This data is passed to the * contacts app's Insert screen */ intent.apply { // Inserts an email address putExtra(ContactsContract.Intents.Insert.EMAIL, emailAddress?.text) /* * In this example, sets the email type to be a work email. * You can set other email types as necessary. */ putExtra( ContactsContract.Intents.Insert.EMAIL_TYPE, ContactsContract.CommonDataKinds.Email.TYPE_WORK ) // Inserts a phone number putExtra(ContactsContract.Intents.Insert.PHONE, phoneNumber?.text) /* * In this example, sets the phone type to be a work phone. * You can set other phone types as necessary. */ putExtra( ContactsContract.Intents.Insert.PHONE_TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_WORK ) }
Java
private EditText emailAddress = null; private EditText phoneNumber = null; ... /* Assumes EditText fields in your UI contain an email address * and a phone number. * */ emailAddress = (EditText) findViewById(R.id.email); phoneNumber = (EditText) findViewById(R.id.phone); ... /* * Inserts new data into the Intent. This data is passed to the * contacts app's Insert screen */ // Inserts an email address intent.putExtra(ContactsContract.Intents.Insert.EMAIL, emailAddress.getText()) /* * In this example, sets the email type to be a work email. * You can set other email types as necessary. */ .putExtra(ContactsContract.Intents.Insert.EMAIL_TYPE, ContactsContract.CommonDataKinds.Email.TYPE_WORK) // Inserts a phone number .putExtra(ContactsContract.Intents.Insert.PHONE, phoneNumber.getText()) /* * In this example, sets the phone type to be a work phone. * You can set other phone types as necessary. */ .putExtra(ContactsContract.Intents.Insert.PHONE_TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_WORK);
Setelah Anda membuat Intent
, kirimkan dengan memanggil
startActivity()
.
Kotlin
/* Sends the Intent */ startActivity(intent)
Java
/* Sends the Intent */ startActivity(intent);
Panggilan ini membuka layar di aplikasi kontak yang memungkinkan pengguna memasukkan kontak baru. Jenis akun dan nama akun untuk kontak dicantumkan di bagian atas layar. Setelah pengguna masukkan data dan klik Selesai, daftar kontak aplikasi kontak akan muncul. Pengguna kembali ke aplikasi Anda dengan mengklik Kembali.
Mengedit kontak yang ada menggunakan intent
Mengedit kontak yang ada menggunakan Intent
berguna jika pengguna
telah memilih kontak yang diminati. Misalnya, aplikasi yang menemukan kontak yang memiliki
alamat pos tetapi tidak memiliki kode pos dapat
memberi pengguna pilihan untuk mencari kode dan
lalu menambahkannya ke kontak.
Untuk mengedit kontak yang ada menggunakan intent, gunakan prosedur yang mirip dengan
untuk memasukkan kontak. Buat intent seperti yang dijelaskan di bagian
Menyisipkan kontak baru menggunakan intent, tetapi tambahkan Contacts.CONTENT_LOOKUP_URI
kontak dan jenis MIME
Contacts.CONTENT_ITEM_TYPE
ke intent tersebut. Jika ingin mengedit kontak dengan detail yang sudah Anda
miliki, Anda dapat menempatkannya di data yang diperluas untuk intent tersebut. Perhatikan bahwa beberapa
kolom nama tidak dapat diedit menggunakan intent; kolom tersebut tercantum di bagian ringkasan
referensi API untuk class ContactsContract.Contacts
dengan judul "Perbarui".
Terakhir, kirimkan intent. Sebagai respons, aplikasi kontak akan menampilkan layar edit. Saat pengguna selesai mengedit dan menyimpan hasil edit, aplikasi kontak akan menampilkan daftar kontak. Saat pengguna mengklik Kembali, aplikasi Anda akan ditampilkan.
Membuat intent
Untuk mengedit kontak, panggil Intent(action)
untuk
membuat intent dengan tindakan ACTION_EDIT
. Telepon
setDataAndType()
untuk menetapkan nilai data
intent ke Contacts.CONTENT_LOOKUP_URI
kontak dan jenis MIME untuk
Contacts.CONTENT_ITEM_TYPE
Jenis MIME; karena panggilan ke
setType()
menimpa nilai data saat ini untuk
Intent
, Anda harus menetapkan data dan jenis MIME secara bersamaan.
Untuk mendapatkan Contacts.CONTENT_LOOKUP_URI
kontak, panggil
Contacts.getLookupUri(id, lookupkey)
dengan nilai
Contacts._ID
dan
Contacts.LOOKUP_KEY
kontak sebagai
argumen.
Catatan: Alamat
Nilai LOOKUP_KEY
adalah
ID yang harus Anda gunakan
untuk mengambil sebuah kontak. ID ini selalu konstan,
meskipun penyedia mengubah ID baris kontak untuk menangani operasi internal.
Cuplikan berikut menunjukkan cara membuat intent:
Kotlin
// The Cursor that contains the Contact row var mCursor: Cursor? = null // The index of the lookup key column in the cursor var lookupKeyIndex: Int = 0 // The index of the contact's _ID value var idIndex: Int = 0 // The lookup key from the Cursor var currentLookupKey: String? = null // The _ID value from the Cursor var currentId: Long = 0 // A content URI pointing to the contact var selectedContactUri: Uri? = null ... /* * Once the user has selected a contact to edit, * this gets the contact's lookup key and _ID values from the * cursor and creates the necessary URI. */ mCursor?.apply { // Gets the lookup key column index lookupKeyIndex = getColumnIndex(ContactsContract.Contacts.LOOKUP_KEY) // Gets the lookup key value currentLookupKey = getString(lookupKeyIndex) // Gets the _ID column index idIndex = getColumnIndex(ContactsContract.Contacts._ID) currentId = getLong(idIndex) selectedContactUri = ContactsContract.Contacts.getLookupUri(currentId, mCurrentLookupKey) } // Creates a new Intent to edit a contact val editIntent = Intent(Intent.ACTION_EDIT).apply { /* * Sets the contact URI to edit, and the data type that the * Intent must match */ setDataAndType(selectedContactUri, ContactsContract.Contacts.CONTENT_ITEM_TYPE) }
Java
// The Cursor that contains the Contact row public Cursor mCursor; // The index of the lookup key column in the cursor public int lookupKeyIndex; // The index of the contact's _ID value public int idIndex; // The lookup key from the Cursor public String currentLookupKey; // The _ID value from the Cursor public long currentId; // A content URI pointing to the contact Uri selectedContactUri; ... /* * Once the user has selected a contact to edit, * this gets the contact's lookup key and _ID values from the * cursor and creates the necessary URI. */ // Gets the lookup key column index lookupKeyIndex = mCursor.getColumnIndex(ContactsContract.Contacts.LOOKUP_KEY); // Gets the lookup key value currentLookupKey = mCursor.getString(lookupKeyIndex); // Gets the _ID column index idIndex = mCursor.getColumnIndex(ContactsContract.Contacts._ID); currentId = mCursor.getLong(idIndex); selectedContactUri = Contacts.getLookupUri(currentId, mCurrentLookupKey); ... // Creates a new Intent to edit a contact Intent editIntent = new Intent(Intent.ACTION_EDIT); /* * Sets the contact URI to edit, and the data type that the * Intent must match */ editIntent.setDataAndType(selectedContactUri, ContactsContract.Contacts.CONTENT_ITEM_TYPE);
Menambahkan flag navigasi
Di Android 4.0 (API versi 14) dan yang lebih baru, masalah dalam aplikasi kontak menyebabkan navigasi yang salah. Saat aplikasi Anda mengirimkan intent edit ke aplikasi kontak, dan pengguna mengedit serta menyimpan kontak, saat mengklik Kembali, mereka akan melihat layar daftar kontak. Untuk kembali ke aplikasi Anda, mereka harus mengklik Terbaru dan memilih aplikasi Anda.
Untuk mengatasi masalah ini di Android 4.0.3 (API versi 15) dan yang lebih baru, tambahkan perluasan
kunci data finishActivityOnSaveCompleted
ke intent, dengan nilai true
.
Versi Android sebelum 4.0 menerima kunci ini, tetapi tidak berpengaruh. Untuk menyetel
data yang diperluas, lakukan langkah berikut:
Kotlin
// Sets the special extended data for navigation editIntent.putExtra("finishActivityOnSaveCompleted", true)
Java
// Sets the special extended data for navigation editIntent.putExtra("finishActivityOnSaveCompleted", true);
Menambahkan data yang diperluas lainnya
Untuk menambahkan data yang diperluas lainnya ke Intent
, panggil
putExtra()
sesuai keinginan.
Anda dapat menambahkan data yang diperluas untuk kolom kontak umum menggunakan nilai kunci yang ditetapkan dalam
Intents.Insert
. Ingat bahwa beberapa
kolom dalam tabel ContactsContract.Contacts
tidak dapat diubah.
Kolom ini dicantumkan di bagian ringkasan referensi API untuk class
ContactsContract.Contacts
di bawah judul "Perbarui".
Mengirim intent
Terakhir, kirimkan intent yang telah Anda buat. Contoh:
Kotlin
// Sends the Intent startActivity(editIntent)
Java
// Sends the Intent startActivity(editIntent);
Mengizinkan pengguna memilih untuk menyisipkan atau mengedit menggunakan intent
Anda dapat mengizinkan pengguna memilih untuk menyisipkan kontak atau mengedit yang sudah ada dengan mengirim
Intent
dengan tindakan
ACTION_INSERT_OR_EDIT
. Misalnya, aplikasi program email bisa
izinkan pengguna menambahkan alamat email masuk ke kontak baru, atau menambahkannya sebagai
untuk kontak yang sudah ada. Tetapkan jenis MIME untuk intent ini ke
Halo Contacts.CONTENT_ITEM_TYPE
,
tetapi jangan tetapkan URI data.
Saat Anda mengirim intent ini, aplikasi kontak akan menampilkan daftar kontak.
Pengguna dapat menyisipkan kontak baru atau memilih kontak yang ada dan mengeditnya.
Setiap kolom data yang diperluas yang Anda tambahkan ke intent akan mengisi layar yang muncul. Anda dapat menggunakan
salah satu nilai kunci yang ditentukan dalam Intents.Insert
. Cuplikan kode berikut menunjukkan cara membuat dan mengirim intent:
Kotlin
// Creates a new Intent to insert or edit a contact val intentInsertEdit = Intent(Intent.ACTION_INSERT_OR_EDIT).apply { // Sets the MIME type type = ContactsContract.Contacts.CONTENT_ITEM_TYPE } // Add code here to insert extended data, if desired // Sends the Intent with an request ID startActivity(intentInsertEdit)
Java
// Creates a new Intent to insert or edit a contact Intent intentInsertEdit = new Intent(Intent.ACTION_INSERT_OR_EDIT); // Sets the MIME type intentInsertEdit.setType(ContactsContract.Contacts.CONTENT_ITEM_TYPE); // Add code here to insert extended data, if desired ... // Sends the Intent with an request ID startActivity(intentInsertEdit);