يمكنك استخدام VolumeShaper في تطبيق صوتي لإجراء
عمليات التلاشي التدريجي للداخل والخارج والتلاشي المتقاطع والتداخل الصوتي وغيرها من عمليات الانتقال
التلقائية القصيرة لمستوى الصوت. تتوفّر فئة VolumeShaper في الإصدار 8.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 26) والإصدارات الأحدث.
يمكنك إنشاء VolumeShaper من خلال استدعاء createVolumeShaper() في مثيل
AudioTrack أو MediaPlayer. لا يعمل VolumeShaper إلا على الصوت الذي ينتجه AudioTrack أو MediaPlayer الذي أنشأه.
VolumeShaper.Configuration
يتم تحديد سلوك VolumeShaper من خلال
VolumeShaper.Configuration. يحدّد الإعداد
*منحنى مستوى الصوت ونوع الاستكمال والمدة.*
منحنى حجم الإحالات الناجحة
يمثّل منحنى مستوى الصوت التغيير في السعة بمرور الوقت. يتم تحديدها من خلال زوج من صفائف الأعداد العشرية، 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_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 يبدأ بمستوى صوت 0
ويزداد تدريجيًا. على سبيل المثال:
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. يؤدي هذا إلى تغيير اتجاه قراءة
نقاط التحكم في كل مرة.
يعدّل المشكِّل مستوى الصوت باستمرار ويمرّ بجميع نقاط التحكّم إلى أن تنتهي صلاحيته. يحدث ذلك عندما يصل المشكِّل إلى نقطة التحكّم الأخيرة (لعملية التشغيل) أو الأولى (لعملية العكس) في المنحنى.
عند انتهاء صلاحية أداة التشكيل، يظل مستوى الصوت عند آخر إعداد، والذي قد يكون
نقطة التحكّم الأولى أو الأخيرة. يمكنك الاتصال بالرقم VolumeShaper.getVolume()
لمعرفة مستوى الصوت الحالي في أي وقت.
بعد انتهاء صلاحية أداة التشكيل، يمكنك إصدار طلب apply() آخر لتشغيل المنحنى
في الاتجاه المعاكس. على سبيل المثال، إذا انتهت صلاحية أداة التشكيل أثناء تشغيل
PLAY، يجب أن يكون apply() التالي هو REVERSE. لن يكون لاستدعاء PLAY بعد انتهاء صلاحية PLAY أو REVERSE بعد انتهاء صلاحية REVERSE أي تأثير.
يجب التبديل بين عمليتَي PLAY وREVERSE. لا توجد طريقة لتشغيل
منحنى من نقاط التحكم الأولى إلى الأخيرة ثم إعادة تشغيله مرة أخرى من
نقطة التحكم الأولى. يمكنك استخدام طريقة replace()، الموضحة في القسم التالي، لاستبدال المنحنى بنسخة منه. يؤدي ذلك إلى إعادة ضبط أداة التشكيل،
ويتطلّب تنفيذ عملية PLAY لبدء تشغيلها مرة أخرى.
تغيير المنحنى
استخدِم طريقة replace() لتغيير منحنى VolumeShaper. تتطلّب هذه الطريقة
إعدادًا وعملية ومَعلمة دمج. يمكنك استدعاء الطريقة 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).
عند استدعاء replace() باستخدام join = false، يبدأ المشكِّل منحناه عند
المستوى المحدّد من خلال نقطة التحكّم الأولى. وقد يؤدي ذلك إلى انقطاع
في مستوى الصوت يمكنك تجنُّب ذلك من خلال الاتصال بالرقم replace() باستخدام join = true.
يؤدي هذا إلى ضبط نقطة التحكم الأولى للمنحنى الجديد على المستوى الحالي
للمشكل ويقيس حجم جميع نقاط التحكم بين الأولى
والأخيرة للحفاظ على الشكل النسبي للمنحنى الجديد (نقطة التحكم الأخيرة
لم تتغير). تؤدي عملية تغيير الحجم إلى تغيير نقاط التحكّم بشكل دائم في
المنحنى الجديد لأداة التشكيل.
إزالة VolumeShaper
يغلق النظام VolumeShaper ويجمع المهملات عند تحرير AudioTrack أو MediaPlayer أو عدم استخدامهما. يمكنك استدعاء طريقة close()
على أداة تشكيل لتدميرها على الفور. يزيل النظام أداة التشكيل من مسار الصوت خلال 20 ملي ثانية تقريبًا. يُرجى توخّي الحذر عند إغلاق VolumeShaper أثناء تشغيل الصوت. إذا كان مستوى صوت أداة التشكيل أقل من 1.0 عند استدعاء
close()، يتغيّر مقياس مستوى صوت أداة التشكيل إلى 1.0. قد يؤدي ذلك إلى زيادة
مفاجئة في مستوى الصوت.