Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 3ec3d5bb authored by Ta-wei Yen's avatar Ta-wei Yen
Browse files

Update documentation for preferred phone account columns 

Fixes: 70299454
Test: N/A
Change-Id: Ib8af85b5c618c1a2c62bc6c09daae057521de5d6
parent d87c6b51

core/java/android/provider/ContactsContract.java

+23 −3
Original line number Diff line number Diff line
@@ -4244,8 +4244,18 @@ public final class ContactsContract { 
        /**

         * The flattened {@link android.content.ComponentName} of a  {@link

         * android.telecom.PhoneAccountHandle} that is the preferred {@code PhoneAccountHandle} to

         * call the contact with. Used by {@link CommonDataKinds.Phone}.

         * call the contact with.

         *

         * <p> On a multi-SIM device this field can be used in a {@link CommonDataKinds.Phone} row

         * to indicate the {@link PhoneAccountHandle} to call the number with, instead of using

         * {@link android.telecom.TelecomManager#getDefaultOutgoingPhoneAccount(String)} or asking

         * every time.

         *

         * <p>{@link android.telecom.TelecomManager#placeCall(Uri, android.os.Bundle)}

         * should be called with {@link android.telecom.TelecomManager#EXTRA_PHONE_ACCOUNT_HANDLE}

         * set to the {@link PhoneAccountHandle} using the {@link ComponentName} from this field.

         *

         * @see #PREFERRED_PHONE_ACCOUNT_ID

         * @see PhoneAccountHandle#getComponentName()

         * @see ComponentName#flattenToString()

         */
@@ -4256,7 +4266,17 @@ public final class ContactsContract { 
         * android.telecom.PhoneAccountHandle} that is the preferred {@code PhoneAccountHandle} to

         * call the contact with. Used by {@link CommonDataKinds.Phone}.

         *

         * @see PhoneAccountHandle#getId() ()

         * <p> On a multi-SIM device this field can be used in a {@link CommonDataKinds.Phone} row

         * to indicate the {@link PhoneAccountHandle} to call the number with, instead of using

         * {@link android.telecom.TelecomManager#getDefaultOutgoingPhoneAccount(String)} or asking

         * every time.

         *

         * <p>{@link android.telecom.TelecomManager#placeCall(Uri, android.os.Bundle)}

         * should be called with {@link android.telecom.TelecomManager#EXTRA_PHONE_ACCOUNT_HANDLE}

         * set to the {@link PhoneAccountHandle} using the id from this field.

         *

         * @see #PREFERRED_PHONE_ACCOUNT_COMPONENT_NAME

         * @see PhoneAccountHandle#getId()

         */

        String PREFERRED_PHONE_ACCOUNT_ID = "preferred_phone_account_id";

    }