1/* 2 * Copyright (C) 2013 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16package com.android.internal.policy; 17 18import com.android.internal.policy.IKeyguardDrawnCallback; 19import com.android.internal.policy.IKeyguardStateCallback; 20import com.android.internal.policy.IKeyguardExitCallback; 21 22import android.os.Bundle; 23 24oneway interface IKeyguardService { 25 26 /** 27 * Sets the Keyguard as occluded when a window dismisses the Keyguard with flag 28 * FLAG_SHOW_ON_LOCK_SCREEN. 29 * 30 * @param isOccluded Whether the Keyguard is occluded by another window. 31 */ 32 void setOccluded(boolean isOccluded); 33 34 void addStateMonitorCallback(IKeyguardStateCallback callback); 35 void verifyUnlock(IKeyguardExitCallback callback); 36 void keyguardDone(boolean authenticated, boolean wakeup); 37 void dismiss(); 38 void onDreamingStarted(); 39 void onDreamingStopped(); 40 41 /** 42 * Called when the device has started going to sleep. 43 * 44 * @param why {@link #OFF_BECAUSE_OF_USER}, {@link #OFF_BECAUSE_OF_ADMIN}, 45 * or {@link #OFF_BECAUSE_OF_TIMEOUT}. 46 */ 47 void onStartedGoingToSleep(int reason); 48 49 /** 50 * Called when the device has finished going to sleep. 51 * 52 * @param why {@link #OFF_BECAUSE_OF_USER}, {@link #OFF_BECAUSE_OF_ADMIN}, 53 * or {@link #OFF_BECAUSE_OF_TIMEOUT}. 54 */ 55 void onFinishedGoingToSleep(int reason); 56 57 /** 58 * Called when the device has started waking up. 59 */ 60 void onStartedWakingUp(); 61 62 /** 63 * Called when the device screen is turning on. 64 */ 65 void onScreenTurningOn(IKeyguardDrawnCallback callback); 66 67 /** 68 * Called when the screen has actually turned on. 69 */ 70 void onScreenTurnedOn(); 71 72 /** 73 * Called when the screen has turned off. 74 */ 75 void onScreenTurnedOff(); 76 77 void setKeyguardEnabled(boolean enabled); 78 void onSystemReady(); 79 void doKeyguardTimeout(in Bundle options); 80 void setCurrentUser(int userId); 81 void onBootCompleted(); 82 83 /** 84 * Notifies that the activity behind has now been drawn and it's safe to remove the wallpaper 85 * and keyguard flag. 86 * 87 * @param startTime the start time of the animation in uptime milliseconds 88 * @param fadeoutDuration the duration of the exit animation, in milliseconds 89 */ 90 void startKeyguardExitAnimation(long startTime, long fadeoutDuration); 91 92 /** 93 * Notifies the Keyguard that the activity that was starting has now been drawn and it's safe 94 * to start the keyguard dismiss sequence. 95 */ 96 void onActivityDrawn(); 97} 98