Możesz użyć VolumeShaper w aplikacji audio, aby wykonać stopniowe zwiększanie i zmniejszanie głośności, przenikanie, wyciszanie i inne krótkie automatyczne przejścia głośności. Klasa VolumeShaper jest dostępna w Androidzie 8.0 (poziom interfejsu API 26) i nowszych.
Obiekt VolumeShaper tworzysz, wywołując createVolumeShaper() w instancji AudioTrack lub MediaPlayer. VolumeShaper działa tylko na dźwięk generowany przez AudioTrack lub MediaPlayer, który go utworzył.
VolumeShaper.Configuration
Działanie VolumeShaper jest definiowane przez VolumeShaper.Configuration. Konfiguracja określa *krzywą głośności, typ interpolatora oraz czas trwania*.
Krzywa głośności
Krzywa głośności przedstawia zmianę amplitudy w czasie. Jest on definiowany przez parę tablic zmiennoprzecinkowych x[] i y[], które określają serię punktów kontrolnych. Każda para (x, y) reprezentuje odpowiednio czas i głośność. Tablice muszą mieć taką samą długość i zawierać od 2 do 16 wartości. (Maksymalna długość krzywej jest określona w polu getMaximumCurvePoints()).
Współrzędne czasu są podane w interwale [0,0, 1,0]. Pierwszy punkt czasowy musi wynosić 0,0, ostatni 1,0, a czasy muszą rosnąć monotonicznie.
Współrzędne głośności są określane w skali liniowej w przedziale [0,0; 1,0].
Typ interpolatora
Krzywa głośności zawsze przechodzi przez określone punkty kontrolne. Wartości między punktami kontrolnymi są uzyskiwane za pomocą krzywej sklejanej zgodnie z typem interpolatora konfiguracji. Dostępne są 4 stałe dla dostępnych typów interpolatorów VolumeShaper:
- VolumeShaper.Configuration.INTERPOLATOR_TYPE_STEP
- VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR
- VolumeShaper.Configuration.INTERPOLATOR_TYPE_CUBIC
- VolumeShaper.Configuration.INTERPOLATOR_TYPE_CUBIC_MONOTONIC
Czas trwania
Określone współrzędne czasu w przedziale [0.0, 1.0] są skalowane do czasu trwania określonego w milisekundach. Określa rzeczywistą długość krzywej głośności, gdy moduł kształtowania jest uruchomiony i stosuje krzywą do wyjścia audio.
Korzystanie z VolumeShaper
Tworzenie konfiguracji
Zanim utworzysz VolumeShaper, musisz utworzyć instancję VolumeShaper.Configuration. Możesz to zrobić za pomocą 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()
Bez argumentów konstruktor VolumeShaper.Configuration.Builder zwraca kreator, który tworzy konfigurację z ustawieniami domyślnymi: INTERPOLATOR_TYPE_CUBIC, czas trwania 1 sekunda i brak krzywej. Przed wywołaniem metody build() musisz dodać krzywą do kreatora.
Platforma udostępnia stałe dla konfiguracji z gotowymi krzywymi, z których każda trwa 1 sekundę:
VolumeShaper.Configuration.LINEAR_RAMPVolumeShaper.Configuration.CUBIC_RAMPVolumeShaper.Configuration.SINE_RAMPVolumeShaper.Configuration.SCURVE_RAMP
Tworzenie VolumeShaper
Aby utworzyć VolumeShaper, wywołaj createVolumeShaper() w instancji odpowiedniej klasy, przekazując VolumeShaper.Configuration:
volumeShaper = myMediaPlayer.createVolumeShaper(config) volumeShaper = myAudioTrack.createVolumeShaper(config)
Do jednej ścieżki lub odtwarzacza multimedialnego można podłączyć wiele modułów kształtowania i można sterować każdym z nich osobno. Dane wyjściowe wszystkich modułów kształtowania na ścieżce lub w odtwarzaczu są mnożone. Nie można udostępniać VolumeShaper między AudioTracks lub MediaPlayers, ale można użyć tej samej konfiguracji w wywołaniach createVolumeShaper, aby utworzyć identyczne kształtowniki na wielu AudioTracks lub MediaPlayers.
Gdy tworzysz shaper, jego pierwszy punkt kontrolny (przy t = 0) jest stosowany do strumienia audio. Jeśli początkowa głośność nie wynosi 1,0, a aplikacja odtwarza materiał w momencie tworzenia, może dojść do nagłej zmiany głośności dźwięku. Sprawdzoną metodą jest rozpoczęcie odtwarzania dźwięku od ciszy i użycie VolumeShaper do stopniowego zwiększania głośności po rozpoczęciu odtwarzania. Utwórz VolumeShaper, który zaczyna się od głośności 0 i stopniowo się zwiększa. Przykład:
setCurve(new float[] {0.f, 1.f}, new float[] {0.f, 1.f})
Uruchom odtwarzanie i urządzenie do kształtowania w tym samym czasie. Dzięki temu odtwarzanie zaczyna się od ciszy, a głośność stopniowo wzrasta do maksymalnego poziomu. Omówimy to w następnej sekcji.
Uruchamianie VolumeShaper
Poziom głośności pierwszego punktu kontrolnego jest stosowany do ścieżki audio zaraz po utworzeniu modułu kształtowania, ale moduł nie przesuwa się po krzywej, dopóki nie wywołasz metody apply() z parametrem VolumeShaper.Operation.PLAY. Po utworzeniu kształtownika pierwsze wywołanie apply() musi określać operację PLAY, aby uruchomić kształtownik. Spowoduje to poprowadzenie krzywej od pierwszego do ostatniego punktu kontrolnego:
shaper.apply(VolumeShaper.Operation.PLAY)
Gdy moduł kształtowania jest uruchomiony, możesz wykonywać naprzemienne wywołania apply(), określając operacje REVERSE i PLAY. Za każdym razem zmienia to kierunek odczytu punktów kontrolnych.
Kształtownik stale dostosowuje głośność i przechodzi przez wszystkie punkty kontrolne, dopóki nie wygaśnie. Dzieje się tak, gdy moduł kształtowania osiągnie ostatni (w przypadku operacji PLAY) lub pierwszy (w przypadku operacji REVERSE) punkt kontrolny na krzywej.
Po wygaśnięciu kształtowania głośność pozostaje na ostatnim ustawieniu, którym może być pierwszy lub ostatni punkt kontrolny. W każdej chwili możesz wywołać VolumeShaper.getVolume(), aby sprawdzić bieżący poziom głośności.
Po wygaśnięciu kształtownika możesz wydać kolejne polecenie apply(), aby uruchomić krzywą w przeciwnym kierunku. Jeśli na przykład kształtowanie wygasło podczas działania PLAY, następnym apply() musi być REVERSE. Wywołanie metody PLAY po wygaśnięciu PLAY lub metody REVERSE po wygaśnięciu REVERSE nie przyniesie żadnego efektu.
Musisz wykonywać operacje PLAY i REVERSE naprzemiennie. Nie ma możliwości odtworzenia krzywej od pierwszego do ostatniego punktu kontrolnego, a następnie ponownego uruchomienia jej od pierwszego punktu kontrolnego. Możesz użyć metody replace(), opisanej w następnej sekcji, aby zastąpić krzywą jej kopią. Spowoduje to zresetowanie modułu kształtowania, co wymaga operacji PLAY, aby uruchomić go ponownie.
Zmiana krzywej
Aby zmienić krzywą elementu VolumeShaper, użyj metody replace(). Ta metoda przyjmuje konfigurację, operację i parametr złączenia. Metodę replace() możesz wywołać w dowolnym momencie, gdy moduł kształtowania jest uruchomiony lub po jego wygaśnięciu:
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)
Gdy wywołasz funkcję replace(), gdy moduł kształtowania jest uruchomiony, przestanie on zmieniać głośność i pozostanie przy bieżącej wartości. Następnie Shaper próbuje rozpocząć nową krzywą od pierwszego punktu kontrolnego. Oznacza to, że argument operacji określa, czy po wywołaniu zostanie uruchomiony moduł kształtowania. Określ PLAY, aby natychmiast rozpocząć nową krzywą, lub REVERSE, aby pozostawić moduł kształtowania wstrzymany na poziomie głośności pierwszego punktu kontrolnego na nowej krzywej. Możesz uruchomić kształtowanie później za pomocą apply(VolumeShaper.Operation.PLAY).
Gdy wywołasz funkcję replace() z argumentem join = false, moduł kształtowania rozpocznie krzywą na poziomie określonym przez pierwszy punkt kontrolny. Może to spowodować przerwę w głośności. Możesz tego uniknąć, wywołując replace() z join = true.
Spowoduje to ustawienie pierwszego punktu kontrolnego nowej krzywej na bieżący poziom kształtownika i skalowanie głośności wszystkich punktów kontrolnych między pierwszym a ostatnim, aby zachować względny kształt nowej krzywej (ostatni punkt kontrolny pozostanie niezmieniony). Operacja skalowania trwale zmienia punkty kontrolne na nowej krzywej kształtownika.
Usuwanie VolumeShaper
System zamyka i usuwa obiekt VolumeShaper, gdy jego AudioTrack lub MediaPlayer zostanie zwolniony lub nie będzie już używany. Możesz wywołać metodę close() na obiekcie shaper, aby natychmiast go zniszczyć. System usuwa moduł kształtowania z potoku audio w ciągu około 20 ms. Zachowaj ostrożność podczas zamykania obiektu VolumeShaper, gdy odtwarzany jest dźwięk. Jeśli podczas wywoływania funkcji close() głośność kształtownika jest mniejsza niż 1,0, skala głośności kształtownika zmienia się na 1,0. Może to spowodować nagły wzrost głośności.