Merge "More javadoc for audio recording activity API" into nyc-dev (8d5fd923) · Commits · e / os / android_frameworks_base

media/java/android/media/AudioManager.java

+2 −0

Original line number	Diff line number	Diff line
		@@ -2744,6 +2744,7 @@ public class AudioManager {
		* to be notified.
		* Use {@link AudioManager#getActiveRecordingConfigurations()} to query the current
		* configuration.
		* @see AudioRecordingConfiguration
		*/
		public static abstract class AudioRecordingCallback {
		/**
		@@ -2850,6 +2851,7 @@ public class AudioManager {
		* Returns the current active audio recording configurations of the device.
		* @return a non-null list of recording configurations. An empty list indicates there is
		* no recording active when queried.
		* @see AudioRecordingConfiguration
		*/
		public @NonNull List<AudioRecordingConfiguration> getActiveRecordingConfigurations() {
		final IAudioService service = getService();

+13 −3

Original line number	Diff line number	Diff line
		@@ -28,8 +28,18 @@ import java.util.Objects;

		/**
		* The AudioRecordingConfiguration class collects the information describing an audio recording
		* session. This information is returned through the
		* {@link AudioManager#getActiveRecordingConfigurations()} method.
		* session.
		* <p>Direct polling (see {@link AudioManager#getActiveRecordingConfigurations()}) or callback
		* (see {@link AudioManager#registerAudioRecordingCallback(android.media.AudioManager.AudioRecordingCallback, android.os.Handler)}
		* methods are ways to receive information about the current recording configuration of the device.
		* <p>An audio recording configuration contains information about the recording format as used by
		* the application ({@link #getClientFormat()}, as well as the recording format actually used by
		* the device ({@link #getFormat()}). The two recording formats may, for instance, be at different
		* sampling rates due to hardware limitations (e.g. application recording at 44.1kHz whereas the
		* device always records at 48kHz, and the Android framework resamples for the application).
		* <p>The configuration also contains the use case for which audio is recorded
		* ({@link #getClientAudioSource()}), enabling the ability to distinguish between different
		* activities such as ongoing voice recognition or camcorder recording.
		*
		*/
		public final class AudioRecordingConfiguration implements Parcelable {