Android Equalizer 참조문서
본 번역문서는 Android Equalizer의 정보를 보다 보기 쉽게 하는 개인적인 취지로 번역되어 제공되는 문서로, 원문을 비롯한 모든 저작권은 Google에 있습니다. Google의 요청이 있을 경우, 언제라도 게시가 중단될 수 있습니다. 본 번역문서에는 오역이 포함되어 있을 수 있으며 주석도 번역자 개인의 견해일뿐입니다. Google은 본 문서의 번역된 내용에 대해 일체의 보장을 하지 않습니다. 번역이 완료된 뒤에도 제품이 업그레이드 되거나 기능이 변경됨에 따라 원문도 변경되거나 보완되었을 수 있으므로 참고하시기 바랍니다
- 본 번역문서의 원문은 Equalizer | Android Developers 입니다.
added in API level 9
Summary: Nested Classes | Constants | Inherited Constants | Inherited Fields | Ctors | Methods | Inherited Methods | [Expand All]
Equalizer
| java.lang.Object | ||
| ↳ | android.media.audiofx.AudioEffect | |
| ↳ | android.media.audiofx.Equalizer | |
Eqaulizer는 특정 음악 또는 메인 출력 믹스의 주파수 응답을 바꾸기 위해 사용됩니다
하나의 어플리케이션은 복제할 Equalizer 객체를 만들고, 오디오 프레임워크에 있는 Equalizer 엔진을 조정합니다. 그 어플리케이션은 그저 미리 설정된 프리셋을 쓰거나, Equalizer에 의해 조정되는 각각의 주파수 대역의 세기의 더 세밀한 조정을 할 수 있습니다.
매서드들(Equalizer implementation에 나타난 파라미터 타입과 유닛들)은 OpenSL ES 1.0.1 Specification (http://www.khronos.org/opensles/)에 의해 이 정의에 직접 매핑했습니다.
Equalizer를 특정 AudioTrack 나 MediaPlayer에 장착하기 위해서는, Equalizer를 생성할때 AudioTrack 나 MediaPlayer의 오디오 세션 아이디( audio session ID)를 명시하여야 합니다.
참고: Eqaulizer를 세션 0를 사용하여 전역 오디오 출력(global audio output )에 장착시키는 것은 권장되지 않습니다.
오디오 세션의 자세한 정보 보기
getAudioSessionId()
오디오 효과를 조정하는 클래스의 자세한 정보 보기
AudioEffect 요약
중첩 클래스 (Nested classes) | |
|---|---|
interface | Equalizer.OnParameterChangeListenerOnParameterChangeListener interface는 함수 인자의 값이 변했을때 Equalizer에 의해 불리는 매서드를 정의합니다. |
class | Equalizer.SettingsSetting 클래스는 모든 equalizer의 인자들을 재편성합니다. |
상수 (Constants) | |
|---|---|
int | PARAM_BAND_FREQ_RANGE대역 주파수 범위 |
int | PARAM_BAND_LEVEL주파수 레벨 |
int | PARAM_CENTER_FREQ대역 중심 주파수 |
int | PARAM_CURRENT_PRESET현재 프리셋 |
int | PARAM_GET_BAND주어진 주파수에 대한 대역 |
int | PARAM_GET_NUM_OF_PRESETS프리셋들의 요청 개수 |
int | PARAM_GET_PRESET_NAME요청 프리셋 이름 |
int | PARAM_LEVEL_RANGE대역 레벨 범위 |
int | PARAM_NUM_BANDS대역의 개수 |
int | PARAM_STRING_SIZE_MAX프리셋 이름에 대한 최대 크기 |
Inherited constants |
|---|
 From class android.media.audiofx.AudioEffect |
Inherited fields |
|---|
From class android.media.audiofx.AudioEffect |
Public constructors | |
|---|---|
Equalizer(int priority, int audioSession)Class constructor. | |
Public methods | |
|---|---|
short | getBand(int frequency)주어진 주파수에 가장 효과가 있는 대역을 가져옵니다. |
int[] | getBandFreqRange(short band)주어진 주파수 대역의 주파수 범위를 가져옵니다. |
short | getBandLevel(short band)주어진 이퀄라이저 대역을 위한 강도 세트(gain set)를 가져옵니다. |
short[] | getBandLevelRange()사용할 레벨 범위(level range)를 setBandLevel(short, short) 을 통해 가져옵니다. |
int | getCenterFreq(short band)주어진 대역의 중심 주파수를 가져옵니다. |
short | getCurrentPreset()현재 프리셋을 가져옵니다. |
short | getNumberOfBands()Equalizer 엔진에서 제공되는 주파수 대역의 개수를 가져옵니다. |
short | getNumberOfPresets()이퀄라이저가 지원하는 프리셋의 총 개수를 가져옵니다. |
String | getPresetName(short preset)인덱스(index)에 기반하여 프리셋의 이름을 가져옵니다. |
Equalizer.Settings | getProperties()이퀄라이저의 속성들(properties)을 가져옵니다. |
void | setBandLevel(short band, short level)주어진 게인 값(gain value)으로 주어진 이퀄라이저 대역을 설정합니다. |
void | setParameterListener(Equalizer.OnParameterChangeListener listener)OnParameterChangeListener 인터페이스(interface)를 등록합니다. |
void | setProperties(Equalizer.Settings settings)이퀄라이저 속성(propertites)을 설정합니다. |
void | usePreset(short preset)주어진 프리셋을 기반으로 이퀄라이저를 설정합니다. |
Inherited methods | |
|---|---|
From class android.media.audiofx.AudioEffect | |
From class java.lang.Object | |
상수 (Constants)
PARAM_BAND_FREQ_RANGE
added in API level 9
int PARAM_BAND_FREQ_RANGE
대역 주파수 범위(Band frequency range). Parameter ID for
Equalizer.OnParameterChangeListener
Constant Value: 4 (0x00000004)
PARAM_BAND_LEVEL
added in API level 9
int PARAM_BAND_LEVEL
대역 레벨(Band level). Parameter ID for OnParameterChangeListener
Constant Value: 2 (0x00000002)
PARAM_CENTER_FREQ
added in API level 9
int PARAM_CENTER_FREQ
대역 중심 주파수(Band center frequency). Parameter ID for OnParameterChangeListener
Constant Value: 3 (0x00000003)
PARAM_CURRENT_PRESET
added in API level 9
int PARAM_CURRENT_PRESET
현재 프리셋(Current preset). Parameter ID for OnParameterChangeListener
Constant Value: 6 (0x00000006)
PARAM_GET_BAND
added in API level 9
int PARAM_GET_BAND
주어진 주파수에 대한 대역(Band for a given frequency). Parameter ID for OnParameterChangeListener
Constant Value: 5 (0x00000005)
PARAM_GET_NUM_OF_PRESETS
added in API level 9
int PARAM_GET_NUM_OF_PRESETS
프리셋의 요청 개수(Request number of presets). Parameter ID for OnParameterChangeListener
Constant Value: 7 (0x00000007)
PARAM_GET_PRESET_NAME
added in API level 9
int PARAM_GET_PRESET_NAME
요청 프리셋 이름(Request preset name). Parameter ID for OnParameterChangeListener
Constant Value: 8 (0x00000008)
PARAM_LEVEL_RANGE
added in API level 9
int PARAM_LEVEL_RANGE
대역 레벨 범위(Band level range). Parameter ID for OnParameterChangeListener
Constant Value: 1 (0x00000001)
PARAM_NUM_BANDS
added in API level 9
int PARAM_NUM_BANDS
대역들의 개수(Number of bands). Parameter ID for OnParameterChangeListener
Constant Value: 0 (0x00000000)
PARAM_STRING_SIZE_MAX
added in API level 9
int PARAM_STRING_SIZE_MAX
프리셋 이름의 최대 길이(Maximum size for preset name)
Constant Value: 32 (0x00000020)
퍼블릭 생성자(Public constructors)
Equalizer
added in API level 9
Equalizer (int priority,
int audioSession)
Class constructor.
| Parameters | |
|---|---|
priority | int: the priority level requested by the application for controlling the Equalizer engine. As the same engine can be shared by several applications, this parameter indicates how much the requesting application needs control of effect parameters. The normal priority is 0, above normal is a positive number, below normal a negative number. |
audioSession | int: system wide unique audio session identifier. The Equalizer will be attached to the MediaPlayer or AudioTrack in the same audio session. |
| Throws | |
|---|---|
| java.lang.IllegalStateException |
| java.lang.IllegalArgumentException |
| java.lang.UnsupportedOperationException |
RuntimeException | |
IllegalStateException | |
IllegalArgumentException | |
UnsupportedOperationException | |
.
.
Comments
Post a Comment