am 7e11b16b: VideoView: expand documentation on state save/restore limitations

* commit '7e11b16b9f8896170d492240a5fd50c8bd04105d':
  VideoView: expand documentation on state save/restore limitations
This commit is contained in:
Lajos Molnar
2013-11-13 16:40:26 -08:00
committed by Android Git Automerger

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 {