VolumeShaper ile genliği kontrol etme

Ses uygulamalarında VolumeShaper kullanarak ses açma, ses kısma, çapraz geçiş, sesi kısma ve diğer kısa otomatik ses geçişlerini gerçekleştirebilirsiniz. VolumeShaper sınıfı, Android 8.0 (API düzeyi 26) ve sonraki sürümlerde kullanılabilir.

Bir AudioTrack veya MediaPlayer örneğinde createVolumeShaper() yöntemini çağırarak VolumeShaper oluşturabilirsiniz. VolumeShaper, yalnızca kendisini oluşturan AudioTrack veya MediaPlayer tarafından üretilen ses üzerinde işlem yapar.

VolumeShaper.Configuration

VolumeShaper öğesinin davranışı, VolumeShaper.Configuration tarafından tanımlanır. Yapılandırmada *ses düzeyi eğrisi, interpolatör türü ve süre* belirtilir.

Ses düzeyi eğrisi

Ses düzeyi eğrisi, zaman içindeki genlik değişimini temsil eder. Bir dizi kontrol noktasını tanımlayan x[] ve y[] kayan nokta dizileriyle tanımlanır. Her (x, y) çifti sırasıyla zamanı ve hacmi temsil eder. Diziler eşit uzunlukta olmalı ve en az 2, en fazla 16 değer içermelidir. (Maksimum eğri uzunluğu getMaximumCurvePoints() içinde tanımlanır.)

Zaman koordinatları [0,0, 1,0] aralığında verilir. İlk zaman noktası 0,0, son zaman noktası 1,0 olmalı ve zamanlar monoton olarak artmalıdır.

Ses seviyesi koordinatları, [0,0, 1,0] aralığında doğrusal ölçekte belirtilir.

Enterpolatör türü

Ses düzeyi eğrisi her zaman belirtilen kontrol noktalarından geçer. Kontrol noktaları arasındaki değerler, yapılandırmanın interpolatör türüne göre bir spline ile türetilir. Kullanılabilir VolumeShaper interpolatör türleri için dört sabit vardır:

  • VolumeShaper.Configuration.INTERPOLATOR_TYPE_STEP
  • VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR
  • VolumeShaper.Configuration.INTERPOLATOR_TYPE_CUBIC
  • VolumeShaper.Configuration.INTERPOLATOR_TYPE_CUBIC_MONOTONIC

Süre

[0,0, 1,0] aralığında belirtilen zaman koordinatları, milisaniye cinsinden belirttiğiniz bir süreye ölçeklendirilir. Bu, şekillendirici çalışırken ve eğriyi ses çıkışına uygularken ses düzeyi eğrisinin gerçek süresini belirler.

VolumeShaper kullanma

Yapılandırma oluşturma

VolumeShaper oluşturmadan önce bir VolumeShaper.Configuration örneği oluşturmanız gerekir. Bunu yapmak için VolumeShaper.Configuration.Builder() kullanın:

val config: VolumeShaper.Configuration = VolumeShaper.Configuration.Builder()
    .setDuration(3000)
    .setCurve(floatArrayOf(0f, 1f), floatArrayOf(0f, 1f))
    .setInterpolatorType(VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR)
    .build()

Bağımsız değişken içermeyen VolumeShaper.Configuration.Builder oluşturucu, varsayılan ayarlarla bir yapılandırma oluşturan bir oluşturucu döndürür: INTERPOLATOR_TYPE_CUBIC, bir saniyelik süre ve eğri yok. build() çağrısı yapmadan önce oluşturucuya bir eğri eklemeniz gerekir.

Çerçeve, önceden oluşturulmuş eğrilere sahip yapılandırmalar için sabitler sağlar. Her birinin süresi bir saniyedir:

  • VolumeShaper.Configuration.LINEAR_RAMP
  • VolumeShaper.Configuration.CUBIC_RAMP
  • VolumeShaper.Configuration.SINE_RAMP
  • VolumeShaper.Configuration.SCURVE_RAMP

VolumeShaper oluşturma

VolumeShaper oluşturmak için uygun sınıfın bir örneğinde createVolumeShaper() yöntemini çağırın ve VolumeShaper.Configuration nesnesini iletin:

volumeShaper = myMediaPlayer.createVolumeShaper(config)
volumeShaper = myAudioTrack.createVolumeShaper(config)

Tek bir parçaya veya medya oynatıcıya birden fazla şekillendirici eklenebilir ve her şekillendiriciyi ayrı ayrı kontrol edebilirsiniz. Bir parçadaki veya oynatıcıdaki tüm şekillendiricilerin çıkışları birbiriyle çarpılır. VolumeShaper, AudioTracks veya MediaPlayers arasında paylaşılamaz ancak birden fazla AudioTracks veya MediaPlayers üzerinde aynı şekillendiricileri oluşturmak için createVolumeShaper çağrılarında aynı yapılandırmayı kullanabilirsiniz.

