แก้ไขรายชื่อติดต่อโดยใช้ Intent

บทเรียนนี้จะแสดงวิธีใช้ Intent เพื่อแทรกรายชื่อติดต่อใหม่หรือแก้ไขข้อมูลของรายชื่อติดต่อ แทนที่จะเข้าถึงผู้ให้บริการที่อยู่ติดต่อโดยตรง Intent จะเริ่มแอปรายชื่อติดต่อ ซึ่งจะเรียกใช้พร็อพเพอร์ตี้ Activity สำหรับการดำเนินการแก้ไขที่อธิบายไว้ในบทเรียนนี้ หากคุณส่งข้อมูลเพิ่มเติมใน Intent ข้อมูลดังกล่าวจะป้อนลงใน UI ของ Activityที่เริ่มต้นแล้ว

ขอแนะนำให้ใช้ Intent เพื่อแทรกหรืออัปเดตรายชื่อติดต่อรายการเดียว วิธีแก้ไขผู้ให้บริการรายชื่อติดต่อ ด้วยเหตุผลต่อไปนี้

• ซึ่งจะช่วยประหยัดเวลาและแรงงานในการพัฒนา UI และโค้ดของคุณเอง
• ซึ่งจะช่วยหลีกเลี่ยงข้อผิดพลาดที่เกิดจากการแก้ไขที่ไม่เป็นไปตามกฎของผู้ให้บริการข้อมูลติดต่อ
• ซึ่งจะช่วยลดจำนวนสิทธิ์ที่คุณต้องขอ แอปของคุณไม่ต้องใช้สิทธิ์ เพื่อเขียนไปยังผู้ให้บริการรายชื่อติดต่อ เนื่องจากเป็นการมอบสิทธิ์การแก้ไขแอปรายชื่อติดต่อ ที่มีสิทธิ์นั้นอยู่แล้ว

แทรกรายชื่อติดต่อใหม่โดยใช้ Intent

คุณมักต้องการอนุญาตให้ผู้ใช้แทรกรายชื่อติดต่อใหม่เมื่อแอปได้รับข้อมูลใหม่ สำหรับ ตัวอย่างเช่น แอปรีวิวร้านอาหารอนุญาตให้ผู้ใช้เพิ่มร้านอาหารนั้นเป็นรายชื่อติดต่อได้ กำลังตรวจสอบอยู่ หากต้องการดำเนินการนี้โดยใช้ Intent ให้สร้าง Intent โดยใช้ข้อมูลที่มีมากที่สุด จากนั้นส่ง Intent ไปยังแอปรายชื่อติดต่อ

การป้อนรายชื่อติดต่อโดยใช้แอปรายชื่อติดต่อจะแทรกรายชื่อติดต่อดิบใหม่ลงในตาราง ContactsContract.RawContacts ของผู้ให้บริการรายชื่อติดต่อ หากจำเป็น แอปรายชื่อติดต่อจะแจ้งให้ผู้ใช้ระบุประเภทบัญชีและบัญชีที่จะใช้เมื่อสร้างรายชื่อติดต่อดิบ แอปรายชื่อติดต่อจะแจ้งผู้ใช้ด้วยหากมีรายชื่อติดต่อดิบอยู่แล้ว จากนั้นผู้ใช้จะเลือกยกเลิกการแทรกได้ ซึ่งในกรณีนี้ระบบจะไม่สร้างรายชื่อติดต่อ เพื่อเรียนรู้ เพิ่มเติมเกี่ยวกับข้อมูลติดต่อดิบ โปรดดู ผู้ให้บริการรายชื่อติดต่อ คู่มือ API

สร้าง Intent

เริ่มต้นด้วยการสร้างออบเจ็กต์ Intent ใหม่ที่มีการดำเนินการ Intents.Insert.ACTION ตั้งค่าประเภท MIME เป็น RawContacts.CONTENT_TYPE เช่น

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

...
// 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);

หากมีรายละเอียดของผู้ติดต่ออยู่แล้ว เช่น หมายเลขโทรศัพท์หรืออีเมล คุณสามารถแทรกรายละเอียดดังกล่าวลงใน Intent เป็นข้อมูลเพิ่มเติมได้ สำหรับค่าคีย์ ให้ใช้ค่าคงที่ที่เหมาะสมจาก Intents.Insert แอปรายชื่อติดต่อจะแสดงข้อมูลในหน้าจอแทรก ซึ่งช่วยให้ผู้ใช้แก้ไขและเพิ่มข้อมูลได้

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

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

