Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 7c91f43c authored by mincheli's avatar mincheli
Browse files

Adds public APIs for AccessibilityService to control magnifier by setting MagnificationConfig 

See go/b200769372
AccessibilityService adds new magnificationController APIs,
setMagnificationConfig and getMagnificationConfig, to control
magnification on demand.
The service can set the magnification mode, scale, center postion
of the magnifier on the display to control magnification.
And the service controls the least recently activated magnifier
on the display if the config mode is not specified.

Bug: 199732498
Test: atest MagnificationProcessorTest,
    atest  AbstractAccessibilityServiceConnectionTest,
    atest AccessibilityMagnificationTest,
Change-Id: I51be2bbf96411c6c54c9da30873556d09533bb65
parent 06299b95

core/api/current.txt

+2 −0
Original line number Diff line number Diff line
@@ -3121,11 +3121,13 @@ package android.accessibilityservice { 
    method public void addListener(@NonNull android.accessibilityservice.AccessibilityService.MagnificationController.OnMagnificationChangedListener, @Nullable android.os.Handler);

    method public float getCenterX();

    method public float getCenterY();

    method @Nullable public android.accessibilityservice.MagnificationConfig getMagnificationConfig();

    method @NonNull public android.graphics.Region getMagnificationRegion();

    method public float getScale();

    method public boolean removeListener(@NonNull android.accessibilityservice.AccessibilityService.MagnificationController.OnMagnificationChangedListener);

    method public boolean reset(boolean);

    method public boolean setCenter(float, float, boolean);

    method public boolean setMagnificationConfig(@NonNull android.accessibilityservice.MagnificationConfig, boolean);

    method public boolean setScale(float, boolean);

  }

























core/java/android/accessibilityservice/AccessibilityService.java



+66
−4




























Original line number
Diff line number
Diff line








@@ -16,6 +16,7 @@





























package android.accessibilityservice;





























import static android.accessibilityservice.MagnificationConfig.MAGNIFICATION_MODE_FULLSCREEN;















import static android.view.WindowManager.LayoutParams.TYPE_ACCESSIBILITY_OVERLAY;































import android.accessibilityservice.GestureDescription.MotionEventGenerator;










