VolumeSizer की मदद से, ऐम्प्लीट्यूड को कंट्रोल करना

किसी ऑडियो ऐप्लिकेशन में VolumeShaper का इस्तेमाल करके, फ़ेड-इन, फ़ेड-आउट, क्रॉस फ़ेड, डकिंग, और आवाज़ में अपने-आप होने वाले अन्य छोटे बदलाव किए जा सकते हैं. VolumeShaper क्लास, Android 8.0 (एपीआई लेवल 26) और इसके बाद के वर्शन में उपलब्ध है.

VolumeShaper बनाने के लिए, AudioTrack या MediaPlayer के इंस्टेंस पर createVolumeShaper() को कॉल करें. VolumeShaper सिर्फ़ उस AudioTrack या MediaPlayer से जनरेट किए गए ऑडियो पर काम करता है जिसने इसे बनाया है.

VolumeShaper.Configuration

VolumeShaper के काम करने का तरीका, उसके VolumeShaper.Configuration से तय होता है. कॉन्फ़िगरेशन में, *वॉल्यूम कर्व, इंटरपोलेटर टाइप, और अवधि* की जानकारी दी जाती है.

वॉल्यूम कर्व

वॉल्यूम कर्व, समय के साथ एंप्लीट्यूड में होने वाले बदलाव को दिखाता है. इसे फ़्लोट ऐरे के एक जोड़े, x[] और y[] से तय किया जाता है. ये कंट्रोल पॉइंट की एक सीरीज़ तय करते हैं. हर (x, y) पेयर, समय और वॉल्यूम को दिखाता है. अरे की लंबाई बराबर होनी चाहिए. साथ ही, इनमें कम से कम दो और ज़्यादा से ज़्यादा 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_RAMP
  • VolumeShaper.Configuration.CUBIC_RAMP
  • VolumeShaper.Configuration.SINE_RAMP
  • VolumeShaper.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 बनाएं जो 0 वॉल्यूम से शुरू हो और धीरे-धीरे तेज़ हो. उदाहरण के लिए:

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) का इस्तेमाल करके, शेपर को बाद में भी चालू किया जा सकता है.

join = false के साथ replace() को कॉल करने पर, शेपर अपने कर्व को पहले कंट्रोल पॉइंट से तय किए गए लेवल पर शुरू करता है. इससे आवाज़ में रुकावट आ सकती है. इससे बचने के लिए, join = true के साथ replace() पर कॉल करें. इससे नए कर्व का पहला कंट्रोल पॉइंट, शेपर के मौजूदा लेवल पर सेट हो जाता है. साथ ही, पहले और आखिरी कंट्रोल पॉइंट के बीच के सभी कंट्रोल पॉइंट का वॉल्यूम स्केल हो जाता है, ताकि नए कर्व का रिलेटिव शेप बना रहे. हालांकि, आखिरी कंट्रोल पॉइंट में कोई बदलाव नहीं होता. स्केलिंग ऑपरेशन, शेपर के नए कर्व में कंट्रोल पॉइंट को हमेशा के लिए बदल देता है.

VolumeShaper को हटाना

सिस्टम, VolumeShaper को बंद कर देता है और गारबेज कलेक्शन करता है. ऐसा तब होता है, जब AudioTrack या MediaPlayer को रिलीज़ कर दिया जाता है या उसका इस्तेमाल नहीं किया जाता. शेपर को तुरंत मिटाने के लिए, उस पर close() मेथड को कॉल किया जा सकता है. सिस्टम, करीब 20 मिलीसेकंड में ऑडियो पाइपलाइन से शेपर को हटा देता है. ऑडियो चलने के दौरान, VolumeShaper को बंद करते समय सावधानी बरतें. अगर close() को कॉल करने पर, शेपर का वॉल्यूम 1.0 से कम है, तो शेपर का वॉल्यूम स्केल बदलकर 1.0 हो जाता है. इससे आवाज़ अचानक बढ़ सकती है.