From 6c9a1a1004f224e771139aec6fd2058aa6bdccbd Mon Sep 17 00:00:00 2001 From: Scott Main Date: Mon, 19 Nov 2012 11:58:59 -0800 Subject: docs: update dreamservice description Change-Id: I7e7295a3d67ca1760ba52b3958bf91540692e542 --- core/java/android/service/dreams/DreamService.java | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) (limited to 'core/java/android/service') diff --git a/core/java/android/service/dreams/DreamService.java b/core/java/android/service/dreams/DreamService.java index 6c9290b..f6b6c89 100644 --- a/core/java/android/service/dreams/DreamService.java +++ b/core/java/android/service/dreams/DreamService.java @@ -44,13 +44,13 @@ import android.view.accessibility.AccessibilityEvent; import com.android.internal.policy.PolicyManager; /** - * Extend this class to implement a custom Dream (displayed to the user as a "Sleep Mode"). + * Extend this class to implement a custom dream (available to the user as a "Daydream"). * *

Dreams are interactive screensavers launched when a charging device is idle, or docked in a * desk dock. Dreams provide another modality for apps to express themselves, tailored for * an exhibition/lean-back experience.

* - *

The Dream lifecycle is as follows:

+ *

The {@code DreamService} lifecycle is as follows:

*
    *
  1. {@link #onAttachedToWindow} *

    Use this for initial setup, such as calling {@link #setContentView setContentView()}.

  2. @@ -59,14 +59,15 @@ import com.android.internal.policy.PolicyManager; *
  3. {@link #onDreamingStopped} *

    Use this to stop the things you started in {@link #onDreamingStarted}.

  4. *
  5. {@link #onDetachedFromWindow} - *

    Use this to dismantle resources your dream set up. For example, detach from handlers - * and listeners.

  6. + *

    Use this to dismantle resources (for example, detach from handlers + * and listeners). *

* *

In addition, onCreate and onDestroy (from the Service interface) will also be called, but * initialization and teardown should be done by overriding the hooks above.

* - *

To be available to the system, Dreams should be declared in the manifest as follows:

+ *

To be available to the system, your {@code DreamService} should be declared in the + * manifest as follows:

*
  * <service
  *     android:name=".MyDream"
-- 
cgit v1.1