113 lines
4.1 KiB
Java
113 lines
4.1 KiB
Java
/*
|
|
* Copyright (C) 2019 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package com.android.server;
|
|
|
|
import android.annotation.NonNull;
|
|
import android.annotation.Nullable;
|
|
import android.os.PowerExemptionManager;
|
|
import android.os.PowerExemptionManager.ReasonCode;
|
|
import android.os.PowerExemptionManager.TempAllowListType;
|
|
|
|
import com.android.server.deviceidle.IDeviceIdleConstraint;
|
|
|
|
public interface DeviceIdleInternal {
|
|
void onConstraintStateChanged(IDeviceIdleConstraint constraint, boolean active);
|
|
|
|
void registerDeviceIdleConstraint(IDeviceIdleConstraint constraint, String name,
|
|
@IDeviceIdleConstraint.MinimumState int minState);
|
|
|
|
void unregisterDeviceIdleConstraint(IDeviceIdleConstraint constraint);
|
|
|
|
void exitIdle(String reason);
|
|
|
|
/**
|
|
* Same as {@link #addPowerSaveTempWhitelistApp(int, String, long, int, boolean, int, String)}
|
|
* with {@link PowerExemptionManager#TEMPORARY_ALLOW_LIST_TYPE_FOREGROUND_SERVICE_ALLOWED}.
|
|
*/
|
|
void addPowerSaveTempWhitelistApp(int callingUid, String packageName,
|
|
long durationMs, int userId, boolean sync, @ReasonCode int reasonCode,
|
|
@Nullable String reason);
|
|
|
|
/**
|
|
* Put a package in the temp-allowlist.
|
|
*/
|
|
void addPowerSaveTempWhitelistApp(int callingUid, String packageName,
|
|
long durationMs, @TempAllowListType int tempAllowListType, int userId, boolean sync,
|
|
@ReasonCode int reasonCode, @Nullable String reason);
|
|
|
|
/**
|
|
* Called by ActivityManagerService to directly add UID to DeviceIdleController's temp
|
|
* allowlist.
|
|
* @param uid
|
|
* @param duration duration in milliseconds
|
|
* @param type temp allowlist type defined at {@link TempAllowListType}
|
|
* @param sync
|
|
* @param reasonCode one of {@link ReasonCode}
|
|
* @param reason
|
|
* @param callingUid UID of app who added this temp-allowlist.
|
|
*/
|
|
void addPowerSaveTempWhitelistAppDirect(int uid, long duration,
|
|
@TempAllowListType int type, boolean sync, @ReasonCode int reasonCode,
|
|
@Nullable String reason, int callingUid);
|
|
|
|
// duration in milliseconds
|
|
long getNotificationAllowlistDuration();
|
|
|
|
void setJobsActive(boolean active);
|
|
|
|
// Up-call from alarm manager.
|
|
void setAlarmsActive(boolean active);
|
|
|
|
boolean isAppOnWhitelist(int appid);
|
|
|
|
int[] getPowerSaveWhitelistUserAppIds();
|
|
|
|
int[] getPowerSaveTempWhitelistAppIds();
|
|
|
|
@NonNull
|
|
String[] getFullPowerWhitelistExceptIdle();
|
|
|
|
/**
|
|
* Listener to be notified when DeviceIdleController determines that the device has moved or is
|
|
* stationary.
|
|
*/
|
|
interface StationaryListener {
|
|
void onDeviceStationaryChanged(boolean isStationary);
|
|
}
|
|
|
|
/**
|
|
* Registers a listener that will be notified when the system has detected that the device is
|
|
* stationary or in motion.
|
|
*/
|
|
void registerStationaryListener(StationaryListener listener);
|
|
|
|
/**
|
|
* Unregisters a registered stationary listener from being notified when the system has detected
|
|
* that the device is stationary or in motion.
|
|
*/
|
|
void unregisterStationaryListener(StationaryListener listener);
|
|
|
|
/**
|
|
* Apply some restrictions on temp allowlist type based on the reasonCode.
|
|
* @param reasonCode temp allowlist reason code.
|
|
* @param defaultType default temp allowlist type if reasonCode can not decide a type.
|
|
* @return temp allowlist type based on the reasonCode.
|
|
*/
|
|
@TempAllowListType int getTempAllowListType(@ReasonCode int reasonCode,
|
|
@TempAllowListType int defaultType);
|
|
}
|