diff options
| -rw-r--r-- | api/current.txt | 3 | ||||
| -rw-r--r-- | api/system-current.txt | 3 | ||||
| -rw-r--r-- | api/test-current.txt | 3 | ||||
| -rw-r--r-- | telecomm/java/android/telecom/Call.java | 9 | ||||
| -rw-r--r-- | telecomm/java/android/telecom/TelecomManager.java | 53 | ||||
| -rw-r--r-- | telecomm/java/com/android/internal/telecom/ITelecomService.aidl | 5 |
6 files changed, 73 insertions, 3 deletions
diff --git a/api/current.txt b/api/current.txt index 6359d8d094ed..0872b2d7d707 100644 --- a/api/current.txt +++ b/api/current.txt @@ -38231,6 +38231,7 @@ package android.telecom { field public static final int PROPERTY_HAS_CDMA_VOICE_PRIVACY = 128; // 0x80 field public static final int PROPERTY_HIGH_DEF_AUDIO = 16; // 0x10 field public static final int PROPERTY_IS_EXTERNAL_CALL = 64; // 0x40 + field public static final int PROPERTY_SELF_MANAGED = 256; // 0x100 field public static final int PROPERTY_WIFI = 8; // 0x8 } @@ -38800,6 +38801,7 @@ package android.telecom { method public boolean handleMmi(java.lang.String); method public boolean handleMmi(java.lang.String, android.telecom.PhoneAccountHandle); method public boolean isInCall(); + method public boolean isInManagedCall(); method public boolean isIncomingCallPermitted(android.telecom.PhoneAccountHandle); method public boolean isOutgoingCallPermitted(android.telecom.PhoneAccountHandle); method public boolean isVoiceMailNumber(android.telecom.PhoneAccountHandle, java.lang.String); @@ -38836,6 +38838,7 @@ package android.telecom { field public static final java.lang.String GATEWAY_ORIGINAL_ADDRESS = "android.telecom.extra.GATEWAY_ORIGINAL_ADDRESS"; field public static final java.lang.String GATEWAY_PROVIDER_PACKAGE = "android.telecom.extra.GATEWAY_PROVIDER_PACKAGE"; field public static final java.lang.String METADATA_INCLUDE_EXTERNAL_CALLS = "android.telecom.INCLUDE_EXTERNAL_CALLS"; + field public static final java.lang.String METADATA_INCLUDE_SELF_MANAGED_CALLS = "android.telecom.INCLUDE_SELF_MANAGED_CALLS"; field public static final java.lang.String METADATA_IN_CALL_SERVICE_RINGING = "android.telecom.IN_CALL_SERVICE_RINGING"; field public static final java.lang.String METADATA_IN_CALL_SERVICE_UI = "android.telecom.IN_CALL_SERVICE_UI"; field public static final int PRESENTATION_ALLOWED = 1; // 0x1 diff --git a/api/system-current.txt b/api/system-current.txt index 8c14bac2a5e0..c321e08619c8 100644 --- a/api/system-current.txt +++ b/api/system-current.txt @@ -41281,6 +41281,7 @@ package android.telecom { field public static final int PROPERTY_HAS_CDMA_VOICE_PRIVACY = 128; // 0x80 field public static final int PROPERTY_HIGH_DEF_AUDIO = 16; // 0x10 field public static final int PROPERTY_IS_EXTERNAL_CALL = 64; // 0x40 + field public static final int PROPERTY_SELF_MANAGED = 256; // 0x100 field public static final int PROPERTY_WIFI = 8; // 0x8 } @@ -42040,6 +42041,7 @@ package android.telecom { method public boolean handleMmi(java.lang.String); method public boolean handleMmi(java.lang.String, android.telecom.PhoneAccountHandle); method public boolean isInCall(); + method public boolean isInManagedCall(); method public boolean isIncomingCallPermitted(android.telecom.PhoneAccountHandle); method public boolean isOutgoingCallPermitted(android.telecom.PhoneAccountHandle); method public boolean isRinging(); @@ -42083,6 +42085,7 @@ package android.telecom { field public static final java.lang.String GATEWAY_ORIGINAL_ADDRESS = "android.telecom.extra.GATEWAY_ORIGINAL_ADDRESS"; field public static final java.lang.String GATEWAY_PROVIDER_PACKAGE = "android.telecom.extra.GATEWAY_PROVIDER_PACKAGE"; field public static final java.lang.String METADATA_INCLUDE_EXTERNAL_CALLS = "android.telecom.INCLUDE_EXTERNAL_CALLS"; + field public static final java.lang.String METADATA_INCLUDE_SELF_MANAGED_CALLS = "android.telecom.INCLUDE_SELF_MANAGED_CALLS"; field public static final java.lang.String METADATA_IN_CALL_SERVICE_RINGING = "android.telecom.IN_CALL_SERVICE_RINGING"; field public static final java.lang.String METADATA_IN_CALL_SERVICE_UI = "android.telecom.IN_CALL_SERVICE_UI"; field public static final int PRESENTATION_ALLOWED = 1; // 0x1 diff --git a/api/test-current.txt b/api/test-current.txt index 06f8b5aa41da..584903293669 100644 --- a/api/test-current.txt +++ b/api/test-current.txt @@ -38415,6 +38415,7 @@ package android.telecom { field public static final int PROPERTY_HAS_CDMA_VOICE_PRIVACY = 128; // 0x80 field public static final int PROPERTY_HIGH_DEF_AUDIO = 16; // 0x10 field public static final int PROPERTY_IS_EXTERNAL_CALL = 64; // 0x40 + field public static final int PROPERTY_SELF_MANAGED = 256; // 0x100 field public static final int PROPERTY_WIFI = 8; // 0x8 } @@ -38984,6 +38985,7 @@ package android.telecom { method public boolean handleMmi(java.lang.String); method public boolean handleMmi(java.lang.String, android.telecom.PhoneAccountHandle); method public boolean isInCall(); + method public boolean isInManagedCall(); method public boolean isIncomingCallPermitted(android.telecom.PhoneAccountHandle); method public boolean isOutgoingCallPermitted(android.telecom.PhoneAccountHandle); method public boolean isVoiceMailNumber(android.telecom.PhoneAccountHandle, java.lang.String); @@ -39020,6 +39022,7 @@ package android.telecom { field public static final java.lang.String GATEWAY_ORIGINAL_ADDRESS = "android.telecom.extra.GATEWAY_ORIGINAL_ADDRESS"; field public static final java.lang.String GATEWAY_PROVIDER_PACKAGE = "android.telecom.extra.GATEWAY_PROVIDER_PACKAGE"; field public static final java.lang.String METADATA_INCLUDE_EXTERNAL_CALLS = "android.telecom.INCLUDE_EXTERNAL_CALLS"; + field public static final java.lang.String METADATA_INCLUDE_SELF_MANAGED_CALLS = "android.telecom.INCLUDE_SELF_MANAGED_CALLS"; field public static final java.lang.String METADATA_IN_CALL_SERVICE_RINGING = "android.telecom.IN_CALL_SERVICE_RINGING"; field public static final java.lang.String METADATA_IN_CALL_SERVICE_UI = "android.telecom.IN_CALL_SERVICE_UI"; field public static final int PRESENTATION_ALLOWED = 1; // 0x1 diff --git a/telecomm/java/android/telecom/Call.java b/telecomm/java/android/telecom/Call.java index 3f7c908436a4..5bb479fdeea5 100644 --- a/telecomm/java/android/telecom/Call.java +++ b/telecomm/java/android/telecom/Call.java @@ -328,8 +328,15 @@ public final class Call { */ public static final int PROPERTY_HAS_CDMA_VOICE_PRIVACY = 0x00000080; + /** + * Indicates that the call is from a self-managed {@link ConnectionService}. + * <p> + * See also {@link Connection#PROPERTY_SELF_MANAGED} + */ + public static final int PROPERTY_SELF_MANAGED = 0x00000100; + //****************************************************************************************** - // Next PROPERTY value: 0x00000100 + // Next PROPERTY value: 0x00000200 //****************************************************************************************** private final String mTelecomCallId; diff --git a/telecomm/java/android/telecom/TelecomManager.java b/telecomm/java/android/telecom/TelecomManager.java index 2e144f24bfa9..359dcb1ec39a 100644 --- a/telecomm/java/android/telecom/TelecomManager.java +++ b/telecomm/java/android/telecom/TelecomManager.java @@ -373,6 +373,24 @@ public class TelecomManager { "android.telecom.INCLUDE_EXTERNAL_CALLS"; /** + * A boolean meta-data value indicating whether an {@link InCallService} wants to be informed of + * calls which have the {@link Call.Details#PROPERTY_SELF_MANAGED} property. A self-managed + * call is one which originates from a self-managed {@link ConnectionService} which has chosen + * to implement its own call user interface. An {@link InCallService} implementation which + * would like to be informed of external calls should set this meta-data to {@code true} in the + * manifest registration of their {@link InCallService}. By default, the {@link InCallService} + * will NOT be informed about self-managed calls. + * <p> + * An {@link InCallService} which receives self-managed calls is free to view and control the + * state of calls in the self-managed {@link ConnectionService}. An example use-case is + * exposing these calls to a wearable or automotive device via its companion app. + * <p> + * See also {@link Connection#PROPERTY_SELF_MANAGED}. + */ + public static final String METADATA_INCLUDE_SELF_MANAGED_CALLS = + "android.telecom.INCLUDE_SELF_MANAGED_CALLS"; + + /** * The dual tone multi-frequency signaling character sent to indicate the dialing system should * pause for a predefined period. */ @@ -1051,10 +1069,12 @@ public class TelecomManager { /** * Returns whether there is an ongoing phone call (can be in dialing, ringing, active or holding - * states). + * states) originating from either a manager or self-managed {@link ConnectionService}. * <p> * Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE} - * </p> + * + * @return {@code true} if there is an ongoing call in either a managed or self-managed + * {@link ConnectionService}, {@code false} otherwise. */ @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE) public boolean isInCall() { @@ -1069,6 +1089,31 @@ public class TelecomManager { } /** + * Returns whether there is an ongoing call originating from a managed + * {@link ConnectionService}. An ongoing call can be in dialing, ringing, active or holding + * states. + * <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. + */ + @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE) + public boolean isInManagedCall() { + try { + if (isServiceConnected()) { + return getTelecomService().isInManagedCall(mContext.getOpPackageName()); + } + } catch (RemoteException e) { + Log.e(TAG, "RemoteException calling isInManagedCall().", e); + } + return false; + } + + /** * Returns one of the following constants that represents the current state of Telecom: * * {@link TelephonyManager#CALL_STATE_RINGING} @@ -1079,6 +1124,9 @@ public class TelecomManager { * {@link android.Manifest.permission#READ_PHONE_STATE} permission. This is intentional, to * preserve the behavior of {@link TelephonyManager#getCallState()}, which also did not require * the permission. + * + * Takes into consideration both managed and self-managed calls. + * * @hide */ @SystemApi @@ -1096,6 +1144,7 @@ public class TelecomManager { /** * Returns whether there currently exists is a ringing incoming-call. * + * @return {@code true} if there is a managed or self-managed ringing call. * @hide */ @SystemApi diff --git a/telecomm/java/com/android/internal/telecom/ITelecomService.aidl b/telecomm/java/com/android/internal/telecom/ITelecomService.aidl index eb1cde393cd4..87402243a452 100644 --- a/telecomm/java/com/android/internal/telecom/ITelecomService.aidl +++ b/telecomm/java/com/android/internal/telecom/ITelecomService.aidl @@ -165,6 +165,11 @@ interface ITelecomService { boolean isInCall(String callingPackage); /** + * @see TelecomServiceImpl#isInManagedCall + */ + boolean isInManagedCall(String callingPackage); + + /** * @see TelecomServiceImpl#isRinging */ boolean isRinging(String callingPackage); |