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

Commit 2385b5ef authored by Oleg Kibirev's avatar Oleg Kibirev
Browse files

Add a PowerManager @SystemApi to start a dream 

go/startdream

This is a simplier alternative to ag/5460565

Bug: 119130690
Test: Use of API from launcherX
Change-Id: I9b8e1dc04095045077c37014290120efec9dc331
parent 8b46029d

api/system-current.txt

+1 −0
Original line number Diff line number Diff line
@@ -4109,6 +4109,7 @@ package android.os { 
  }



  public final class PowerManager {

    method public void dream(long);

    method public int getPowerSaveMode();

    method public boolean setDynamicPowerSavings(boolean, int);

    method public boolean setPowerSaveMode(boolean);

core/java/android/os/PowerManager.java

+24 −0
Original line number Diff line number Diff line
@@ -24,6 +24,7 @@ import android.annotation.SystemApi; 
import android.annotation.SystemService;

import android.annotation.TestApi;

import android.content.Context;

import android.service.dreams.Sandman;

import android.util.Log;

import android.util.proto.ProtoOutputStream;
@@ -1000,6 +1001,29 @@ public final class PowerManager { 
        }

    }



    /**

     * Requests the device to start dreaming.

     * <p>

     * If dream can not be started, for example if another {@link PowerManager} transition is in

     * progress, does nothing. Unlike {@link #nap(long)}, this does not put device to sleep when

     * dream ends.

     * </p><p>

     * Requires the {@link android.Manifest.permission#WRITE_DREAM_STATE} permission.

     * </p>

     *

     * @param time The time when the request to nap was issued, in the

     * {@link SystemClock#uptimeMillis()} time base.  This timestamp may be used to correctly

     * order the dream request with other power management functions.  It should be set

     * to the timestamp of the input event that caused the request to dream.

     *

     * @hide

     */

    @SystemApi

    @RequiresPermission(android.Manifest.permission.WRITE_DREAM_STATE)

    public void dream(long time) {

        Sandman.startDreamByUserRequest(mContext);

    }



    /**

     * Boosts the brightness of the screen to maximum for a predetermined

     * period of time.  This is used to make the screen more readable in bright