PowerManagerInternal.java revision 5ce1cb240b13db98fbdc21e1ef069b5f9cec8d72
178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson/* 278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Copyright (C) 2014 The Android Open Source Project 378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Licensed under the Apache License, Version 2.0 (the "License"); 578c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * you may not use this file except in compliance with the License. 678c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * You may obtain a copy of the License at 778c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 878c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * http://www.apache.org/licenses/LICENSE-2.0 978c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 1078c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Unless required by applicable law or agreed to in writing, software 1178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * distributed under the License is distributed on an "AS IS" BASIS, 1278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * See the License for the specific language governing permissions and 1478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * limitations under the License. 1578c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson */ 1678c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 1778c496fe0fac4c89993109340aec80d1afa3141fIan Parkinsonpackage android.os; 1878c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 1978c496fe0fac4c89993109340aec80d1afa3141fIan Parkinsonimport android.view.Display; 2078c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 2178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson/** 2278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Power manager local system service interface. 2378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 2478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * @hide Only for use within the system server. 2578c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson */ 2678c496fe0fac4c89993109340aec80d1afa3141fIan Parkinsonpublic abstract class PowerManagerInternal { 2778c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson /** 2878c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Used by the window manager to override the screen brightness based on the 2978c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * current foreground activity. 3078c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 3178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * This method must only be called by the window manager. 3278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 3378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * @param brightness The overridden brightness, or -1 to disable the override. 3478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson */ 3578c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public abstract void setScreenBrightnessOverrideFromWindowManager(int brightness); 3678c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 3778c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson /** 3878c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Used by the window manager to override the button brightness based on the 3978c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * current foreground activity. 4078c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 4178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * This method must only be called by the window manager. 4278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 4378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * @param brightness The overridden brightness, or -1 to disable the override. 4478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson */ 4578c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public abstract void setButtonBrightnessOverrideFromWindowManager(int brightness); 4678c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 4778c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson /** 4878c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Used by the window manager to override the user activity timeout based on the 4978c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * current foreground activity. It can only be used to make the timeout shorter 5078c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * than usual, not longer. 5178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 5278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * This method must only be called by the window manager. 5378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 5478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * @param timeoutMillis The overridden timeout, or -1 to disable the override. 5578c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson */ 5678c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public abstract void setUserActivityTimeoutOverrideFromWindowManager(long timeoutMillis); 5778c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 5878c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson /** 5978c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Used by device administration to set the maximum screen off timeout. 6078c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 6178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * This method must only be called by the device administration policy manager. 6278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson */ 6378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public abstract void setMaximumScreenOffTimeoutFromDeviceAdmin(int timeMs); 6478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 6578c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson /** 6678c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * Used by the dream manager to override certain properties while dozing. 6778c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * 6878c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * @param screenState The overridden screen state, or {@link Display.STATE_UNKNOWN} 6978c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * to disable the override. 7078c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * @param screenBrightness The overridden screen brightness, or 7178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson * {@link PowerManager#BRIGHTNESS_DEFAULT} to disable the override. 7278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson */ 7378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public abstract void setDozeOverrideFromDreamManager( 7478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson int screenState, int screenBrightness); 7578c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 7678c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public abstract boolean getLowPowerModeEnabled(); 7778c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 7878c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public abstract void registerLowPowerModeObserver(LowPowerModeListener listener); 7978c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson 8078c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public interface LowPowerModeListener { 8178c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson public void onLowPowerModeChanged(boolean enabled); 8278c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson } 8378c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson} 8478c496fe0fac4c89993109340aec80d1afa3141fIan Parkinson