1 /*
2  * Copyright (C) 2007 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  */
16 
17 
18 package android.app;
19 
20 import android.annotation.IntDef;
21 import android.content.Context;
22 import android.os.Binder;
23 import android.os.RemoteException;
24 import android.os.IBinder;
25 import android.os.ServiceManager;
26 import android.util.Slog;
27 import android.view.View;
28 
29 import com.android.internal.statusbar.IStatusBarService;
30 
31 import java.lang.annotation.Retention;
32 import java.lang.annotation.RetentionPolicy;
33 
34 /**
35  * Allows an app to control the status bar.
36  *
37  * @hide
38  */
39 public class StatusBarManager {
40 
41     public static final int DISABLE_EXPAND = View.STATUS_BAR_DISABLE_EXPAND;
42     public static final int DISABLE_NOTIFICATION_ICONS = View.STATUS_BAR_DISABLE_NOTIFICATION_ICONS;
43     public static final int DISABLE_NOTIFICATION_ALERTS
44             = View.STATUS_BAR_DISABLE_NOTIFICATION_ALERTS;
45     @Deprecated
46     public static final int DISABLE_NOTIFICATION_TICKER
47             = View.STATUS_BAR_DISABLE_NOTIFICATION_TICKER;
48     public static final int DISABLE_SYSTEM_INFO = View.STATUS_BAR_DISABLE_SYSTEM_INFO;
49     public static final int DISABLE_HOME = View.STATUS_BAR_DISABLE_HOME;
50     public static final int DISABLE_RECENT = View.STATUS_BAR_DISABLE_RECENT;
51     public static final int DISABLE_BACK = View.STATUS_BAR_DISABLE_BACK;
52     public static final int DISABLE_CLOCK = View.STATUS_BAR_DISABLE_CLOCK;
53     public static final int DISABLE_SEARCH = View.STATUS_BAR_DISABLE_SEARCH;
54 
55     @Deprecated
56     public static final int DISABLE_NAVIGATION =
57             View.STATUS_BAR_DISABLE_HOME | View.STATUS_BAR_DISABLE_RECENT;
58 
59     public static final int DISABLE_NONE = 0x00000000;
60 
61     public static final int DISABLE_MASK = DISABLE_EXPAND | DISABLE_NOTIFICATION_ICONS
62             | DISABLE_NOTIFICATION_ALERTS | DISABLE_NOTIFICATION_TICKER
63             | DISABLE_SYSTEM_INFO | DISABLE_RECENT | DISABLE_HOME | DISABLE_BACK | DISABLE_CLOCK
64             | DISABLE_SEARCH;
65 
66     /**
67      * Flag to disable quick settings.
68      *
69      * Setting this flag disables quick settings completely, but does not disable expanding the
70      * notification shade.
71      */
72     public static final int DISABLE2_QUICK_SETTINGS = 0x00000001;
73 
74     public static final int DISABLE2_NONE = 0x00000000;
75 
76     public static final int DISABLE2_MASK = DISABLE2_QUICK_SETTINGS;
77 
78     @IntDef(flag = true,
79             value = {DISABLE2_NONE, DISABLE2_MASK, DISABLE2_QUICK_SETTINGS})
80     @Retention(RetentionPolicy.SOURCE)
81     public @interface Disable2Flags {}
82 
83     public static final int NAVIGATION_HINT_BACK_ALT      = 1 << 0;
84     public static final int NAVIGATION_HINT_IME_SHOWN     = 1 << 1;
85 
86     public static final int WINDOW_STATUS_BAR = 1;
87     public static final int WINDOW_NAVIGATION_BAR = 2;
88 
89     public static final int WINDOW_STATE_SHOWING = 0;
90     public static final int WINDOW_STATE_HIDING = 1;
91     public static final int WINDOW_STATE_HIDDEN = 2;
92 
93     public static final int CAMERA_LAUNCH_SOURCE_WIGGLE = 0;
94     public static final int CAMERA_LAUNCH_SOURCE_POWER_DOUBLE_TAP = 1;
95 
96     private Context mContext;
97     private IStatusBarService mService;
98     private IBinder mToken = new Binder();
99 
StatusBarManager(Context context)100     StatusBarManager(Context context) {
101         mContext = context;
102     }
103 
getService()104     private synchronized IStatusBarService getService() {
105         if (mService == null) {
106             mService = IStatusBarService.Stub.asInterface(
107                     ServiceManager.getService(Context.STATUS_BAR_SERVICE));
108             if (mService == null) {
109                 Slog.w("StatusBarManager", "warning: no STATUS_BAR_SERVICE");
110             }
111         }
112         return mService;
113     }
114 
115     /**
116      * Disable some features in the status bar.  Pass the bitwise-or of the DISABLE_* flags.
117      * To re-enable everything, pass {@link #DISABLE_NONE}.
118      */
disable(int what)119     public void disable(int what) {
120         try {
121             final IStatusBarService svc = getService();
122             if (svc != null) {
123                 svc.disable(what, mToken, mContext.getPackageName());
124             }
125         } catch (RemoteException ex) {
126             throw ex.rethrowFromSystemServer();
127         }
128     }
129 
130     /**
131      * Disable additional status bar features. Pass the bitwise-or of the DISABLE2_* flags.
132      * To re-enable everything, pass {@link #DISABLE_NONE}.
133      *
134      * Warning: Only pass DISABLE2_* flags into this function, do not use DISABLE_* flags.
135      */
disable2(@isable2Flags int what)136     public void disable2(@Disable2Flags int what) {
137         try {
138             final IStatusBarService svc = getService();
139             if (svc != null) {
140                 svc.disable2(what, mToken, mContext.getPackageName());
141             }
142         } catch (RemoteException ex) {
143             throw ex.rethrowFromSystemServer();
144         }
145     }
146 
147     /**
148      * Expand the notifications panel.
149      */
expandNotificationsPanel()150     public void expandNotificationsPanel() {
151         try {
152             final IStatusBarService svc = getService();
153             if (svc != null) {
154                 svc.expandNotificationsPanel();
155             }
156         } catch (RemoteException ex) {
157             throw ex.rethrowFromSystemServer();
158         }
159     }
160 
161     /**
162      * Collapse the notifications and settings panels.
163      */
collapsePanels()164     public void collapsePanels() {
165         try {
166             final IStatusBarService svc = getService();
167             if (svc != null) {
168                 svc.collapsePanels();
169             }
170         } catch (RemoteException ex) {
171             throw ex.rethrowFromSystemServer();
172         }
173     }
174 
175     /**
176      * Expand the settings panel.
177      */
expandSettingsPanel()178     public void expandSettingsPanel() {
179         expandSettingsPanel(null);
180     }
181 
182     /**
183      * Expand the settings panel and open a subPanel, pass null to just open the settings panel.
184      */
expandSettingsPanel(String subPanel)185     public void expandSettingsPanel(String subPanel) {
186         try {
187             final IStatusBarService svc = getService();
188             if (svc != null) {
189                 svc.expandSettingsPanel(subPanel);
190             }
191         } catch (RemoteException ex) {
192             throw ex.rethrowFromSystemServer();
193         }
194     }
195 
setIcon(String slot, int iconId, int iconLevel, String contentDescription)196     public void setIcon(String slot, int iconId, int iconLevel, String contentDescription) {
197         try {
198             final IStatusBarService svc = getService();
199             if (svc != null) {
200                 svc.setIcon(slot, mContext.getPackageName(), iconId, iconLevel,
201                     contentDescription);
202             }
203         } catch (RemoteException ex) {
204             throw ex.rethrowFromSystemServer();
205         }
206     }
207 
removeIcon(String slot)208     public void removeIcon(String slot) {
209         try {
210             final IStatusBarService svc = getService();
211             if (svc != null) {
212                 svc.removeIcon(slot);
213             }
214         } catch (RemoteException ex) {
215             throw ex.rethrowFromSystemServer();
216         }
217     }
218 
setIconVisibility(String slot, boolean visible)219     public void setIconVisibility(String slot, boolean visible) {
220         try {
221             final IStatusBarService svc = getService();
222             if (svc != null) {
223                 svc.setIconVisibility(slot, visible);
224             }
225         } catch (RemoteException ex) {
226             throw ex.rethrowFromSystemServer();
227         }
228     }
229 
230     /** @hide */
windowStateToString(int state)231     public static String windowStateToString(int state) {
232         if (state == WINDOW_STATE_HIDING) return "WINDOW_STATE_HIDING";
233         if (state == WINDOW_STATE_HIDDEN) return "WINDOW_STATE_HIDDEN";
234         if (state == WINDOW_STATE_SHOWING) return "WINDOW_STATE_SHOWING";
235         return "WINDOW_STATE_UNKNOWN";
236     }
237 }
238