เมื่อสร้าง Intent แล้ว ให้ส่งโดยเรียกใช้ startActivity()

    /* Sends the Intent
     */
    startActivity(intent)

    /* Sends the Intent
     */
    startActivity(intent);

การโทรนี้จะเปิดหน้าจอในแอปรายชื่อติดต่อที่อนุญาตให้ผู้ใช้ป้อนรายชื่อติดต่อใหม่ ประเภทบัญชีและชื่อบัญชีของรายชื่อติดต่อจะแสดงที่ด้านบนของหน้าจอ เมื่อผู้ใช้ป้อนข้อมูลและคลิกเสร็จสิ้น รายชื่อติดต่อของแอปรายชื่อติดต่อจะปรากฏขึ้น ผู้ใช้กลับไปที่ แอปของคุณโดยคลิกกลับ

แก้ไขผู้ติดต่อที่มีอยู่โดยใช้ Intent

การแก้ไขรายชื่อติดต่อที่มีอยู่โดยใช้ Intent จะมีประโยชน์หากผู้ใช้ เลือกผู้ติดต่อที่สนใจแล้ว ตัวอย่างเช่น แอปที่ค้นหารายชื่อติดต่อที่มีที่อยู่ไปรษณีย์แต่ไม่มีรหัสไปรษณีย์อาจให้ตัวเลือกแก่ผู้ใช้ในการค้นหารหัสไปรษณีย์ แล้วเพิ่มรหัสนั้นลงในรายชื่อติดต่อ

หากต้องการแก้ไขผู้ติดต่อที่มีอยู่โดยใช้ความตั้งใจ ให้ใช้ขั้นตอนที่คล้ายกับ การแทรกรายชื่อติดต่อ สร้าง Intent ตามที่อธิบายไว้ในส่วน แทรกรายชื่อติดต่อใหม่โดยใช้ Intent แต่เพิ่มรายชื่อติดต่อ Contacts.CONTENT_LOOKUP_URI และประเภท MIME Contacts.CONTENT_ITEM_TYPE ไปยัง Intent หากต้องการแก้ไขรายชื่อติดต่อด้วยรายละเอียดที่มีอยู่แล้ว ให้ใส่รายละเอียดเหล่านั้นไว้ในข้อมูลเพิ่มเติมของ Intent โปรดทราบว่าคอลัมน์ชื่อบางคอลัมน์จะแก้ไขโดยใช้ Intent ไม่ได้ คอลัมน์เหล่านี้จะแสดงอยู่ในส่วนสรุปของข้อมูลอ้างอิง API สำหรับคลาส ContactsContract.Contacts ในส่วนหัว "อัปเดต"

สุดท้าย ให้ส่ง Intent แอปรายชื่อติดต่อจะแสดงหน้าจอแก้ไขเพื่อตอบกลับ เมื่อผู้ใช้ แก้ไขเสร็จแล้วจะบันทึกการแก้ไข แอปรายชื่อติดต่อจะแสดงรายชื่อติดต่อ เมื่อผู้ใช้คลิกกลับ แอปของคุณจะแสดงขึ้น

สร้าง Intent

หากต้องการแก้ไขรายชื่อติดต่อ ให้โทรหา Intent(action) สร้าง Intent ที่มีการดำเนินการ ACTION_EDIT เรียกใช้ setDataAndType() เพื่อตั้งค่าข้อมูลของ Intent เป็น Contacts.CONTENT_LOOKUP_URI ของผู้ติดต่อ และตั้งค่าประเภท MIME เป็นประเภท MIME ของ Contacts.CONTENT_ITEM_TYPE เนื่องจากการเรียกใช้ setType() จะเขียนทับค่าข้อมูลปัจจุบันของ Intent คุณจึงต้องตั้งค่าข้อมูลและประเภท MIME พร้อมกัน

หากต้องการรับ Contacts.CONTENT_LOOKUP_URI ของผู้ติดต่อ ให้เรียกใช้ Contacts.getLookupUri(id, lookupkey) พร้อมค่า Contacts._ID และ Contacts.LOOKUP_KEY ของผู้ติดต่อเป็นอาร์กิวเมนต์

