Merge "Unhide camera recording hint API." (08a90714) · Commits · e / os / android_frameworks_base

api/current.txt

+1 −0

Original line number	Diff line number	Diff line
		@@ -9225,6 +9225,7 @@ package android.hardware {
		method public void setPreviewFpsRange(int, int);
		method public deprecated void setPreviewFrameRate(int);
		method public void setPreviewSize(int, int);
		method public void setRecordingHint(boolean);
		method public void setRotation(int);
		method public void setSceneMode(java.lang.String);
		method public void setWhiteBalance(java.lang.String);

core/java/android/hardware/Camera.java

+15 −24

Original line number	Diff line number	Diff line
		@@ -3179,36 +3179,27 @@ public class Camera {
		}

		/**
		* Sets the hint of the recording mode. If this is true, {@link
		* android.media.MediaRecorder#start()} may be faster or has less
		* glitches. This should be called before starting the preview for the
		* best result. But it is allowed to change the hint while the preview
		* is active. The default value is false.
		*
		* The apps can still call {@link #takePicture(Camera.ShutterCallback,
		* Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback)}
		* when the hint is true. The apps can call MediaRecorder.start() when
		* the hint is false. But the performance may be worse.
		*
		* @param hint true if the apps intend to record a video using
		* Sets recording mode hint. This tells the camera that the intent of
		* the application is to record videos {@link
		* android.media.MediaRecorder#start()}, not to take still pictures
		* {@link #takePicture(Camera.ShutterCallback, Camera.PictureCallback,
		* Camera.PictureCallback, Camera.PictureCallback)}. Using this hint can
		* allow MediaRecorder.start() to start faster or with fewer glitches on
		* output. This should be called before starting preview for the best
		* result, but can be changed while the preview is active. The default
		* value is false.
		*
		* The app can still call takePicture() when the hint is true or call
		* MediaRecorder.start() when the hint is false. But the performance may
		* be worse.
		*
		* @param hint true if the apps intend to record videos using
		* {@link android.media.MediaRecorder}.
		* @hide
		*/
		public void setRecordingHint(boolean hint) {
		set(KEY_RECORDING_HINT, hint ? TRUE : FALSE);
		}

		/**
		* Gets the current recording hint.
		*
		* @return the current recording hint state.
		* @see #setRecordingHint(boolean)
		* @hide
		*/
		public boolean getRecordingHint() {
		return TRUE.equals(get(KEY_RECORDING_HINT));
		}

		// Splits a comma delimited string to an ArrayList of String.
		// Return null if the passing string is null or the size is 0.
		private ArrayList<String> split(String str) {