Further handover support changes.
Add handover extras key used when initiating handover.
Add handover complete / fail connection events which are sent to the
initiating IncallService when a handover is complete or fails.
Adding PhoneAccount extra to indicate that a self-managed CS should have
its calls logged to the call log.
Test: Manual
Bug: 37102939
Change-Id: Icbb6f1addf913de841a9c48089a7d8311668f3bc
diff --git a/telecomm/java/android/telecom/TelecomManager.java b/telecomm/java/android/telecom/TelecomManager.java
index 852610e..357fd2b 100644
--- a/telecomm/java/android/telecom/TelecomManager.java
+++ b/telecomm/java/android/telecom/TelecomManager.java
@@ -344,16 +344,35 @@
"android.telecom.extra.NEW_OUTGOING_CALL_CANCEL_TIMEOUT";
/**
- * Boolean extra specified when calling {@link #addNewIncomingCall(PhoneAccountHandle, Bundle)}
- * to indicate to Telecom that the purpose of adding a new incoming call is to handover an
+ * Boolean extra specified to indicate that the intention of adding a call is to handover an
* existing call from the user's device to a different {@link PhoneAccount}.
* <p>
+ * Used when calling {@link #addNewIncomingCall(PhoneAccountHandle, Bundle)}
+ * to indicate to Telecom that the purpose of adding a new incoming call is to handover an
+ * existing call from the user's device to a different {@link PhoneAccount}. This occurs on
+ * the receiving side of a handover.
+ * <p>
+ * Used when Telecom calls
+ * {@link ConnectionService#onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)}
+ * to indicate that the purpose of Telecom requesting a new outgoing connection it to request
+ * a handover to this {@link ConnectionService} from an ongoing call on the user's device. This
+ * occurs on the initiating side of a handover.
+ * <p>
* The phone number of the call used by Telecom to determine which call should be handed over.
* @hide
*/
public static final String EXTRA_IS_HANDOVER = "android.telecom.extra.IS_HANDOVER";
/**
+ * Extra key specified in the {@link ConnectionRequest#getExtras()} when Telecom calls
+ * {@link ConnectionService#onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)}
+ * to inform the {@link ConnectionService} what the initial {@link CallAudioState} of the
+ * {@link Connection} will be.
+ * @hide
+ */
+ public static final String EXTRA_CALL_AUDIO_STATE = "android.telecom.extra.CALL_AUDIO_STATE";
+
+ /**
* A boolean extra, which when set on the {@link Intent#ACTION_CALL} intent or on the bundle
* passed into {@link #placeCall(Uri, Bundle)}, indicates that the call should be initiated with
* an RTT session open. See {@link android.telecom.Call.RttCall} for more information on RTT.