java.lang.Object | |
↳ | android.app.UiModeManager |
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)
.
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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
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. | ||||||||||
ACTION_ENTER_DESK_MODE | Broadcast sent when the device's UI has switched to desk mode, by being placed in a desk dock. | ||||||||||
ACTION_EXIT_CAR_MODE | Broadcast sent when the device's UI has switch away from car mode back to normal mode. | ||||||||||
ACTION_EXIT_DESK_MODE | Broadcast sent when the device's UI has switched away from desk mode back to normal mode. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Turn off special mode if currently in car mode.
| |||||||||||
Force device into car mode, like it had been placed in the car dock.
| |||||||||||
Return the current running mode type.
| |||||||||||
Returns the currently configured night mode.
| |||||||||||
Sets the night mode.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
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).
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 for setNightMode(int)
and getNightMode()
:
automatically switch night mode on and off based on the time.
Constant for setNightMode(int)
and getNightMode()
:
never run in night mode.
Constant for setNightMode(int)
and getNightMode()
:
always run in night 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. 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
.
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
.
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.
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.
Turn off special mode if currently in car mode.
flags | May be 0 or DISABLE_CAR_MODE_GO_HOME .
|
---|
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.
flags | Must be 0. |
---|
Return the current running mode type. May be one of
Configuration.UI_MODE_TYPE_NORMAL
,
Configuration.UI_MODE_TYPE_DESK
,
Configuration.UI_MODE_TYPE_CAR
,
Configuration.UI_MODE_TYPE_TELEVISION
,
Configuration.UI_MODE_TYPE_APPLIANCE
, or
Configuration.UI_MODE_TYPE_WATCH
.
Returns the currently configured night mode.
MODE_NIGHT_NO
, MODE_NIGHT_YES
, or
MODE_NIGHT_AUTO
. When an error occurred -1 is returned.
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:
MODE_NIGHT_NO
- sets the device into notnight
mode.MODE_NIGHT_YES
- sets the device into night mode.
MODE_NIGHT_AUTO
- automatic night/notnight switching
depending on the location and certain other sensors.