VideoView: expand documentation on state save/restore limitations

Change-Id: I46f231d314fc4ae8d9d11389aa62a3e2698122ed
Signed-off-by: Lajos Molnar <lajos@google.com>
Bug: 11412889
This commit is contained in:
Lajos Molnar
2013-10-30 14:04:10 -07:00
parent 594eeb082e
commit 7e11b16b9f

View File

@@ -56,7 +56,17 @@ import java.util.Vector;
* can load images from various sources (such as resources or content
* providers), takes care of computing its measurement from the video so that
* it can be used in any layout manager, and provides various display options
* such as scaling and tinting.
* such as scaling and tinting.<p>
*
* <em>Note: VideoView does not retain its full state when going into the
* background.</em> In particular, it does not restore the current play state,
* play position, selected tracks, or any subtitle tracks added via
* {@link #addSubtitleSource addSubtitleSource()}. Applications should
* save and restore these on their own in
* {@link android.app.Activity#onSaveInstanceState} and
* {@link android.app.Activity#onRestoreInstanceState}.<p>
* Also note that the audio session id (from {@link #getAudioSessionId}) may
* change from its previously returned value when the VideoView is restored.
*/
public class VideoView extends SurfaceView
implements MediaPlayerControl, SubtitleController.Anchor {