From ea5f767246ad201a9e2bba0d657404e002cd7c70 Mon Sep 17 00:00:00 2001 From: Jean-Baptiste Queru Date: Wed, 16 Sep 2009 15:06:25 -0700 Subject: [PATCH] Update documentation for getVideoWidth and getVideoHeight. Ref: http://code.google.com/p/android/issues/detail?id=3024 --- media/java/android/media/MediaPlayer.java | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/media/java/android/media/MediaPlayer.java b/media/java/android/media/MediaPlayer.java index fe768be6fb442..e94137e7bb679 100644 --- a/media/java/android/media/MediaPlayer.java +++ b/media/java/android/media/MediaPlayer.java @@ -794,8 +794,10 @@ public class MediaPlayer * Returns the width of the video. * * @return the width of the video, or 0 if there is no video, - * no display surface was set, or prepare()/prepareAsync() - * have not completed yet + * no display surface was set, or the width has not been determined + * yet. The OnVideoSizeChangedListener can be registered via + * {@link #setOnVideoSizeChangedListener(OnVideoSizeChangedListener)} + * to provide a notification when the width is available. */ public native int getVideoWidth(); @@ -803,8 +805,10 @@ public class MediaPlayer * Returns the height of the video. * * @return the height of the video, or 0 if there is no video, - * no display surface was set, or prepare()/prepareAsync() - * have not completed yet + * no display surface was set, or the height has not been determined + * yet. The OnVideoSizeChangedListener can be registered via + * {@link #setOnVideoSizeChangedListener(OnVideoSizeChangedListener)} + * to provide a notification when the height is available. */ public native int getVideoHeight();