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