Deprecates the legcay magnifcation APIs of AccessibilityService

Bug: 215555911
Test: manual test
Change-Id: I2d64cee6d23a92340c91aa993a1f9953d7c4ba99
This commit is contained in:
mincheli
2022-01-23 10:50:07 +08:00
committed by Minche Li
parent 03a3c96b49
commit cecea8fe82
2 changed files with 23 additions and 7 deletions

View File

@@ -3137,22 +3137,22 @@ package android.accessibilityservice {
public static final class AccessibilityService.MagnificationController {
method public void addListener(@NonNull android.accessibilityservice.AccessibilityService.MagnificationController.OnMagnificationChangedListener);
method public void addListener(@NonNull android.accessibilityservice.AccessibilityService.MagnificationController.OnMagnificationChangedListener, @Nullable android.os.Handler);
method public float getCenterX();
method public float getCenterY();
method @Deprecated public float getCenterX();
method @Deprecated public float getCenterY();
method @NonNull public android.graphics.Region getCurrentMagnificationRegion();
method @Nullable public android.accessibilityservice.MagnificationConfig getMagnificationConfig();
method @NonNull public android.graphics.Region getMagnificationRegion();
method public float getScale();
method @Deprecated @NonNull public android.graphics.Region getMagnificationRegion();
method @Deprecated public float getScale();
method public boolean removeListener(@NonNull android.accessibilityservice.AccessibilityService.MagnificationController.OnMagnificationChangedListener);
method public boolean reset(boolean);
method public boolean resetCurrentMagnification(boolean);
method public boolean setCenter(float, float, boolean);
method @Deprecated public boolean setCenter(float, float, boolean);
method public boolean setMagnificationConfig(@NonNull android.accessibilityservice.MagnificationConfig, boolean);
method public boolean setScale(float, boolean);
method @Deprecated public boolean setScale(float, boolean);
}
public static interface AccessibilityService.MagnificationController.OnMagnificationChangedListener {
method public void onMagnificationChanged(@NonNull android.accessibilityservice.AccessibilityService.MagnificationController, @NonNull android.graphics.Region, float, float, float);
method @Deprecated public void onMagnificationChanged(@NonNull android.accessibilityservice.AccessibilityService.MagnificationController, @NonNull android.graphics.Region, float, float, float);
method public default void onMagnificationChanged(@NonNull android.accessibilityservice.AccessibilityService.MagnificationController, @NonNull android.graphics.Region, @NonNull android.accessibilityservice.MagnificationConfig);
}

View File

@@ -1400,7 +1400,9 @@ public abstract class AccessibilityService extends Service {
* </p>
*
* @return the current magnification scale
* @deprecated Use {@link #getMagnificationConfig()} instead
*/
@Deprecated
public float getScale() {
final IAccessibilityServiceConnection connection =
AccessibilityInteractionClient.getInstance(mService).getConnection(
@@ -1435,7 +1437,9 @@ public abstract class AccessibilityService extends Service {
*
* @return the unscaled screen-relative X coordinate of the center of
* the magnified region
* @deprecated Use {@link #getMagnificationConfig()} instead
*/
@Deprecated
public float getCenterX() {
final IAccessibilityServiceConnection connection =
AccessibilityInteractionClient.getInstance(mService).getConnection(
@@ -1470,7 +1474,9 @@ public abstract class AccessibilityService extends Service {
*
* @return the unscaled screen-relative Y coordinate of the center of
* the magnified region
* @deprecated Use {@link #getMagnificationConfig()} instead
*/
@Deprecated
public float getCenterY() {
final IAccessibilityServiceConnection connection =
AccessibilityInteractionClient.getInstance(mService).getConnection(
@@ -1509,7 +1515,9 @@ public abstract class AccessibilityService extends Service {
*
* @return the region of the screen currently active for magnification, or an empty region
* if magnification is not active.
* @deprecated Use {@link #getCurrentMagnificationRegion()} instead
*/
@Deprecated
@NonNull
public Region getMagnificationRegion() {
final IAccessibilityServiceConnection connection =
@@ -1677,7 +1685,9 @@ public abstract class AccessibilityService extends Service {
* @param animate {@code true} to animate from the current scale or
* {@code false} to set the scale immediately
* @return {@code true} on success, {@code false} on failure
* @deprecated Use {@link #setMagnificationConfig(MagnificationConfig, boolean)} instead
*/
@Deprecated
public boolean setScale(float scale, boolean animate) {
final IAccessibilityServiceConnection connection =
AccessibilityInteractionClient.getInstance(mService).getConnection(
@@ -1717,7 +1727,9 @@ public abstract class AccessibilityService extends Service {
* @param animate {@code true} to animate from the current viewport
* center or {@code false} to set the center immediately
* @return {@code true} on success, {@code false} on failure
* @deprecated Use {@link #setMagnificationConfig(MagnificationConfig, boolean)} instead
*/
@Deprecated
public boolean setCenter(float centerX, float centerY, boolean animate) {
final IAccessibilityServiceConnection connection =
AccessibilityInteractionClient.getInstance(mService).getConnection(
@@ -1754,7 +1766,11 @@ public abstract class AccessibilityService extends Service {
* magnification is focused
* @param centerY the new Y coordinate, in unscaled coordinates, around which
* magnification is focused
* @deprecated Override
* {@link #onMagnificationChanged(MagnificationController, Region, MagnificationConfig)}
* instead
*/
@Deprecated
void onMagnificationChanged(@NonNull MagnificationController controller,
@NonNull Region region, float scale, float centerX, float centerY);