Merge "Throw IllegalArgumentException for takeScreenshot()" into rvc-dev

import android.util.SparseArray;

import android.view.Display;

import android.view.KeyEvent;

import android.view.SurfaceControl;

import android.view.SurfaceView;

import android.view.WindowManager;

import android.view.WindowManagerImpl;

     * to declare the capability to take screenshot by setting the

     * {@link android.R.styleable#AccessibilityService_canTakeScreenshot}

     * property in its meta-data. For details refer to {@link #SERVICE_META_DATA}.

     * Besides, This API is only supported for default display now

     * {@link Display#DEFAULT_DISPLAY}.

     * This API only will support {@link Display#DEFAULT_DISPLAY} until {@link SurfaceControl}

     * supports non-default displays.

     * </p>

     *

     * @param displayId The logic display id, must be {@link Display#DEFAULT_DISPLAY} for

     *

     * @return {@code true} if the taking screenshot accepted, {@code false} if too little time

     * has elapsed since the last screenshot, invalid display or internal errors.

     * @throws IllegalArgumentException if displayId is not {@link Display#DEFAULT_DISPLAY}.

     */

    public boolean takeScreenshot(int displayId, @NonNull @CallbackExecutor Executor executor,

            @NonNull Consumer<ScreenshotResult> callback) {

        Preconditions.checkNotNull(executor, "executor cannot be null");

        Preconditions.checkNotNull(callback, "callback cannot be null");

        if (displayId != Display.DEFAULT_DISPLAY) {

            throw new IllegalArgumentException("DisplayId isn't the default display");

        }

        final IAccessibilityServiceConnection connection =

                AccessibilityInteractionClient.getInstance().getConnection(

                        mConnectionId);