Called when an activity is entering ambient mode. This event is sent while an activity is
running (after onResume, before onPause). All drawing should complete by the conclusion
of this method. Note that invalidate() calls will be executed before resuming
lower-power mode.
Parameters
ambientDetails
Bundle: bundle containing information about the display being used.
It includes information about low-bit color and burn-in protection.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# AmbientModeSupport.AmbientCallback\n\nadded in [version 27.1.0](/topic/libraries/support-library/revisions) \nbelongs to Maven artifact com.android.support:wear:28.0.0-alpha1 \nSummary: [Ctors](#pubctors) \\| [Methods](#pubmethods) \\| [Inherited Methods](#inhmethods) \\| [\\[Expand All\\]](#) \n\nAmbientModeSupport.AmbientCallback\n==================================\n\n| This package is part of the Android [support library](/topic/libraries/support-library) which is no longer maintained. The support library has been superseded by [AndroidX](/jetpack/androidx) which is part of [Jetpack](/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider [migrating](/jetpack/androidx/migrate) existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library [class\n| mappings](/jetpack/androidx/migrate/class-mappings).\n\n\n`\npublic\nstatic\n\nabstract\nclass\nAmbientModeSupport.AmbientCallback\n`\n\n\n`\n\nextends Object\n\n\n`\n\n`\n\n\n`\n\n|---|-----------------------------------------------------------------|\n| java.lang.Object ||\n| ↳ | android.support.wear.ambient.AmbientModeSupport.AmbientCallback |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nCallback to receive ambient mode state changes. It must be used by all users of AmbientMode.\n\nSummary\n-------\n\n| ### Public constructors ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ` `[AmbientModeSupport.AmbientCallback](/reference/android/support/wear/ambient/AmbientModeSupport.AmbientCallback#AmbientModeSupport.AmbientCallback())`() ` |\n\n| ### Public methods ||\n|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` void` | ` `[onEnterAmbient](/reference/android/support/wear/ambient/AmbientModeSupport.AmbientCallback#onEnterAmbient(android.os.Bundle))`(`[Bundle](https://developer.android.com/reference/android/os/Bundle.html)` ambientDetails) ` Called when an activity is entering ambient mode. |\n| ` void` | ` `[onExitAmbient](/reference/android/support/wear/ambient/AmbientModeSupport.AmbientCallback#onExitAmbient())`() ` Called when an activity should exit ambient mode. |\n| ` void` | ` `[onUpdateAmbient](/reference/android/support/wear/ambient/AmbientModeSupport.AmbientCallback#onUpdateAmbient())`() ` Called when the system is updating the display for ambient mode. |\n\n| ### Inherited methods |\n|-----------------------|---|\n| From class ` java.lang.Object ` |-------------------|-------------------------------| | ` Object` | ` clone() ` | | ` boolean` | ` equals(Object arg0) ` | | ` void` | ` finalize() ` | | ` final Class\u003c?\u003e` | ` getClass() ` | | ` int` | ` hashCode() ` | | ` final void` | ` notify() ` | | ` final void` | ` notifyAll() ` | | ` String` | ` toString() ` | | ` final void` | ` wait(long arg0, int arg1) ` | | ` final void` | ` wait(long arg0) ` | | ` final void` | ` wait() ` | ||\n\nPublic constructors\n-------------------\n\n### AmbientModeSupport.AmbientCallback\n\nadded in [version 27.1.0](/topic/libraries/support-library/revisions) \n\n```\nAmbientModeSupport.AmbientCallback ()\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nPublic methods\n--------------\n\n### onEnterAmbient\n\nadded in [version 27.1.0](/topic/libraries/support-library/revisions) \n\n```\nvoid onEnterAmbient (Bundle ambientDetails)\n```\n\nCalled when an activity is entering ambient mode. This event is sent while an activity is\nrunning (after onResume, before onPause). All drawing should complete by the conclusion\nof this method. Note that `invalidate()` calls will be executed before resuming\nlower-power mode.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ambientDetails` | `Bundle`: bundle containing information about the display being used. It includes information about low-bit color and burn-in protection. \u003cbr /\u003e |\n\n### onExitAmbient\n\nadded in [version 27.1.0](/topic/libraries/support-library/revisions) \n\n```\nvoid onExitAmbient ()\n```\n\nCalled when an activity should exit ambient mode. This event is sent while an activity is\nrunning (after onResume, before onPause).\n\n\u003cbr /\u003e\n\n### onUpdateAmbient\n\nadded in [version 27.1.0](/topic/libraries/support-library/revisions) \n\n```\nvoid onUpdateAmbient ()\n```\n\nCalled when the system is updating the display for ambient mode. Activities may use this\nopportunity to update or invalidate views.\n\n\u003cbr /\u003e\n\n-\n\n Interfaces\n ----------\n\n - [AmbientMode.AmbientCallbackProvider](/reference/android/support/wear/ambient/AmbientMode.AmbientCallbackProvider)\n - [AmbientModeSupport.AmbientCallbackProvider](/reference/android/support/wear/ambient/AmbientModeSupport.AmbientCallbackProvider)\n-\n\n Classes\n -------\n\n - [AmbientMode](/reference/android/support/wear/ambient/AmbientMode)\n - [AmbientMode.AmbientCallback](/reference/android/support/wear/ambient/AmbientMode.AmbientCallback)\n - [AmbientMode.AmbientController](/reference/android/support/wear/ambient/AmbientMode.AmbientController)\n - [AmbientModeSupport](/reference/android/support/wear/ambient/AmbientModeSupport)\n - [AmbientModeSupport.AmbientCallback](/reference/android/support/wear/ambient/AmbientModeSupport.AmbientCallback)\n - [AmbientModeSupport.AmbientController](/reference/android/support/wear/ambient/AmbientModeSupport.AmbientController)"]]
From
class