diff --git a/graphics/java/android/graphics/drawable/AnimationDrawable.java b/graphics/java/android/graphics/drawable/AnimationDrawable.java index 07de074d48a2b..35343be8b5358 100644 --- a/graphics/java/android/graphics/drawable/AnimationDrawable.java +++ b/graphics/java/android/graphics/drawable/AnimationDrawable.java @@ -102,7 +102,12 @@ public class AnimationDrawable extends DrawableContainer implements Runnable, An /** *

Starts the animation, looping if necessary. This method has no effect - * if the animation is running.

+ * if the animation is running. Do not call this in the {@link android.app.Activity#onCreate} + * method of your activity, because the {@link android.graphics.drawable.AnimationDrawable} is + * not yet fully attached to the window. If you want to play + * the animation immediately, without requiring interaction, then you might want to call it + * from the {@link android.app.Activity#onWindowFocusChanged} method in your activity, + * which will get called when Android brings your window into focus.

* * @see #isRunning() * @see #stop()