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

Commit 65b486ee authored by Louis Chang's avatar Louis Chang
Browse files

Add public API for converting activity translucency 

Adding API to allow activities to turn off translucency
and also allow them turn it back.

Bug: 31802094
Test: atest ActivityVisibilityTests

Change-Id: I3038cdb1ca0058eaaaea3e249e536576ff1b6540
parent 3afc6731

api/current.txt

+1 −0
Original line number Diff line number Diff line
@@ -3881,6 +3881,7 @@ package android.app { 
    method public void setTitle(CharSequence);

    method public void setTitle(int);

    method @Deprecated public void setTitleColor(int);

    method public boolean setTranslucent(boolean);

    method public void setTurnScreenOn(boolean);

    method public void setVisible(boolean);

    method public final void setVolumeControlStream(int);

core/java/android/app/Activity.java

+32 −16
Original line number Diff line number Diff line
@@ -7098,14 +7098,28 @@ public class Activity extends ContextThemeWrapper 
    }



    /**

     * Convert a translucent themed Activity {@link android.R.attr#windowIsTranslucent} to a

     * fullscreen opaque Activity.

     * <p>

     * Call this whenever the background of a translucent Activity has changed to become opaque.

     * Doing so will allow the {@link android.view.Surface} of the Activity behind to be released.

     * Convert an activity, which particularly with {@link android.R.attr#windowIsTranslucent} or

     * {@link android.R.attr#windowIsFloating} attribute, to a fullscreen opaque activity, or

     * convert it from opaque back to translucent.

     *

     * @param translucent {@code true} convert from opaque to translucent.

     *                    {@code false} convert from translucent to opaque.

     * @return The result of setting translucency. Return {@code true} if set successfully,

     *         {@code false} otherwise.

     */

    public boolean setTranslucent(boolean translucent) {

        if (translucent) {

            return convertToTranslucent(null /* callback */, null /* options */);

        } else {

            return convertFromTranslucentInternal();

        }

    }



    /**

     * Convert an activity to a fullscreen opaque activity.

     * <p>

     * This call has no effect on non-translucent activities or on activities with the

     * {@link android.R.attr#windowIsFloating} attribute.

     * Call this whenever the background of a translucent activity has changed to become opaque.

     * Doing so will allow the {@link android.view.Surface} of the activity behind to be released.

     *

     * @see #convertToTranslucent(android.app.Activity.TranslucentConversionListener,

     * ActivityOptions)
@@ -7115,31 +7129,33 @@ public class Activity extends ContextThemeWrapper 
     */

    @SystemApi

    public void convertFromTranslucent() {

        convertFromTranslucentInternal();

    }



    private boolean convertFromTranslucentInternal() {

        try {

            mTranslucentCallback = null;

            if (ActivityTaskManager.getService().convertFromTranslucent(mToken)) {

                WindowManagerGlobal.getInstance().changeCanvasOpacity(mToken, true);

                return true;

            }

        } catch (RemoteException e) {

            // pass

        }

        return false;

    }



    /**

     * Convert a translucent themed Activity {@link android.R.attr#windowIsTranslucent} back from

     * opaque to translucent following a call to {@link #convertFromTranslucent()}.

     * Convert an activity to a translucent activity.

     * <p>

     * Calling this allows the Activity behind this one to be seen again. Once all such Activities

     * Calling this allows the activity behind this one to be seen again. Once all such activities

     * have been redrawn {@link TranslucentConversionListener#onTranslucentConversionComplete} will

     * be called indicating that it is safe to make this activity translucent again. Until

     * {@link TranslucentConversionListener#onTranslucentConversionComplete} is called the image

     * behind the frontmost Activity will be indeterminate.

     * <p>

     * This call has no effect on non-translucent activities or on activities with the

     * {@link android.R.attr#windowIsFloating} attribute.

     * behind the frontmost activity will be indeterminate.

     *

     * @param callback the method to call when all visible Activities behind this one have been

     * drawn and it is safe to make this Activity translucent again.

     * @param callback the method to call when all visible activities behind this one have been

     * drawn and it is safe to make this activity translucent again.

     * @param options activity options delivered to the activity below this one. The options

     * are retrieved using {@link #getActivityOptions}.

     * @return <code>true</code> if Window was opaque and will become translucent or