שליטה במשרעת בעזרת מעצב עוצמת הקול

אפשר להשתמש ב-VolumeShaper באפליקציית אודיו כדי לבצע הגברה הדרגתית, הנמכה הדרגתית, מעבר הדרגתי, הנמכה של עוצמת השמע ומעברים אוטומטיים קצרים אחרים של עוצמת הקול. הכיתה VolumeShaper זמינה ב-Android 8.0 (רמת API‏ 26) ואילך.

כדי ליצור VolumeShaper, צריך להפעיל את createVolumeShaper() במכונה של AudioTrack או MediaPlayer. ה-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].

סוג האינטרפולטור

עקומת עוצמת הקול תמיד עוברת דרך נקודות הבקרה שצוינו. הערכים בין נקודות הבקרה נגזרים על ידי עקומת spline בהתאם לסוג האינטרפולטור של ההגדרה. יש ארבעה קבועים לסוגי האינטרפולטורים הזמינים של 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()

אם לא מזינים ארגומנטים, ה-constructor של VolumeShaper.Configuration.Builder מחזיר builder שיוצר הגדרה עם הגדרות ברירת מחדל: INTERPOLATOR_TYPE_CUBIC, משך זמן של שנייה אחת וללא עקומה. צריך להוסיף עקומה ל-builder לפני שקוראים ל-build().

ה-framework מספק קבועים להגדרות עם עקומות מובנות מראש, כל אחת עם משך של שנייה אחת:

  • 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

למרות שעוצמת הקול של נקודת הבקרה הראשונה מוחלת על נתיב האודיו ברגע שנוצר המעצב, המעצב לא מתקדם לאורך העקומה עד שקוראים ל-method‏ apply() עם VolumeShaper.Operation.PLAY. אחרי שיוצרים את המעצב, בהפעלה הראשונה של apply() צריך לציין את הפעולה PLAY כדי להפעיל את המעצב. הפעולה הזו מריצה את העקומה מנקודת הבקרה הראשונה ועד לנקודת הבקרה האחרונה:

shaper.apply(VolumeShaper.Operation.PLAY)

בזמן שהמעצב פועל, אפשר להנפיק קריאות apply() לסירוגין, ולציין פעולות REVERSE ו-PLAY. הפעולה הזו משנה את כיוון ההקראה של נקודות השליטה בכל פעם.

המעצב מכוונן את עוצמת הקול באופן רציף ועובר דרך כל נקודות הבקרה עד שהוא מגיע לסוף. זה קורה כשהמעצב מגיע לנקודת הבקרה האחרונה (בפעולת PLAY) או הראשונה (בפעולת REVERSE) בעקומה.

כשתוקף המעצב פג, עוצמת הקול נשארת בהגדרה האחרונה, שיכולה להיות נקודת הבקרה הראשונה או האחרונה. אתם יכולים להפעיל את VolumeShaper.getVolume() כדי לשמוע את עוצמת הקול הנוכחית בכל שלב.

אחרי שהמעצב פג תוקף, אפשר להנפיק קריאה נוספת ל-apply() כדי להריץ את העקומה בכיוון ההפוך. לדוגמה, אם תוקף המעצב פג בזמן ההפעלה של PLAY, הפקודה הבאה של apply() חייבת להיות REVERSE. לקריאה ל-PLAY אחרי שפג התוקף של PLAY, או ל-REVERSE אחרי שפג התוקף של REVERSE, אין השפעה.

צריך להחליף בין הפעולות PLAY ו-REVERSE. אי אפשר להפעיל עקומה מנקודת הבקרה הראשונה עד האחרונה, ואז להפעיל אותה מחדש מנקודת הבקרה הראשונה. אפשר להשתמש ב-replace(), שמתואר בקטע הבא, כדי להחליף את העקומה בעותק שלה. הפעולה הזו מאפסת את המעצב, וצריך להפעיל את הפעולה PLAY כדי להפעיל אותו מחדש.

שינוי העקומה

משתמשים ב-method‏ 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. זה עלול לגרום לעלייה פתאומית בעוצמת הקול.