diff options
| -rw-r--r-- | media/java/android/media/AudioManager.java | 2 | ||||
| -rw-r--r-- | media/java/android/media/AudioRecordingConfiguration.java | 16 |
2 files changed, 15 insertions, 3 deletions
diff --git a/media/java/android/media/AudioManager.java b/media/java/android/media/AudioManager.java index 4bdc70e37621..f19a2624457e 100644 --- a/media/java/android/media/AudioManager.java +++ b/media/java/android/media/AudioManager.java @@ -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(); diff --git a/media/java/android/media/AudioRecordingConfiguration.java b/media/java/android/media/AudioRecordingConfiguration.java index 593516639e29..354339c545a4 100644 --- a/media/java/android/media/AudioRecordingConfiguration.java +++ b/media/java/android/media/AudioRecordingConfiguration.java @@ -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 { @@ -198,4 +208,4 @@ public final class AudioRecordingConfiguration implements Parcelable { && (mClientFormat.equals(that.mClientFormat)) && (mDeviceFormat.equals(that.mDeviceFormat))); } -}
\ No newline at end of file +} |