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
18package android.app;
19
20import android.annotation.IntDef;
21import android.content.Context;
22import android.os.Binder;
23import android.os.RemoteException;
24import android.os.IBinder;
25import android.os.ServiceManager;
26import android.util.Slog;
27import android.view.View;
28
29import com.android.internal.statusbar.IStatusBarService;
30
31import java.lang.annotation.Retention;
32import java.lang.annotation.RetentionPolicy;
33
34/**
35 * Allows an app to control the status bar.
36 *
37 * @hide
38 */
39public 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
100    StatusBarManager(Context context) {
101        mContext = context;
102    }
103
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     */
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     */
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     */
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     */
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     */
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     */
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
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
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
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 */
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