summaryrefslogtreecommitdiffstats
path: root/media/java/android
diff options
context:
space:
mode:
authorJames Dong <jdong@google.com>2011-05-26 12:52:00 -0700
committerJames Dong <jdong@google.com>2011-05-26 17:45:00 -0700
commit22bf7a7ea768c2cdadc5faf643aba70aebafc0d5 (patch)
tree08840a6daeddc27d4eb6ff6756ef1a6b9908986f /media/java/android
parentf9187df698680d8ecda09511e0028daaaf71deb8 (diff)
downloadframeworks_base-22bf7a7ea768c2cdadc5faf643aba70aebafc0d5.zip
frameworks_base-22bf7a7ea768c2cdadc5faf643aba70aebafc0d5.tar.gz
frameworks_base-22bf7a7ea768c2cdadc5faf643aba70aebafc0d5.tar.bz2
Add some comment to MediaRecorder.stop() about the stop() failure (-1007)
o The intended failure happens if stop() call comes immediately after start() call before any media data from the output of the encoder is received. Change-Id: I62fad123ac67e2f566ba555e84c0c3faf2adfd99
Diffstat (limited to 'media/java/android')
-rw-r--r--media/java/android/media/MediaRecorder.java6
1 files changed, 6 insertions, 0 deletions
diff --git a/media/java/android/media/MediaRecorder.java b/media/java/android/media/MediaRecorder.java
index 38202f2..1478a6d 100644
--- a/media/java/android/media/MediaRecorder.java
+++ b/media/java/android/media/MediaRecorder.java
@@ -716,6 +716,12 @@ public class MediaRecorder
/**
* Stops recording. Call this after start(). Once recording is stopped,
* you will have to configure it again as if it has just been constructed.
+ * Note that a RuntimeException is intentionally thrown to the
+ * application, if no valid audio/video data has been received when stop()
+ * is called. This happens if stop() is called immediately after
+ * start(). The failure lets the application take action accordingly to
+ * clean up the output file (delete the output file, for instance), since
+ * the output file is not properly constructed when this happens.
*
* @throws IllegalStateException if it is called before start()
*/