AudioEffectFilter — C# API

Базовый класс для фильтров. Используйте эффекты, наследующие этот класс, вместо прямого использования его.

class AudioEffectFilterReckfellSharpНаследует AudioEffect

Базовый класс для фильтров. Используйте эффекты, наследующие этот класс, вместо прямого использования его.

Фильтр управляет усилением частот, используя AudioEffectFilter.CutoffHz в качестве порогового значения частоты. Фильтры могут помочь обеспечить пространство для каждого звука и создать интересные эффекты. Существуют различные типы фильтров, наследующих этот класс: Полочные фильтры: AudioEffectLowShelfFilter и AudioEffectHighShelfFilter Полосовые и режекторные фильтры: AudioEffectBandPassFilter, AudioEffectBandLimitFilter и AudioEffectNotchFilter Фильтры нижних/верхних частот: AudioEffectLowPassFilter и AudioEffectHighPassFilter

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

Конструкторы1

AudioEffectFilterКонструктор

# AudioEffectFilter

C#
public AudioEffectFilter();

Свойства4

CutoffHzСвойство

# CutoffHz

C#
public float CutoffHz { get; set; }

Частотный порог фильтра, в Гц. Значение может варьироваться от 1 до 20500.

DbСвойство

# Db

C#
public AudioEffectFilter.FilterDB Db { get; set; }

Крутизна кривой среза в дБ на октаву (удвоенная частота выше AudioEffectFilter.CutoffHz или половина частоты ниже AudioEffectFilter.CutoffHz), также известная как «порядок» фильтра. Более высокие порядки имеют более агрессивный срез.

GainСвойство

# Gain

C#
public float Gain { get; set; }

Усиление частот, на которые воздействует фильтр. Это свойство доступно только для AudioEffectLowShelfFilter и AudioEffectHighShelfFilter. Значение может варьироваться от 0 до 4.

ResonanceСвойство

# Resonance

C#
public float Resonance { get; set; }

Усиление на частоте, близкой к AudioEffectFilter.CutoffHz, или непосредственно рядом с ней. Значение может варьироваться от 0 до 1. Точное поведение зависит от выбранного типа фильтра:

Для полочных фильтров: усиливает или маскирует порядок, увеличивая частоты непосредственно рядом с частотой AudioEffectFilter.CutoffHz и уменьшая частоты на противоположной стороне.
Для полосовых и режекторных фильтров: расширяет или сужает фильтр на частоте, близкой к AudioEffectFilter.CutoffHz.
Для фильтров нижних/верхних частот: увеличивает или уменьшает частоты на частоте, близкой к AudioEffectFilter.CutoffHz.

Методы8

GetCutofffloat

# GetCutoff

C#
public float GetCutoff();

Возвращает float

GetDbAudioEffectFilter.FilterDB

# GetDb

C#
public AudioEffectFilter.FilterDB GetDb();

Возвращает AudioEffectFilter.FilterDB

GetGainfloat

# GetGain

C#
public float GetGain();

Возвращает float

GetResonancefloat

# GetResonance

C#
public float GetResonance();

Возвращает float

SetCutoffvoid

# SetCutoff

C#
public void SetCutoff(float freq);

Параметры
Имя	Тип	По умолчанию
`freq`	`float`	—

SetDbvoid

# SetDb

C#
public void SetDb(AudioEffectFilter.FilterDB amount);

Параметры
Имя	Тип	По умолчанию
`amount`	`AudioEffectFilter.FilterDB`	—

SetGainvoid

# SetGain

C#
public void SetGain(float amount);

Параметры
Имя	Тип	По умолчанию
`amount`	`float`	—

SetResonancevoid

# SetResonance

C#
public void SetResonance(float amount);

Параметры
Имя	Тип	По умолчанию
`amount`	`float`	—

AudioEffectFilter.FilterDB

Значение	Описание
`Filter12Db = 1`	Срез на уровне 12 дБ на октаву. Одна октава — это удвоенная частота выше `AudioEffectFilter.CutoffHz` или половина частоты ниже `AudioEffectFilter.CutoffHz`.
`Filter18Db = 2`	Срез на уровне 18 дБ на октаву. Одна октава — это удвоенная частота выше `AudioEffectFilter.CutoffHz` или половина частоты ниже `AudioEffectFilter.CutoffHz`.
`Filter24Db = 3`	Срез на уровне 24 дБ на октаву. Одна октава — это удвоенная частота выше `AudioEffectFilter.CutoffHz` или половина частоты ниже `AudioEffectFilter.CutoffHz`.
`Filter6Db = 0`	Срез на уровне 6 дБ на октаву. Одна октава — это удвоенная частота выше `AudioEffectFilter.CutoffHz` или половина частоты ниже `AudioEffectFilter.CutoffHz`.