오디오 앱에서 VolumeShaper를 사용하여 페이드 인, 페이드 아웃, 크로스 페이드, 더킹, 기타 짧은 자동 볼륨 전환을 실행할 수 있습니다. VolumeShaper 클래스는 Android 8.0(API 수준 26) 이상에서 사용할 수 있습니다.
AudioTrack 또는 MediaPlayer의 인스턴스에서 createVolumeShaper()를 호출하여 VolumeShaper를 만듭니다. 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, 1초 지속 시간, 곡선 없음)으로 구성을 만드는 빌더를 반환합니다. build()를 호출하기 전에 빌더에 곡선을 추가해야 합니다.
프레임워크는 사전 빌드된 곡선이 있는 구성에 대한 상수를 제공하며, 각 상수의 지속 시간은 1초입니다.
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에서 동일한 Shaper를 빌드할 수 있습니다.
셰이퍼를 만들면 첫 번째 제어점(t = 0)이 오디오 스트림에 적용됩니다. 초기 볼륨이 1.0이 아니고 앱이 생성 시점에 자료를 재생하는 경우 오디오 볼륨이 갑자기 변경될 수 있습니다. 권장사항은
무음에서 오디오 재생을 시작하고 VolumeShaper를 사용하여 재생이 시작될 때
페이드 인을 구현하는 것입니다. 볼륨 0에서 시작하여 페이드 업되는 VolumeShaper를 만듭니다. 예를 들면 다음과 같습니다.
setCurve(new float[] {0.f, 1.f}, new float[] {0.f, 1.f})
재생과 셰이퍼를 동시에 시작합니다. 이렇게 하면 재생이 무음에서 시작되고 볼륨이 최대 볼륨으로 증가합니다. 이에 대해서는 다음 섹션에서 설명합니다.
VolumeShaper 실행
셰이퍼가 생성되는 즉시 첫 번째 컨트롤 포인트의 볼륨 수준이 오디오 경로에 적용되지만, VolumeShaper.Operation.PLAY를 사용하여 apply() 메서드를 호출할 때까지는 셰이퍼가 곡선을 따라 진행되지 않습니다. 셰이퍼를 만든 후 apply()의 첫 번째 호출은 셰이퍼를 시작하기 위해 PLAY 작업을 지정해야 합니다. 이렇게 하면 첫 번째 제어점부터 마지막 제어점까지 곡선이 실행됩니다.
shaper.apply(VolumeShaper.Operation.PLAY)
셰이퍼가 실행되는 동안 REVERSE 및 PLAY 작업을 지정하는 apply() 호출을 번갈아 실행할 수 있습니다. 이렇게 하면 매번 제어점의 판독 방향이 변경됩니다.
셰이퍼는 볼륨을 지속적으로 조정하고 만료될 때까지 모든 제어 지점을 통과합니다. 이는 셰이퍼가 곡선의 마지막(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()를 호출하면 볼륨 변경이 중지되고 현재 값으로 유지됩니다. 그러면 셰이퍼가 첫 번째 컨트롤 포인트에서 새 곡선을 시작하려고 합니다. 즉, 작업 인수는 호출 후 셰이퍼가 실행되는지 여부를 제어합니다. PLAY을 지정하여 새 곡선을 즉시 시작하고, REVERSE을 지정하여 새 곡선의 첫 번째 제어점 볼륨에서 셰이퍼를 일시중지 상태로 둡니다. 나중에 apply(VolumeShaper.Operation.PLAY)를 사용하여 Shaper를 시작할 수 있습니다.
join = false를 사용하여 replace()를 호출하면 셰이퍼는 첫 번째 제어 지점으로 지정된 수준에서 곡선을 시작합니다. 이로 인해 볼륨이 불연속적으로 들릴 수 있습니다. 이를 방지하려면 replace()로 설정한 상태에서 join = true를 호출하면 됩니다.
이렇게 하면 새 곡선의 첫 번째 제어점이 셰이퍼의 현재 수준으로 설정되고 첫 번째와 마지막 사이의 모든 제어점의 볼륨이 조정되어 새 곡선의 상대적 모양이 유지됩니다(마지막 제어점은 변경되지 않음). 크기 조절 작업은 셰이퍼의 새 곡선에서 제어점을 영구적으로 변경합니다.
VolumeShaper 제거
AudioTrack 또는 MediaPlayer가 해제되거나 더 이상 사용되지 않으면 시스템은 VolumeShaper를 닫고 가비지 컬렉션을 실행합니다. 셰이퍼에서 close() 메서드를 호출하여 즉시 소멸시킬 수 있습니다. 시스템은 약 20ms 이내에 오디오 파이프라인에서 셰이퍼를 삭제합니다. 오디오가 재생되는 동안 VolumeShaper를 닫을 때는 주의해야 합니다. close()를 호출할 때 셰이퍼의 볼륨이 1.0 미만이면 셰이퍼의 볼륨 배율이 1.0으로 변경됩니다. 이로 인해 볼륨이 갑자기 증가할 수 있습니다.