to top
Android APIs
public class

UiModeManager

extends Object
java.lang.Object
   ↳ android.app.UiModeManager

Class Overview

This class provides access to the system uimode services. These services allow applications to control UI modes of the device. It provides functionality to disable the car mode and it gives access to the night mode settings.

These facilities are built on top of the underlying ACTION_DOCK_EVENT broadcasts that are sent when the user physical places the device into and out of a dock. When that happens, the UiModeManager switches the system Configuration to the appropriate UI mode, sends broadcasts about the mode switch, and starts the corresponding mode activity if appropriate. See the broadcasts ACTION_ENTER_CAR_MODE and ACTION_ENTER_DESK_MODE for more information.

In addition, the user may manually switch the system to car mode without physically being in a dock. While in car mode -- whether by manual action from the user or being physically placed in a dock -- a notification is displayed allowing the user to exit dock mode. Thus the dock mode represented here may be different than the current state of the underlying dock event broadcast.

You do not instantiate this class directly; instead, retrieve it through Context.getSystemService(Context.UI_MODE_SERVICE).

Summary

Constants
int DISABLE_CAR_MODE_GO_HOME Flag for use with disableCarMode(int): go to the normal home activity as part of the disable.
int ENABLE_CAR_MODE_GO_CAR_HOME Flag for use with enableCarMode(int): go to the car home activity as part of the enable.
int MODE_NIGHT_AUTO Constant for setNightMode(int) and getNightMode(): automatically switch night mode on and off based on the time.
int MODE_NIGHT_NO Constant for setNightMode(int) and getNightMode(): never run in night mode.
int MODE_NIGHT_YES Constant for setNightMode(int) and getNightMode(): always run in night mode.
Fields
public static String ACTION_ENTER_CAR_MODE Broadcast sent when the device's UI has switched to car mode, either by being placed in a car dock or explicit action of the user.
public static String ACTION_ENTER_DESK_MODE Broadcast sent when the device's UI has switched to desk mode, by being placed in a desk dock.
public static String ACTION_EXIT_CAR_MODE Broadcast sent when the device's UI has switch away from car mode back to normal mode.
public static String ACTION_EXIT_DESK_MODE Broadcast sent when the device's UI has switched away from desk mode back to normal mode.
Public Methods
void disableCarMode(int flags)
Turn off special mode if currently in car mode.
void enableCarMode(int flags)
Force device into car mode, like it had been placed in the car dock.
int getCurrentModeType()
Return the current running mode type.
int getNightMode()
Returns the currently configured night mode.
void setNightMode(int mode)
Sets the night mode.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int DISABLE_CAR_MODE_GO_HOME

Since: API Level 8

Flag for use with disableCarMode(int): go to the normal home activity as part of the disable. Disabling this way ensures a clean transition between the current activity (in car mode) and the original home activity (which was typically last running without being in car mode).

Constant Value: 1 (0x00000001)

public static final int ENABLE_CAR_MODE_GO_CAR_HOME

Since: API Level 8

Flag for use with enableCarMode(int): go to the car home activity as part of the enable. Enabling this way ensures a clean transition between the current activity (in non-car-mode) and the car home activity that will serve as home while in car mode. This will switch to the car home activity even if we are already in car mode.

Constant Value: 1 (0x00000001)

public static final int MODE_NIGHT_AUTO

Since: API Level 8

Constant for setNightMode(int) and getNightMode(): automatically switch night mode on and off based on the time.

Constant Value: 0 (0x00000000)

public static final int MODE_NIGHT_NO

Since: API Level 8

Constant for setNightMode(int) and getNightMode(): never run in night mode.

Constant Value: 1 (0x00000001)

public static final int MODE_NIGHT_YES

Since: API Level 8

Constant for setNightMode(int) and getNightMode(): always run in night mode.

Constant Value: 2 (0x00000002)

Fields

public static String ACTION_ENTER_CAR_MODE

Since: API Level 8

Broadcast sent when the device's UI has switched to car mode, either by being placed in a car dock or explicit action of the user. After sending the broadcast, the system will start the intent ACTION_MAIN with category CATEGORY_CAR_DOCK to display the car UI, which typically what an application would implement to provide their own interface. However, applications can also monitor this Intent in order to be informed of mode changes or prevent the normal car UI from being displayed by setting the result of the broadcast to RESULT_CANCELED.

public static String ACTION_ENTER_DESK_MODE

Since: API Level 8

Broadcast sent when the device's UI has switched to desk mode, by being placed in a desk dock. After sending the broadcast, the system will start the intent ACTION_MAIN with category CATEGORY_DESK_DOCK to display the desk UI, which typically what an application would implement to provide their own interface. However, applications can also monitor this Intent in order to be informed of mode changes or prevent the normal desk UI from being displayed by setting the result of the broadcast to RESULT_CANCELED.

public static String ACTION_EXIT_CAR_MODE

Since: API Level 8

Broadcast sent when the device's UI has switch away from car mode back to normal mode. Typically used by a car mode app, to dismiss itself when the user exits car mode.

public static String ACTION_EXIT_DESK_MODE

Since: API Level 8

Broadcast sent when the device's UI has switched away from desk mode back to normal mode. Typically used by a desk mode app, to dismiss itself when the user exits desk mode.

Public Methods

public void disableCarMode (int flags)

Since: API Level 8

Turn off special mode if currently in car mode.

Parameters
flags May be 0 or DISABLE_CAR_MODE_GO_HOME.

public void enableCarMode (int flags)

Since: API Level 8

Force device into car mode, like it had been placed in the car dock. This will cause the device to switch to the car home UI as part of the mode switch.

Parameters
flags Must be 0.

public int getCurrentModeType ()

Since: API Level 8

public int getNightMode ()

Since: API Level 8

Returns the currently configured night mode.

Returns

public void setNightMode (int mode)

Since: API Level 8

Sets the night mode. Changes to the night mode are only effective when the car or desk mode is enabled on a device.

The mode can be one of: