В аудиоприложении можно использовать VolumeShaper, чтобы выполнять плавное появление, затухание, перекрестное затухание, приглушение и другие короткие автоматические переходы громкости. Класс VolumeShaper доступен в Android 8.0 (уровень API 26) и более поздних версиях.
Чтобы создать VolumeShaper, вызовите createVolumeShaper() в экземпляре AudioTrack или MediaPlayer. VolumeShaper действует только на аудио, созданное AudioTrack или MediaPlayer.
VolumeShaper.Configuration
Поведение VolumeShaper определяется его VolumeShaper.Configuration. В конфигурации указывается *кривая громкости, тип интерполятора и длительность*.
Кривая громкости
Кривая громкости показывает, как меняется амплитуда со временем. Она задается парой массивов с плавающей запятой, x[] и y[], которые определяют ряд контрольных точек. Каждая пара (x, y) представляет время и громкость соответственно. Массивы должны быть одинаковой длины и содержать от 2 до 16 значений. Максимальная длина кривой определяется в getMaximumCurvePoints().
Временные координаты задаются в интервале [0.0, 1.0]. Первая временная точка должна быть 0.0, последняя – 1.0, а остальные должны быть расположены в порядке возрастания.
Координаты громкости указываются по линейной шкале в интервале [0,0; 1,0].
Тип интерполятора
Кривая громкости всегда проходит через указанные контрольные точки. Значения между контрольными точками выводятся сплайном в соответствии с типом интерполятора конфигурации. Для доступных типов интерполятора VolumeShaper есть четыре константы:
- VolumeShaper.Configuration.INTERPOLATOR_TYPE_STEP
- VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR
- VolumeShaper.Configuration.INTERPOLATOR_TYPE_CUBIC
- VolumeShaper.Configuration.INTERPOLATOR_TYPE_CUBIC_MONOTONIC
Продолжительность
Указанные временные координаты в интервале [0.0, 1.0] масштабируются до длительности, которую вы указываете в миллисекундах. Это определяет фактическую продолжительность кривой громкости, когда шейпер работает и применяет кривую к аудиовыходу.
Использование VolumeShaper
Как создать конфигурацию
Прежде чем создавать VolumeShaper, необходимо создать экземпляр VolumeShaper.Configuration. Для этого используйте VolumeShaper.Configuration.Builder():
val config: VolumeShaper.Configuration = VolumeShaper.Configuration.Builder() .setDuration(3000) .setCurve(floatArrayOf(0f, 1f), floatArrayOf(0f, 1f)) .setInterpolatorType(VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR) .build()
Если аргументы не заданы, конструктор VolumeShaper.Configuration.Builder возвращает построитель, который создает конфигурацию с настройками по умолчанию: INTERPOLATOR_TYPE_CUBIC, длительность – одна секунда, кривая отсутствует. Прежде чем вызывать build(), необходимо добавить кривую в конструктор.
Фреймворк предоставляет константы для конфигураций с готовыми кривыми, каждая из которых имеет длительность в одну секунду:
VolumeShaper.Configuration.LINEAR_RAMPVolumeShaper.Configuration.CUBIC_RAMPVolumeShaper.Configuration.SINE_RAMPVolumeShaper.Configuration.SCURVE_RAMP
Создание VolumeShaper
Чтобы создать VolumeShaper, вызовите createVolumeShaper() для экземпляра соответствующего класса, передав VolumeShaper.Configuration:
volumeShaper = myMediaPlayer.createVolumeShaper(config) volumeShaper = myAudioTrack.createVolumeShaper(config)
К одной дорожке или медиапроигрывателю можно подключить несколько шейперов и управлять каждым из них по отдельности. Выходные сигналы всех шейперов на дорожке или проигрывателе перемножаются. Объект VolumeShaper нельзя использовать одновременно в AudioTracks и MediaPlayers, но вы можете использовать одну и ту же конфигурацию в вызовах createVolumeShaper, чтобы создавать одинаковые шейперы в нескольких AudioTracks или MediaPlayers.
При создании шейпера его первая контрольная точка (при t = 0) применяется к аудиопотоку. Если начальная громкость не равна 1.0 и ваше приложение воспроизводит материал во время создания, громкость звука может резко измениться. Рекомендуется начинать воспроизведение аудио с тишины и использовать VolumeShaper, чтобы реализовать постепенное увеличение громкости в начале воспроизведения. Создайте VolumeShaper, который начинается с нулевой громкости и постепенно становится громче. Пример:
setCurve(new float[] {0.f, 1.f}, new float[] {0.f, 1.f})
Запустите воспроизведение и шейпер одновременно. Это гарантирует, что воспроизведение начинается с тишины, а громкость увеличивается до полной. Подробнее об этом рассказывается в следующем разделе.
Запуск VolumeShaper
Хотя уровень громкости первой контрольной точки применяется к аудиодорожке сразу после создания шейпера, он не будет продвигаться по кривой, пока вы не вызовете метод apply() с параметром VolumeShaper.Operation.PLAY. После создания шейпера первый вызов apply() должен указывать операцию PLAY, чтобы запустить шейпер. Это позволяет провести кривую от первой до последней контрольной точки:
shaper.apply(VolumeShaper.Operation.PLAY)
Пока шейпер работает, вы можете поочередно вызывать apply(), указывая операции REVERSE и PLAY. Это меняет направление считывания контрольных точек каждый раз.
Шейпер непрерывно регулирует громкость и проходит через все контрольные точки, пока не истечет срок его действия. Это происходит, когда шейпер достигает последней (для операции PLAY) или первой (для операции REVERSE) контрольной точки на кривой.
Когда срок действия шейпера истекает, громкость остается на последнем установленном уровне, который может быть первой или последней контрольной точкой. Вы можете в любой момент вызвать VolumeShaper.getVolume(), чтобы узнать текущий уровень громкости.
После того как срок действия шейпера истечет, вы можете выполнить ещё один вызов apply(), чтобы запустить кривую в противоположном направлении. Например, если срок действия шейпера истек во время выполнения PLAY, следующим apply() должен быть REVERSE. Вызов PLAY после истечения срока действия PLAY или REVERSE после истечения срока действия REVERSE не имеет эффекта.
Операции PLAY и REVERSE должны чередоваться. Нельзя воспроизвести кривую от первой до последней контрольной точки, а затем перезапустить ее с первой контрольной точки. Вы можете использовать метод replace(), описанный в следующем разделе, чтобы заменить кривую ее копией. Это сбрасывает шейпер,
требуя операции PLAY, чтобы запустить его снова.
Изменение кривой
Чтобы изменить кривую VolumeShaper, используйте метод replace(). Этот метод принимает конфигурацию, операцию и параметр объединения. Вы можете вызвать метод replace() в любое время, пока работает шейпер или после истечения срока его действия:
val newConfig = VolumeShaper.Configuration.Builder() .setDuration(1000) .setCurve(floatArrayOf(0f, 0.5f), floatArrayOf(0f, 1f)) .setInterpolatorType(VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR) .build() val join = true shaper.replace(newConfig, VolumeShaper.Operation.PLAY, join)
Если вы вызовете replace() во время работы шейпера, он перестанет менять громкость и останется на текущем значении. Затем шейпер пытается начать новую кривую с первой контрольной точки. Это означает, что аргумент operation определяет, будет ли шейпер запущен после вызова. Укажите PLAY, чтобы сразу начать новую кривую, или REVERSE, чтобы оставить шейпер на паузе на уровне громкости первой контрольной точки новой кривой. Вы можете запустить шейпер позже с помощью apply(VolumeShaper.Operation.PLAY).
Когда вы вызываете replace() с join = false, шейпер начинает кривую на уровне, указанном его первой контрольной точкой. Это может привести к разрыву
в объеме. Чтобы избежать этого, вызовите метод replace() с параметром join = true.
При этом первая контрольная точка новой кривой устанавливается на текущий уровень шейпера, а громкость всех контрольных точек между первой и последней масштабируется для сохранения относительной формы новой кривой (последняя контрольная точка не изменяется). Масштабирование навсегда изменяет контрольные точки на новой кривой шейпера.
Удаление VolumeShaper
Система закрывает и удаляет VolumeShaper, когда его AudioTrack или MediaPlayer освобождается или больше не используется. Чтобы немедленно удалить шейпер, вызовите метод close(). Система удаляет шейпер из аудиоконвейера примерно за 20 мс. Будьте осторожны, закрывая VolumeShaper во время воспроизведения аудио. Если при вызове close() громкость шейпера меньше 1,0, она увеличивается до 1,0. Это может привести к внезапному увеличению громкости.