หมายเหตุ: หมายเลขติดต่อ ค่า LOOKUP_KEY คือ ตัวระบุที่คุณควรใช้เพื่อเรียกข้อมูลรายชื่อติดต่อ มีความคงที่ แม้ว่าผู้ให้บริการจะเปลี่ยนรหัสแถวของรายชื่อติดต่อเพื่อจัดการการดำเนินการภายในก็ตาม

ข้อมูลโค้ดต่อไปนี้แสดงวิธีสร้าง Intent

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

    // 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);

เพิ่มธงการไปยังส่วนต่างๆ

ใน Android 4.0 (API เวอร์ชัน 14) ขึ้นไป ปัญหาในแอปรายชื่อติดต่อจะทําให้การนําทางไม่ถูกต้อง เมื่อแอปของคุณส่งคำขอแก้ไขไปยังแอปรายชื่อติดต่อ และผู้ใช้แก้ไขและบันทึก รายชื่อติดต่อ เมื่อคลิกกลับ ก็จะเห็นหน้าจอรายชื่อติดต่อ หากต้องการกลับไปที่แอปของคุณ ผู้ใช้จะต้องคลิกล่าสุดแล้วเลือกแอปของคุณ

วิธีแก้ไขปัญหานี้ใน Android 4.0.3 (API เวอร์ชัน 15) ขึ้นไป ให้เพิ่มส่วนขยาย คีย์ข้อมูล finishActivityOnSaveCompleted ไปยัง Intent มีค่า true Android เวอร์ชันก่อน Android 4.0 ยอมรับคีย์นี้แต่ไม่ส่งผลใดๆ วิธีตั้งค่า แบบขยาย ให้ทำดังต่อไปนี้

    // Sets the special extended data for navigation
    editIntent.putExtra("finishActivityOnSaveCompleted", true)

    // Sets the special extended data for navigation
    editIntent.putExtra("finishActivityOnSaveCompleted", true);

เพิ่มข้อมูลเพิ่มเติมอื่นๆ

หากต้องการเพิ่มข้อมูลเพิ่มเติมไปยังIntent ให้โทร putExtra()ตามต้องการ คุณสามารถเพิ่มข้อมูลเพิ่มเติมสำหรับช่องติดต่อทั่วไปได้โดยใช้ค่าคีย์ที่ระบุไว้ใน Intents.Insert โปรดทราบว่า ไม่สามารถแก้ไขคอลัมน์ในตาราง ContactsContract.Contacts ได้ คอลัมน์เหล่านี้แสดงอยู่ในส่วนสรุปข้อมูลอ้างอิง API สำหรับคลาส ContactsContract.Contacts ภายใต้ส่วนหัว "อัปเดต"

ส่ง Intent

สุดท้าย ให้ส่ง Intent ที่คุณสร้างขึ้น เช่น

    // Sends the Intent
    startActivity(editIntent)

    // Sends the Intent
    startActivity(editIntent);

อนุญาตให้ผู้ใช้เลือกแทรกหรือแก้ไขโดยใช้ Intent

คุณสามารถอนุญาตให้ผู้ใช้เลือกว่าจะแทรกผู้ติดต่อหรือแก้ไขผู้ติดต่อที่มีอยู่โดยการส่ง Intent ที่มีการดำเนินการ ACTION_INSERT_OR_EDIT ตัวอย่างเช่น แอปโปรแกรมรับส่งอีเมลอาจอนุญาตให้ผู้ใช้เพิ่มอีเมลขาเข้าไปยังรายชื่อติดต่อใหม่ หรือเพิ่มเป็นอีเมลเพิ่มเติมสำหรับรายชื่อติดต่อที่มีอยู่ ตั้งค่าประเภท MIME สำหรับ Intent นี้เป็น Contacts.CONTENT_ITEM_TYPE, แต่ไม่ได้ตั้งค่า URI ข้อมูล

เมื่อคุณส่ง Intent นี้ แอปรายชื่อติดต่อจะแสดงรายการรายชื่อติดต่อ ผู้ใช้สามารถแทรกผู้ติดต่อใหม่หรือเลือกผู้ติดต่อที่มีอยู่และแก้ไขก็ได้ ช่องข้อมูลแบบขยายใดๆ ที่คุณเพิ่มลงใน Intent จะแสดงหน้าจอที่ปรากฏขึ้น คุณสามารถใช้ ค่าคีย์ใดก็ได้ที่ระบุใน Intents.Insert ข้อมูลโค้ดต่อไปนี้แสดงวิธีสร้างและส่ง Intent

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

    // 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);