Merge "Update documentation for preferred phone account columns" (e165e35f) · Commits · e / os / android_frameworks_base

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";
		}