From 62796aac596f556a1871358bb8ce93af9d55c5a5 Mon Sep 17 00:00:00 2001 From: Glenn Kasten Date: Thu, 20 Sep 2012 08:08:07 -0700 Subject: [PATCH] Expose android.media.AudioManager.getProperty() Also fix minor documentation errors. Bug: 6635041 Change-Id: I6bbbf1b7c5ab705ac374436ea0c098cb3c27fd4a --- api/current.txt | 3 +++ media/java/android/media/AudioManager.java | 17 ++++++++--------- 2 files changed, 11 insertions(+), 9 deletions(-) diff --git a/api/current.txt b/api/current.txt index 0d09aa4579941..3e9b7d961eccd 100644 --- a/api/current.txt +++ b/api/current.txt @@ -10854,6 +10854,7 @@ package android.media { method public void adjustVolume(int, int); method public int getMode(); method public java.lang.String getParameters(java.lang.String); + method public java.lang.String getProperty(java.lang.String); method public int getRingerMode(); method public deprecated int getRouting(int); method public int getStreamMaxVolume(int); @@ -10931,6 +10932,8 @@ package android.media { field public static final int MODE_NORMAL = 0; // 0x0 field public static final int MODE_RINGTONE = 1; // 0x1 field public static final deprecated int NUM_STREAMS = 5; // 0x5 + field public static final java.lang.String PROPERTY_OUTPUT_FRAMES_PER_BUFFER = "android.media.property.OUTPUT_FRAMES_PER_BUFFER"; + field public static final java.lang.String PROPERTY_OUTPUT_SAMPLE_RATE = "android.media.property.OUTPUT_SAMPLE_RATE"; field public static final java.lang.String RINGER_MODE_CHANGED_ACTION = "android.media.RINGER_MODE_CHANGED"; field public static final int RINGER_MODE_NORMAL = 2; // 0x2 field public static final int RINGER_MODE_SILENT = 0; // 0x0 diff --git a/media/java/android/media/AudioManager.java b/media/java/android/media/AudioManager.java index c848f0f10df1e..b3beaa6fe5f81 100644 --- a/media/java/android/media/AudioManager.java +++ b/media/java/android/media/AudioManager.java @@ -2445,30 +2445,29 @@ public class AudioManager { } /** - * Used as a key for #getProperty to request the native or optimal output sample rate for - * this device, in decimal Hz. - * {@hide} + * Used as a key for {@link #getProperty} to request the native or optimal output sample rate + * for this device's primary output stream, in decimal Hz. */ public static final String PROPERTY_OUTPUT_SAMPLE_RATE = "android.media.property.OUTPUT_SAMPLE_RATE"; /** - * Used as a key for #getProperty to request the native or optimal output buffer size for - * this device, in decimal PCM frames. - * {@hide} + * Used as a key for {@link #getProperty} to request the native or optimal output buffer size + * for this device's primary output stream, in decimal PCM frames. */ public static final String PROPERTY_OUTPUT_FRAMES_PER_BUFFER = "android.media.property.OUTPUT_FRAMES_PER_BUFFER"; /** + * Returns the value of the property with the specified key. * @param key One of the strings corresponding to a property key: either - * #PROPERTY_OUTPUT_SAMPLE_RATE or #PROPERTY_OUTPUT_FRAMES_PER_BUFFER + * {@link #PROPERTY_OUTPUT_SAMPLE_RATE} or + * {@link #PROPERTY_OUTPUT_FRAMES_PER_BUFFER} * @return A string representing the associated value for that property key, * or null if there is no value for that key. - * {@hide} */ public String getProperty(String key) { - // uses android.os.SystemProperties.get for selected keys, with suitable defaults + // implementation to be written return null; }