Merge "Remove redundant permission requirements docs." am: ef2c66e72f am:... (e5dded6f) · Commits · e / os / android_frameworks_base

telecomm/java/android/telecom/TelecomManager.java

+2 −31

Original line number	Diff line number	Diff line
		@@ -992,8 +992,6 @@ public class TelecomManager {
		* <p>
		* If no {@link PhoneAccount} fits the criteria above, this method will return {@code null}.
		*
		* Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
		*
		* @param uriScheme The URI scheme.
		* @return The {@link PhoneAccountHandle} corresponding to the account to be used.
		*/
		@@ -1170,8 +1168,6 @@ public class TelecomManager {
		* calls. The returned list includes only those accounts which have been explicitly enabled
		* by the user.
		*
		* Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
		*
		* @see #EXTRA_PHONE_ACCOUNT_HANDLE
		* @return A list of {@code PhoneAccountHandle} objects.
		*/
		@@ -1474,9 +1470,6 @@ public class TelecomManager {
		* the specified package does not correspond to an installed dialer, or is already
		* the default dialer.
		*
		* Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
		* Requires permission: {@link android.Manifest.permission#WRITE_SECURE_SETTINGS}
		*
		* @hide
		* @deprecated Use
		* {@link android.app.role.RoleManager#addRoleHolderAsUser(String, String, int, UserHandle,
		@@ -1520,8 +1513,6 @@ public class TelecomManager {
		* Return whether a given phone number is the configured voicemail number for a
		* particular phone account.
		*
		* Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
		*
		* @param accountHandle The handle for the account to check the voicemail number against
		* @param number The number to look up.
		*/
		@@ -1541,8 +1532,6 @@ public class TelecomManager {
		/**
		* Return the voicemail number for a given phone account.
		*
		* Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
		*
		* @param accountHandle The handle for the phone account.
		* @return The voicemail number for the phone account, and {@code null} if one has not been
		* configured.
		@@ -1594,8 +1583,6 @@ public class TelecomManager {
		/**
		* Returns whether there is an ongoing phone call (can be in dialing, ringing, active or holding
		* states) originating from either a manager or self-managed {@link ConnectionService}.
		* <p>
		* Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
		*
		* @return {@code true} if there is an ongoing call in either a managed or self-managed
		* {@link ConnectionService}, {@code false} otherwise.
		@@ -1644,8 +1631,6 @@ public class TelecomManager {
		* <p>
		* If you also need to know if there are ongoing self-managed calls, use {@link #isInCall()}
		* instead.
		* <p>
		* Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
		*
		* @return {@code true} if there is an ongoing call in a managed {@link ConnectionService},
		* {@code false} otherwise.
		@@ -1719,8 +1704,6 @@ public class TelecomManager {
		* If there is a ringing call, calling this method rejects the ringing call. Otherwise the
		* foreground call is ended.
		* <p>
		* Requires permission {@link android.Manifest.permission#ANSWER_PHONE_CALLS}.
		* <p>
		* Note: this method CANNOT be used to end ongoing emergency calls and will return {@code false}
		* if an attempt is made to end an emergency call.
		*
		@@ -1750,9 +1733,6 @@ public class TelecomManager {
		* the incoming call requests. This means, for example, that an incoming call requesting
		* {@link VideoProfile#STATE_BIDIRECTIONAL} will be answered, accepting that state.
		*
		* Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE} or
		* {@link android.Manifest.permission#ANSWER_PHONE_CALLS}
		*
		* @deprecated Companion apps for wearable devices should use the {@link InCallService} API
		* instead.
		*/
		@@ -1775,9 +1755,6 @@ public class TelecomManager {
		* If there is a ringing incoming call, this method accepts the call on behalf of the user,
		* with the specified video state.
		*
		* Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE} or
		* {@link android.Manifest.permission#ANSWER_PHONE_CALLS}
		*
		* @param videoState The desired video state to answer the call with.
		* @deprecated Companion apps for wearable devices should use the {@link InCallService} API
		* instead.
		@@ -1989,8 +1966,6 @@ public class TelecomManager {
		* Requires that the method-caller be set as the system dialer app.
		* </p>
		*
		* Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
		*
		* @param dialString The digits to dial.
		* @return True if the digits were processed as an MMI code, false otherwise.
		*/
		@@ -2015,8 +1990,6 @@ public class TelecomManager {
		* Requires that the method-caller be set as the system dialer app.
		* </p>
		*
		* Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
		*
		* @param accountHandle The handle for the account the MMI code should apply to.
		* @param dialString The digits to dial.
		* @return True if the digits were processed as an MMI code, false otherwise.
		@@ -2036,8 +2009,8 @@ public class TelecomManager {
		}

		/**
		* Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
		*
		* Returns a URI (with the content:// scheme) specific to the specified {@link PhoneAccount}
		* for ADN content retrieval.
		* @param accountHandle The handle for the account to derive an adn query URI for or
		* {@code null} to return a URI which will use the default account.
		* @return The URI (with the content:// scheme) specific to the specified {@link PhoneAccount}
		@@ -2061,8 +2034,6 @@ public class TelecomManager {
		* <p>
		* Requires that the method-caller be set as the system dialer app.
		* </p>
		*
		* Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
		*/
		@RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)
		public void cancelMissedCallsNotification() {