Update MediaPlayer and MediaRecorder javadoc (9ddb7888) · Commits · e / os / android_frameworks_base

media/java/android/media/MediaPlayer.java

+21 −0

Original line number	Diff line number	Diff line
		@@ -52,6 +52,7 @@ import java.lang.ref.WeakReference;
		* <li><a href="#StateDiagram">State Diagram</a>
		* <li><a href="#Valid_and_Invalid_States">Valid and Invalid States</a>
		* <li><a href="#Permissions">Permissions</a>
		* <li><a href="#Callbacks">Register informational and error callbacks</a>
		* </ol>
		*
		* <a name="StateDiagram"></a>
		@@ -459,6 +460,26 @@ import java.lang.ref.WeakReference;
		* android.R.styleable#AndroidManifestUsesPermission <uses-permission>}
		* element.
		*
		* <a name="Callbacks"></a>
		* <h3>Callbacks</h3>
		* <p>Applications may want to register for informational and error
		* events in order to be informed of some internal state update and
		* possible runtime errors during playback or streaming. Registration for
		* these events is done by properly setting the appropriate listeners (via calls
		* to
		* {@link #setOnPreparedListener(OnPreparedListener)}setOnPreparedListener,
		* {@link #setOnVideoSizeChangedListener(OnVideoSizeChangedListener)}setOnVideoSizeChangedListener,
		* {@link #setOnSeekCompleteListener(OnSeekCompleteListener)}setOnSeekCompleteListener,
		* {@link #setOnCompletionListener(OnCompletionListener)}setOnCompletionListener,
		* {@link #setOnBufferingUpdateListener(OnBufferingUpdateListener)setOnBufferingUpdateListener,
		* {@link #setOnTimedTextListener(OnTimedTextListener)}setOnTimedTextListener,
		* {@link #setOnInfoListener(OnInfoListener)}setOnInfoListener,
		* {@link #setOnErrorListener(OnErrorListener)}setOnErrorListener, etc).
		* In order to receive the respective callback
		* associated with these listeners, applications are required to create
		* MediaPlayer objects on a thread with its own Looper running (main UI
		* thread by default has a Looper running).
		*
		*/
		public class MediaPlayer
		{

media/java/android/media/MediaRecorder.java

+10 −0

Original line number	Diff line number	Diff line
		@@ -51,6 +51,16 @@ import java.lang.ref.WeakReference;
		* recorder.release(); // Now the object cannot be reused
		* </pre>
		*
		* <p>Applications may want to register for informational and error
		* events in order to be informed of some internal update and possible
		* runtime errors during recording. Registration for such events is
		* done by setting the appropriate listeners (via calls
		* (to {@link #setOnInfoListener(OnInfoListener)}setOnInfoListener and/or
		* {@link #setOnErrorListener(OnErrorListener)}setOnErrorListener).
		* In order to receive the respective callback associated with these listeners,
		* applications are required to create MediaRecorder objects on threads with a
		* Looper running (the main UI thread by default already has a Looper running).
		*
		* <p>See the <a href="{@docRoot}guide/topics/media/index.html">Audio and Video</a>
		* documentation for additional help with using MediaRecorder.
		* <p>Note: Currently, MediaRecorder does not work on the emulator.