Home | History | Annotate | Download | only in app 
      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 
    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