Şekillendiriciyi oluşturduğunuzda ilk kontrol noktası (t = 0'da) ses akışına uygulanır. İlk ses seviyesi 1, 0 değilse ve uygulamanız oluşturma sırasında materyal oynatıyorsa ses seviyesinde ani bir değişiklik olabilir. En iyi uygulama, sesi sessizden başlatmak ve oynatma başladığında sesi yavaşça artırmak için VolumeShaper kullanmaktır. 0 ses seviyesinde başlayıp yükselen bir VolumeShaper oluşturun. Örnek:

setCurve(new float[] {0.f, 1.f}, new float[] {0.f, 1.f})

Oynatmayı ve şekillendiriciyi aynı anda başlatın. Bu sayede oynatma sessiz başlar ve ses seviyesi kademeli olarak artar. Bu konu bir sonraki bölümde açıklanmaktadır.

VolumeShaper'ı çalıştırma

İlk kontrol noktasının ses seviyesi, şekillendirici oluşturulur oluşturulmaz ses yoluna uygulanır ancak şekillendirici, VolumeShaper.Operation.PLAY ile apply() yöntemini çağırana kadar eğri boyunca ilerlemez. Şekillendiriciyi oluşturduktan sonra, şekillendiriciyi başlatmak için apply() öğesinin ilk çağrısında PLAY işlemi belirtilmelidir. Bu, eğriyi ilk kontrol noktasından son kontrol noktasına kadar çalıştırır:

shaper.apply(VolumeShaper.Operation.PLAY)

Şekillendirici çalışırken REVERSE ve PLAY işlemlerini belirten dönüşümlü apply() çağrıları yapabilirsiniz. Bu işlem, kontrol noktalarının okuma yönünü her seferinde değiştirir.

Şekillendirici, ses seviyesini sürekli olarak ayarlar ve süresi dolana kadar tüm kontrol noktalarından geçer. Bu durum, şekillendirici eğrideki son (PLAY işlemi için) veya ilk (REVERSE işlemi için) kontrol noktasına ulaştığında gerçekleşir.

Şekillendiricinin süresi dolduğunda ses seviyesi, son ayarda kalır. Bu ayar, ilk veya son kontrol noktası olabilir. Mevcut ses seviyesini öğrenmek için istediğiniz zaman VolumeShaper.getVolume() diyebilirsiniz.

Şekillendiricinin süresi dolduktan sonra, eğriyi ters yönde çalıştırmak için başka bir apply() çağrısı yapabilirsiniz. Örneğin, şekillendiricinin süresi PLAY çalışırken dolduysa bir sonraki apply(), REVERSE olmalıdır. PLAY süresi dolduktan sonra PLAY yöntemini veya REVERSE süresi dolduktan sonra REVERSE yöntemini çağırmanın bir etkisi yoktur.

PLAY ve REVERSE işlemlerini sırayla yapmanız gerekir. Bir eğriyi ilk kontrol noktasından son kontrol noktasına kadar oynatıp ardından ilk kontrol noktasından tekrar başlatmanın bir yolu yoktur. Eğriyi kendi kopyasıyla değiştirmek için bir sonraki bölümde açıklanan replace() yöntemini kullanabilirsiniz. Bu işlem, şekillendiriciyi sıfırlar ve yeniden başlatmak için PLAY işleminin yapılmasını gerektirir.

Eğriyi değiştirme

VolumeShaper eğrisini değiştirmek için replace() yöntemini kullanın. Bu yöntem bir yapılandırma, bir işlem ve bir birleştirme parametresi alır. Şekillendirici çalışırken veya süresi dolduktan sonra istediğiniz zaman replace() yöntemini çağırabilirsiniz:

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)

Şekillendirici çalışırken replace() işlevini çağırırsanız ses seviyesini değiştirmeyi durdurur ve mevcut değerinde kalır. Ardından şekillendirici, yeni eğriyi ilk kontrol noktasından başlatmaya çalışır. Bu, işlem bağımsız değişkeninin, şekillendiricinin çağrıdan sonra çalışıp çalışmayacağını kontrol ettiği anlamına gelir. Yeni eğriyi hemen başlatmak için PLAY değerini, şekillendiriciyi yeni eğrideki ilk kontrol noktasının ses seviyesinde duraklatılmış olarak bırakmak için REVERSE değerini belirtin. Şekillendiriciyi daha sonra apply(VolumeShaper.Operation.PLAY) ile başlatabilirsiniz.

join = false ile replace() işlevini çağırdığınızda şekillendirici, eğrisini ilk kontrol noktası tarafından belirtilen düzeyde başlatır. Bu durum, ses seviyesinde kesintiye neden olabilir. join = true ile replace() numarasını arayarak bu sorunu önleyebilirsiniz. Bu işlem, yeni eğrinin ilk kontrol noktasını şekillendiricinin mevcut seviyesine ayarlar ve yeni eğrinin göreceli şeklini korumak için ilk ve son kontrol noktaları arasındaki tüm kontrol noktalarının hacmini ölçeklendirir (son kontrol noktası değişmez). Ölçeklendirme işlemi, şekillendiricinin yeni eğrisindeki kontrol noktalarını kalıcı olarak değiştirir.

VolumeShaper'ı kaldırma

Sistem, AudioTrack veya MediaPlayer serbest bırakıldığında ya da artık kullanılmadığında VolumeShaper öğesini kapatır ve çöp toplama işlemi yapar. Bir şekillendiriciyi hemen yok etmek için close() yöntemini çağırabilirsiniz. Sistem, şekillendiriciyi yaklaşık 20 ms içinde ses ardışık düzeninden kaldırır. Ses çalınırken VolumeShaper kapatılırken dikkatli olunmalıdır. close() yöntemini çağırdığınızda şekillendiricinin ses düzeyi 1,0'dan düşükse şekillendiricinin ses düzeyi ölçeği 1,0 olarak değişir. Bu durum, ses seviyesinde ani bir artışa neden olabilir.