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

Merge "Updates to Telecom API docs for clarity." am: e845bddb40 am: 8fe8f5fa9b

Browse Source 
am: 82d572ed07

Change-Id: I2699c25dd3a309eed0742dc87b636a9b96d32e96
This commit is contained in:
Tyler Gunn
2018-02-13 10:13:48 +00:00
committed by android-build-merger
parent d71e03f0a1 82d572ed07
commit 29a96d4b28
1 changed files with 46 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
telecomm/java/android/telecom/Connection.java
View File

@@ -2743,7 +2743,20 @@ public abstract class Connection extends Conferenceable {
/**
* Notifies this Connection, which is in {@link #STATE_RINGING}, of
* a request to accept.
*
* <p>
* For managed {@link ConnectionService}s, this will be called when the user answers a call via
* the default dialer's {@link InCallService}.
* <p>
* Although a self-managed {@link ConnectionService} provides its own incoming call UI, the
* Telecom framework may request that the call is answered in the following circumstances:
* <ul>
* <li>The user chooses to answer an incoming call via a Bluetooth device.</li>
* <li>A car mode {@link InCallService} is in use which has declared
* {@link TelecomManager#METADATA_INCLUDE_SELF_MANAGED_CALLS} in its manifest. Such an
* {@link InCallService} will be able to see calls from self-managed
* {@link ConnectionService}s, and will be able to display an incoming call UI on their
* behalf.</li>
* </ul>
* @param videoState The video state in which to answer the connection.
*/
public void onAnswer(int videoState) {}
@@ -2751,6 +2764,20 @@ public abstract class Connection extends Conferenceable {
/**
* Notifies this Connection, which is in {@link #STATE_RINGING}, of
* a request to accept.
* <p>
* For managed {@link ConnectionService}s, this will be called when the user answers a call via
* the default dialer's {@link InCallService}.
* <p>
* Although a self-managed {@link ConnectionService} provides its own incoming call UI, the
* Telecom framework may request that the call is answered in the following circumstances:
* <ul>
* <li>The user chooses to answer an incoming call via a Bluetooth device.</li>
* <li>A car mode {@link InCallService} is in use which has declared
* {@link TelecomManager#METADATA_INCLUDE_SELF_MANAGED_CALLS} in its manifest. Such an
* {@link InCallService} will be able to see calls from self-managed
* {@link ConnectionService}s, and will be able to display an incoming call UI on their
* behalf.</li>
* </ul>
*/
public void onAnswer() {
onAnswer(VideoProfile.STATE_AUDIO_ONLY);
@@ -2765,6 +2792,20 @@ public abstract class Connection extends Conferenceable {
/**
* Notifies this Connection, which is in {@link #STATE_RINGING}, of
* a request to reject.
* <p>
* For managed {@link ConnectionService}s, this will be called when the user rejects a call via
* the default dialer's {@link InCallService}.
* <p>
* Although a self-managed {@link ConnectionService} provides its own incoming call UI, the
* Telecom framework may request that the call is rejected in the following circumstances:
* <ul>
* <li>The user chooses to reject an incoming call via a Bluetooth device.</li>
* <li>A car mode {@link InCallService} is in use which has declared
* {@link TelecomManager#METADATA_INCLUDE_SELF_MANAGED_CALLS} in its manifest. Such an
* {@link InCallService} will be able to see calls from self-managed
* {@link ConnectionService}s, and will be able to display an incoming call UI on their
* behalf.</li>
* </ul>
*/
public void onReject() {}
@@ -2847,9 +2888,10 @@ public abstract class Connection extends Conferenceable {
* should show its own incoming call user interface.
* <p>
* Where there are ongoing calls in other self-managed {@link ConnectionService}s, or in a
* regular {@link ConnectionService}, the Telecom framework will display its own incoming call
* user interface to allow the user to choose whether to answer the new incoming call and
* disconnect other ongoing calls, or to reject the new incoming call.
* regular {@link ConnectionService}, and it is not possible to hold these other calls, the
* Telecom framework will display its own incoming call user interface to allow the user to
* choose whether to answer the new incoming call and disconnect other ongoing calls, or to
* reject the new incoming call.
* <p>
* You should trigger the display of the incoming call user interface for your application by
* showing a {@link Notification} with a full-screen {@link Intent} specified.