@@ -1358,6 +1359,32 @@ public abstract class AccessibilityService extends Service {













            }















        }





























        /**













         * Gets the {@link MagnificationConfig} of the controlling magnifier on the display.













         * <p>













         * <strong>Note:</strong> If the service is not yet connected (e.g.













         * {@link AccessibilityService#onServiceConnected()} has not yet been













         * called) or the service has been disconnected, this method will













         * return null.













         * </p>













         *













         * @return the magnification config that the service controls













         */













        public @Nullable MagnificationConfig getMagnificationConfig() {













            final IAccessibilityServiceConnection connection =













                    AccessibilityInteractionClient.getInstance(mService).getConnection(













                            mService.mConnectionId);













            if (connection != null) {













                try {













                    return connection.getMagnificationConfig(mDisplayId);













                } catch (RemoteException re) {













                    Log.w(LOG_TAG, "Failed to obtain magnification config", re);













                    re.rethrowFromSystemServer();













                }













            }













            return null;













        }





























        /**















         * Returns the current magnification scale.















         * <p>










@@ -1504,6 +1531,37 @@ public abstract class AccessibilityService extends Service {













            return false;















        }





























        /**













         * Sets the {@link MagnificationConfig}. The service controls the magnification by













         * setting the config.













         * <p>













         * <strong>Note:</strong> If the service is not yet connected (e.g.













         * {@link AccessibilityService#onServiceConnected()} has not yet been













         * called) or the service has been disconnected, this method will have













         * no effect and return {@code false}.













         * </p>













         *













         * @param config the magnification config













         * @param animate {@code true} to animate from the current spec or













         *                {@code false} to set the spec immediately













         * @return {@code true} on success, {@code false} on failure













         */













        public boolean setMagnificationConfig(@NonNull MagnificationConfig config,













                boolean animate) {













            final IAccessibilityServiceConnection connection =













                    AccessibilityInteractionClient.getInstance(mService).getConnection(













                            mService.mConnectionId);













            if (connection != null) {













                try {













                    return connection.setMagnificationConfig(mDisplayId, config, animate);













                } catch (RemoteException re) {













                    Log.w(LOG_TAG, "Failed to set magnification config", re);













                    re.rethrowFromSystemServer();













                }













            }













            return false;













        }





























        /**















         * Sets the magnification scale.















         * <p>









@@ -1523,8 +1581,10 @@ public abstract class AccessibilityService extends Service {













                            mService.mConnectionId);















            if (connection != null) {















                try {













                    return connection.setMagnificationScaleAndCenter(mDisplayId,













                            scale, Float.NaN, Float.NaN, animate);













                    final MagnificationConfig config = new MagnificationConfig.Builder()













                            .setMode(MAGNIFICATION_MODE_FULLSCREEN)













                            .setScale(scale).build();













                    return connection.setMagnificationConfig(mDisplayId, config, animate);















                } catch (RemoteException re) {















                    Log.w(LOG_TAG, "Failed to set scale", re);















                    re.rethrowFromSystemServer();










@@ -1555,8 +1615,10 @@ public abstract class AccessibilityService extends Service {













                            mService.mConnectionId);















            if (connection != null) {















                try {













                    return connection.setMagnificationScaleAndCenter(mDisplayId,













                            Float.NaN, centerX, centerY, animate);













                    final MagnificationConfig config = new MagnificationConfig.Builder()













                            .setMode(MAGNIFICATION_MODE_FULLSCREEN)













                            .setCenterX(centerX).setCenterY(centerY).build();













                    return connection.setMagnificationConfig(mDisplayId, config, animate);















                } catch (RemoteException re) {















                    Log.w(LOG_TAG, "Failed to set center", re);















                    re.rethrowFromSystemServer();

































core/java/android/accessibilityservice/IAccessibilityServiceConnection.aidl



+4
−2




























Original line number
Diff line number
Diff line








@@ -17,6 +17,7 @@













package android.accessibilityservice;































import android.accessibilityservice.AccessibilityServiceInfo;













import android.accessibilityservice.MagnificationConfig;















import android.content.pm.ParceledListSlice;















import android.graphics.Bitmap;















import android.graphics.Region;










@@ -77,6 +78,8 @@ interface IAccessibilityServiceConnection {





























    oneway void setOnKeyEventResult(boolean handled, int sequence);





























    MagnificationConfig getMagnificationConfig(int displayId);





























    float getMagnificationScale(int displayId);































    float getMagnificationCenterX(int displayId);









@@ -87,8 +90,7 @@ interface IAccessibilityServiceConnection {





























    boolean resetMagnification(int displayId, boolean animate);





























    boolean setMagnificationScaleAndCenter(int displayId, float scale, float centerX, float centerY,













        boolean animate);













    boolean setMagnificationConfig(int displayId, in MagnificationConfig config, boolean animate);































    void setMagnificationCallbackEnabled(int displayId, boolean enabled);

















































core/tests/coretests/src/android/view/accessibility/AccessibilityServiceConnectionImpl.java



+8
−2




























Original line number
Diff line number
Diff line








@@ -18,6 +18,8 @@ package android.view.accessibility;





























import android.accessibilityservice.AccessibilityServiceInfo;















import android.accessibilityservice.IAccessibilityServiceConnection;













import android.accessibilityservice.MagnificationConfig;













import android.annotation.NonNull;















import android.content.pm.ParceledListSlice;















import android.graphics.Region;















import android.os.Bundle;










@@ -97,6 +99,10 @@ public class AccessibilityServiceConnectionImpl extends IAccessibilityServiceCon





























    public void setOnKeyEventResult(boolean handled, int sequence) {}





























    public MagnificationConfig getMagnificationConfig(int displayId) {













        return null;













    }





























    public float getMagnificationScale(int displayId) {















        return 0.0f;















    }









@@ -117,8 +123,8 @@ public class AccessibilityServiceConnectionImpl extends IAccessibilityServiceCon













        return false;















    }





























    public boolean setMagnificationScaleAndCenter(int displayId, float scale, float centerX,













            float centerY, boolean animate) {













    public boolean setMagnificationConfig(int displayId,













            @NonNull MagnificationConfig config, boolean animate) {















        return false;















    }

















































services/accessibility/java/com/android/server/accessibility/AbstractAccessibilityServiceConnection.java



+23
−9




























Original line number
Diff line number
Diff line








@@ -976,6 +976,25 @@ abstract class AbstractAccessibilityServiceConnection extends IAccessibilityServ













        return false;















    }





























    @Nullable













    @Override













    public MagnificationConfig getMagnificationConfig(int displayId) {













        if (svcConnTracingEnabled()) {













            logTraceSvcConn("getMagnificationConfig", "displayId=" + displayId);













        }













        synchronized (mLock) {













            if (!hasRightsToCurrentUserLocked()) {













                return null;













            }













        }













        final long identity = Binder.clearCallingIdentity();













        try {













            return mSystemSupport.getMagnificationProcessor().getMagnificationConfig(displayId);













        } finally {













            Binder.restoreCallingIdentity(identity);













        }













    }





























    @Override















    public float getMagnificationScale(int displayId) {















        if (svcConnTracingEnabled()) {










@@ -1084,12 +1103,11 @@ abstract class AbstractAccessibilityServiceConnection extends IAccessibilityServ













    }































    @Override













    public boolean setMagnificationScaleAndCenter(int displayId, float scale, float centerX,













            float centerY, boolean animate) {













    public boolean setMagnificationConfig(int displayId,













            @NonNull MagnificationConfig config, boolean animate) {















        if (svcConnTracingEnabled()) {













            logTraceSvcConn("setMagnificationScaleAndCenter",













                    "displayId=" + displayId + ";scale=" + scale + ";centerX=" + centerX













                    + ";centerY=" + centerY + ";animate=" + animate);













            logTraceSvcConn("setMagnificationSpec",













                    "displayId=" + displayId + ", config=" + config.toString());















        }















        synchronized (mLock) {















            if (!hasRightsToCurrentUserLocked()) {









@@ -1102,10 +1120,6 @@ abstract class AbstractAccessibilityServiceConnection extends IAccessibilityServ













            try {















                MagnificationProcessor magnificationProcessor =















                        mSystemSupport.getMagnificationProcessor();













                final MagnificationConfig config = new MagnificationConfig.Builder()













                        .setScale(scale)













                        .setCenterX(centerX)













                        .setCenterY(centerY).build();















                return magnificationProcessor.setMagnificationConfig(displayId, config, animate,















                        mId);















            } finally {