Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update TelecomManager docs regarding PhoneAccounts

Browse Source 
Updates the docs for addNewIncomingCall to mention that if the
PhoneAccountHandle representing a PhoneAccount is not registered or not
enabled, a SecurityException will be thrown (as of b/26864502). Also
notifies the user that PhoneAccounts are stored in DE storage
in registerPhoneAccount.

Bug: 26874536
Bug: 26780305
Change-Id: I2dae932cfa3404d7d5060dad840a75227793603e
This commit is contained in:
Brad Ebinger
2016-01-29 15:40:43 -08:00
parent 2af189a0a7
commit ec0d33490a
1 changed files with 13 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
telecomm/java/android/telecom/TelecomManager.java
View File

@@ -774,9 +774,9 @@ public class TelecomManager {
}
/**
* Register a {@link PhoneAccount} for use by the system. When registering
* {@link PhoneAccount}s, existing registrations will be overwritten if the
* {@link PhoneAccountHandle} matches that of a {@link PhoneAccount} which is already
* Register a {@link PhoneAccount} for use by the system that will be stored in Device Encrypted
* storage. When registering {@link PhoneAccount}s, existing registrations will be overwritten
* if the {@link PhoneAccountHandle} matches that of a {@link PhoneAccount} which is already
* registered. Once registered, the {@link PhoneAccount} is listed to the user as an option
* when placing calls. The user may still need to enable the {@link PhoneAccount} within
* the phone app settings before the account is usable.
@@ -1166,11 +1166,16 @@ public class TelecomManager {
/**
* Registers a new incoming call. A {@link ConnectionService} should invoke this method when it
* has an incoming call. The specified {@link PhoneAccountHandle} must have been registered
* with {@link #registerPhoneAccount}. Once invoked, this method will cause the system to bind
* to the {@link ConnectionService} associated with the {@link PhoneAccountHandle} and request
* additional information about the call (See
* {@link ConnectionService#onCreateIncomingConnection}) before starting the incoming call UI.
*
* with {@link #registerPhoneAccount} and the user must have enabled the corresponding
* {@link PhoneAccount}. This can be checked using {@link #getPhoneAccount}. Once invoked, this
* method will cause the system to bind to the {@link ConnectionService} associated with the
* {@link PhoneAccountHandle} and request additional information about the call
* (See {@link ConnectionService#onCreateIncomingConnection}) before starting the incoming
* call UI.
* <p>
* A {@link SecurityException} will be thrown if either the {@link PhoneAccountHandle} does not
* correspond to a registered {@link PhoneAccount} or the associated {@link PhoneAccount} is not
* currently enabled by the user.
* @param phoneAccount A {@link PhoneAccountHandle} registered with
* {@link #registerPhoneAccount}.
* @param extras A bundle that will be passed through to