Merge "Document that some Telecom broadcast and extra keys are dead-ends." into rvc-dev am: f7643e91ae

Change-Id: I3c59b57af25d0c4e8378362de94f4c2551783783
This commit is contained in:
Tyler Gunn
2020-03-27 23:00:02 +00:00
committed by Automerger Merge Worker

View File

@@ -193,13 +193,13 @@ public class TelecomManager {
/** /**
* Broadcast intent action indicating that the current default call screening app has changed. * Broadcast intent action indicating that the current default call screening app has changed.
* * <p>
* The string extra {@link #EXTRA_DEFAULT_CALL_SCREENING_APP_COMPONENT_NAME} will contain the * Note: This intent is NEVER actually broadcast and will be deprecated in the future.
* name of the Component of the previous or the new call screening app. * <p>
* * An app that want to know if it holds the
* The boolean extra {@link #EXTRA_IS_DEFAULT_CALL_SCREENING_APP} will indicate the component * {@link android.app.role.RoleManager#ROLE_CALL_SCREENING} role can use
* name in the String extra {@link #EXTRA_DEFAULT_CALL_SCREENING_APP_COMPONENT_NAME} is default * {@link android.app.role.RoleManager#isRoleHeld(String)} to confirm if it holds the role or
* call screening app or not. * not.
*/ */
public static final String ACTION_DEFAULT_CALL_SCREENING_APP_CHANGED = public static final String ACTION_DEFAULT_CALL_SCREENING_APP_CHANGED =
"android.telecom.action.DEFAULT_CALL_SCREENING_APP_CHANGED"; "android.telecom.action.DEFAULT_CALL_SCREENING_APP_CHANGED";
@@ -207,6 +207,8 @@ public class TelecomManager {
/** /**
* Extra value used with {@link #ACTION_DEFAULT_CALL_SCREENING_APP_CHANGED} broadcast to * Extra value used with {@link #ACTION_DEFAULT_CALL_SCREENING_APP_CHANGED} broadcast to
* indicate the ComponentName of the call screening app which has changed. * indicate the ComponentName of the call screening app which has changed.
* <p>
* Note: This extra is NOT used and will be deprecated in the future.
*/ */
public static final String EXTRA_DEFAULT_CALL_SCREENING_APP_COMPONENT_NAME = public static final String EXTRA_DEFAULT_CALL_SCREENING_APP_COMPONENT_NAME =
"android.telecom.extra.DEFAULT_CALL_SCREENING_APP_COMPONENT_NAME"; "android.telecom.extra.DEFAULT_CALL_SCREENING_APP_COMPONENT_NAME";
@@ -214,6 +216,8 @@ public class TelecomManager {
/** /**
* Extra value used with {@link #ACTION_DEFAULT_CALL_SCREENING_APP_CHANGED} broadcast to * Extra value used with {@link #ACTION_DEFAULT_CALL_SCREENING_APP_CHANGED} broadcast to
* indicate whether an app is the default call screening app. * indicate whether an app is the default call screening app.
* <p>
* Note: This extra is NOT used and will be deprecated in the future.
*/ */
public static final String EXTRA_IS_DEFAULT_CALL_SCREENING_APP = public static final String EXTRA_IS_DEFAULT_CALL_SCREENING_APP =
"android.telecom.extra.IS_DEFAULT_CALL_SCREENING_APP"; "android.telecom.extra.IS_DEFAULT_CALL_SCREENING_APP";