Bài học này hướng dẫn bạn cách sử dụng Intent để chèn một người liên hệ mới hoặc sửa đổi dữ liệu của người liên hệ. Thay vì truy cập trực tiếp vào Trình cung cấp danh bạ, Intent sẽ khởi động ứng dụng danh bạ, ứng dụng này sẽ chạy Activity thích hợp. Đối với các hành động sửa đổi được mô tả trong bài học này, nếu bạn gửi dữ liệu mở rộng trong Intent, thì dữ liệu đó sẽ được nhập vào giao diện người dùng của Activity được khởi động.
Bạn nên sử dụng Intent để chèn hoặc cập nhật một người liên hệ duy nhất nhằm sửa đổi Trình cung cấp danh bạ, vì những lý do sau:
- Điều này giúp bạn tiết kiệm thời gian và công sức phát triển giao diện người dùng và mã của riêng mình.
- Phương thức này giúp tránh gây ra lỗi do các nội dung sửa đổi không tuân theo quy tắc của Trình cung cấp danh bạ.
- Giảm số lượng quyền bạn cần yêu cầu. Ứng dụng của bạn không cần quyền ghi vào Trình cung cấp danh bạ, vì ứng dụng này uỷ quyền sửa đổi cho ứng dụng danh bạ, vốn đã có quyền đó.
Chèn người liên hệ mới bằng ý định
Bạn thường muốn cho phép người dùng chèn một người liên hệ mới khi ứng dụng của bạn nhận được dữ liệu mới. Ví dụ: một ứng dụng đánh giá nhà hàng có thể cho phép người dùng thêm nhà hàng làm người liên hệ khi họ đang đánh giá nhà hàng đó. Để thực hiện việc này bằng một ý định, hãy tạo ý định bằng cách sử dụng nhiều dữ liệu nhất có thể, sau đó gửi ý định đó đến ứng dụng danh bạ.
Việc chèn một người liên hệ bằng ứng dụng danh bạ sẽ chèn một người liên hệ thô mới vào bảng ContactsContract.RawContacts của Trình cung cấp danh bạ. Nếu cần, ứng dụng danh bạ sẽ nhắc người dùng về loại tài khoản và tài khoản cần sử dụng khi tạo liên hệ thô. Ứng dụng danh bạ cũng thông báo cho người dùng nếu người liên hệ thô đã tồn tại. Sau đó, người dùng có thể chọn huỷ việc chèn, trong trường hợp đó, không có người liên hệ nào được tạo. Để tìm hiểu thêm về người liên hệ thô, hãy xem hướng dẫn về API Trình cung cấp danh bạ.
Tạo ý định
Để bắt đầu, hãy tạo một đối tượng Intent mới bằng thao tác Intents.Insert.ACTION.
Đặt loại MIME thành RawContacts.CONTENT_TYPE. Ví dụ:
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);
Nếu đã có thông tin chi tiết về người liên hệ, chẳng hạn như số điện thoại hoặc địa chỉ email, bạn có thể chèn các thông tin đó vào ý định dưới dạng dữ liệu mở rộng. Đối với giá trị khoá, hãy sử dụng hằng số thích hợp từ Intents.Insert. Ứng dụng danh bạ sẽ hiển thị dữ liệu trong màn hình chèn, cho phép người dùng chỉnh sửa và bổ sung thêm.
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);
Sau khi bạn tạo Intent, hãy gửi thông báo bằng cách gọi startActivity().
Kotlin
/* Sends the Intent */ startActivity(intent)
Java
/* Sends the Intent */ startActivity(intent);
Lệnh gọi này mở ra một màn hình trong ứng dụng danh bạ, cho phép người dùng nhập một người liên hệ mới. Loại tài khoản và tên tài khoản của người liên hệ được liệt kê ở đầu màn hình. Sau khi người dùng nhập dữ liệu và nhấp vào Done (Xong), danh bạ của ứng dụng danh bạ sẽ xuất hiện. Người dùng quay lại ứng dụng của bạn bằng cách nhấp vào Quay lại.
Chỉnh sửa người liên hệ hiện có bằng ý định
Việc chỉnh sửa người liên hệ hiện có bằng Intent sẽ hữu ích nếu người dùng đã chọn một người liên hệ mà họ quan tâm. Ví dụ: một ứng dụng tìm người liên hệ có địa chỉ bưu chính nhưng thiếu mã bưu chính có thể cung cấp cho người dùng lựa chọn tra cứu mã rồi thêm mã đó vào người liên hệ.
Để chỉnh sửa một người liên hệ hiện có bằng ý định, hãy sử dụng quy trình tương tự như khi chèn một người liên hệ. Tạo một ý định như mô tả trong phần Chèn người liên hệ mới bằng ý định, nhưng thêm Contacts.CONTENT_LOOKUP_URI của người liên hệ và loại MIME Contacts.CONTENT_ITEM_TYPE vào ý định. Nếu muốn chỉnh sửa thông tin liên hệ bằng thông tin chi tiết mà bạn đã có, bạn có thể đưa thông tin đó vào dữ liệu mở rộng của ý định. Xin lưu ý rằng bạn không thể chỉnh sửa một số cột tên bằng ý định; các cột này được liệt kê trong phần tóm tắt của tài liệu tham khảo API cho lớp ContactsContract.Contacts trong tiêu đề "Cập nhật".
Cuối cùng, hãy gửi ý định. Để phản hồi, ứng dụng danh bạ sẽ hiển thị màn hình chỉnh sửa. Khi người dùng chỉnh sửa xong và lưu nội dung chỉnh sửa, ứng dụng danh bạ sẽ hiển thị danh bạ. Khi người dùng nhấp vào Quay lại, ứng dụng của bạn sẽ xuất hiện.
Tạo ý định
Để chỉnh sửa một người liên hệ, hãy gọi Intent(action) để tạo một ý định bằng hành động ACTION_EDIT. Gọi setDataAndType() để đặt giá trị dữ liệu cho ý định thành Contacts.CONTENT_LOOKUP_URI của người liên hệ và loại MIME thành loại MIME Contacts.CONTENT_ITEM_TYPE; vì lệnh gọi đến setType() sẽ ghi đè giá trị dữ liệu hiện tại cho Intent, nên bạn phải đặt dữ liệu và loại MIME cùng một lúc.
Để lấy Contacts.CONTENT_LOOKUP_URI của một người liên hệ, hãy gọi Contacts.getLookupUri(id, lookupkey) với các giá trị Contacts._ID và Contacts.LOOKUP_KEY của người liên hệ đó làm đối số.
Lưu ý: Giá trị LOOKUP_KEY của một người liên hệ là giá trị nhận dạng mà bạn nên dùng để truy xuất người liên hệ. Mã này không thay đổi, ngay cả khi nhà cung cấp thay đổi mã hàng của người liên hệ để xử lý các hoạt động nội bộ.
Đoạn mã sau đây cho bạn biết cách tạo một ý định:
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);
Thêm cờ điều hướng
Trong Android 4.0 (API phiên bản 14) trở lên, một vấn đề trong ứng dụng danh bạ khiến việc điều hướng không chính xác. Khi ứng dụng của bạn gửi ý định chỉnh sửa đến ứng dụng danh bạ, người dùng chỉnh sửa và lưu một người liên hệ, khi nhấp vào Quay lại, họ sẽ thấy màn hình danh bạ. Để quay lại ứng dụng của bạn, họ phải nhấp vào Recents (Gần đây) rồi chọn ứng dụng của bạn.
Để giải quyết vấn đề này trong Android 4.0.3 (API phiên bản 15) trở lên, hãy thêm khoá dữ liệu mở rộng finishActivityOnSaveCompleted vào ý định, với giá trị là true.
Các phiên bản Android trước Android 4.0 chấp nhận khoá này, nhưng khoá này không có hiệu lực. Để đặt dữ liệu mở rộng, hãy làm như sau:
Kotlin
// Sets the special extended data for navigation editIntent.putExtra("finishActivityOnSaveCompleted", true)
Java
// Sets the special extended data for navigation editIntent.putExtra("finishActivityOnSaveCompleted", true);
Thêm dữ liệu mở rộng khác
Để thêm dữ liệu mở rộng bổ sung vào Intent, hãy gọi putExtra() nếu cần.
Bạn có thể thêm dữ liệu mở rộng cho các trường liên hệ phổ biến bằng cách sử dụng các giá trị khoá được chỉ định trong Intents.Insert. Xin lưu ý rằng bạn không thể sửa đổi một số cột trong bảng ContactsContract.Contacts.
Các cột này được liệt kê trong phần tóm tắt của tài liệu tham khảo API cho lớp ContactsContract.Contacts trong tiêu đề "Cập nhật".
Gửi ý định
Cuối cùng, hãy gửi ý định mà bạn đã tạo. Ví dụ:
Kotlin
// Sends the Intent startActivity(editIntent)
Java
// Sends the Intent startActivity(editIntent);
Cho phép người dùng chọn chèn hoặc chỉnh sửa bằng một ý định
Bạn có thể cho phép người dùng chọn chèn một người liên hệ hoặc chỉnh sửa một người liên hệ hiện có bằng cách gửi một Intent có hành động ACTION_INSERT_OR_EDIT. Ví dụ: một ứng dụng email có thể cho phép người dùng thêm địa chỉ email đến vào một người liên hệ mới hoặc thêm địa chỉ đó làm địa chỉ bổ sung cho một người liên hệ hiện có. Đặt loại MIME cho ý định này thành Contacts.CONTENT_ITEM_TYPE, nhưng không đặt URI dữ liệu.
Khi bạn gửi ý định này, ứng dụng danh bạ sẽ hiển thị danh sách người liên hệ.
Người dùng có thể chèn một người liên hệ mới hoặc chọn một người liên hệ hiện có rồi chỉnh sửa.
Mọi trường dữ liệu mở rộng mà bạn thêm vào ý định sẽ điền sẵn vào màn hình xuất hiện. Bạn có thể sử dụng bất kỳ giá trị khoá nào được chỉ định trong Intents.Insert. Đoạn mã sau đây cho biết cách tạo và gửi ý định:
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);