การควบคุมแอมพลิจูดด้วย VolumeShaper

คุณสามารถใช้ 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]

ประเภทตัวประมาณค่าในช่วง

เส้นโค้งระดับเสียงจะผ่านจุดควบคุมที่ระบุเสมอ ค่าระหว่างจุดควบคุมได้มาจากเส้นโค้งตามประเภทตัวประมาณค่าในช่วงของการกำหนดค่า มีค่าคงที่ 4 ค่าสำหรับประเภท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] จะปรับขนาดเป็นระยะเวลาที่คุณระบุเป็นมิลลิวินาที ซึ่งจะกำหนดความยาวจริงในเวลาของเส้นโค้งระดับเสียงเมื่อ Shaper ทำงานและใช้เส้นโค้งกับเอาต์พุตเสียง

การใช้ 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, ระยะเวลา 1 วินาที และไม่มีเส้นโค้ง คุณต้องเพิ่มเส้นโค้งลงในเครื่องมือสร้างก่อนเรียกใช้ build()

เฟรมเวิร์กมีค่าคงที่สำหรับการกำหนดค่าที่มีเส้นโค้งที่สร้างไว้ล่วงหน้า โดยแต่ละเส้นโค้งจะมีระยะเวลา 1 วินาที ดังนี้

  • 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)

แทร็กหรือมีเดียเพลเยอร์รายการเดียวสามารถมี Shaper แนบอยู่ได้หลายรายการ และคุณสามารถควบคุม Shaper แต่ละรายการแยกกันได้ เอาต์พุตของ Shaper ทั้งหมดในแทร็กหรือเพลเยอร์จะคูณเข้าด้วยกัน VolumeShaper ไม่สามารถแชร์ระหว่าง AudioTracks หรือ MediaPlayers ได้ แต่คุณสามารถใช้การกำหนดค่าเดียวกันในการเรียกใช้ createVolumeShaper เพื่อสร้าง Shaper ที่เหมือนกันใน AudioTracks หรือ MediaPlayers หลายรายการได้

เมื่อสร้าง Shaper ระบบจะใช้จุดควบคุมแรก (ที่ t = 0) กับสตรีมเสียง หากระดับเสียงเริ่มต้นไม่ใช่ 1.0 และแอปกำลังเล่นเนื้อหาในเวลาที่สร้าง เสียงอาจมีการเปลี่ยนแปลงระดับเสียงอย่างกะทันหัน แนวทางปฏิบัติแนะนำคือการเริ่มเล่นเสียงจากความเงียบและใช้ VolumeShaper เพื่อใช้การเฟดเข้าเมื่อเริ่มเล่น สร้างVolumeShaperที่เริ่มจากระดับเสียง 0 แล้วค่อยๆ ดังขึ้น เช่น

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

เริ่มเล่นและเริ่มใช้ Shaper พร้อมกัน ซึ่งจะช่วยให้การเล่นเริ่มจากเสียงเงียบและค่อยๆ เพิ่มระดับเสียงจนเต็ม ซึ่งเราจะอธิบายในส่วนถัดไป

กำลังเรียกใช้ VolumeShaper

แม้ว่าระดับเสียงของจุดควบคุมแรกจะใช้กับเส้นทางเสียงทันทีที่สร้าง Shaper แต่ Shaper จะไม่เคลื่อนไปตามเส้นโค้งจนกว่าคุณจะเรียกใช้เมธอด apply() ด้วย VolumeShaper.Operation.PLAY หลังจากสร้าง Shaper แล้ว การเรียกใช้ apply() ครั้งแรกต้องระบุการดำเนินการ PLAY เพื่อเริ่ม Shaper ซึ่งจะเรียกใช้เส้นโค้งจากจุดควบคุมแรกไปยังจุดควบคุมสุดท้าย ดังนี้

shaper.apply(VolumeShaper.Operation.PLAY)

ขณะที่ Shaper ทำงานอยู่ คุณสามารถส่งการเรียก apply() สลับกันเพื่อระบุการดำเนินการ REVERSE และ PLAY ซึ่งจะเปลี่ยนทิศทางการอ่านค่าของจุดควบคุมในแต่ละครั้ง

Shaper จะปรับระดับเสียงอย่างต่อเนื่องและผ่านจุดควบคุมทั้งหมดจนกว่าจะหมดอายุ ซึ่งจะเกิดขึ้นเมื่อ Shaper ไปถึงจุดควบคุมสุดท้าย (สำหรับการดำเนินการ PLAY) หรือจุดควบคุมแรก (สำหรับการดำเนินการ REVERSE) ในเส้นโค้ง

เมื่อ Shaper หมดอายุ ระดับเสียงจะยังคงอยู่ที่การตั้งค่าล่าสุด ซึ่งอาจเป็นจุดควบคุมแรกหรือจุดควบคุมสุดท้าย คุณเรียกใช้ VolumeShaper.getVolume() เพื่อดูระดับเสียงในปัจจุบันได้ทุกเมื่อ

หลังจาก Shaper หมดอายุ คุณสามารถเรียกใช้ apply() อีกครั้งเพื่อเรียกใช้เส้นโค้งในทิศทางตรงกันข้าม ตัวอย่างเช่น หาก Shaper หมดอายุขณะเรียกใช้ PLAY apply() ถัดไปต้องเป็น REVERSE การเรียก PLAY หลังจาก PLAY หมดอายุ หรือ REVERSE หลังจาก REVERSE หมดอายุจะไม่มีผลใดๆ

คุณต้องสลับการดำเนินการ PLAY และ REVERSE ไม่มีวิธีเล่นเส้นโค้งจากจุดควบคุมแรกไปยังจุดควบคุมสุดท้าย แล้วเริ่มเล่นใหม่จากจุดควบคุมแรก คุณสามารถใช้เมธอด replace() ซึ่งอธิบายไว้ในส่วนถัดไปเพื่อแทนที่เส้นโค้งด้วยสำเนาของเส้นโค้งนั้นเอง การดำเนินการนี้จะรีเซ็ต Shaper ซึ่งต้องใช้การดำเนินการ PLAY เพื่อเริ่มอีกครั้ง

การเปลี่ยนเส้นโค้ง

ใช้เมธอด replace() เพื่อเปลี่ยนเส้นโค้งของ VolumeShaper เมธอดนี้ใช้การกำหนดค่า การดำเนินการ และพารามิเตอร์การรวม คุณสามารถเรียกใช้เมธอด replace() ได้ทุกเมื่อขณะที่ Shaper ทำงานอยู่หรือหลังจากหมดอายุแล้ว

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() ขณะที่ Shaper ทำงานอยู่ Shaper จะหยุดเปลี่ยนระดับเสียงและคงค่าปัจจุบันไว้ จากนั้นผู้สร้างรูปทรงจะพยายามเริ่มเส้นโค้งใหม่จากจุดควบคุมจุดแรก ซึ่งหมายความว่าอาร์กิวเมนต์การดำเนินการจะควบคุมว่าจะเรียกใช้ Shaper หลังจากการเรียกหรือไม่ ระบุ PLAY เพื่อเริ่มเส้นโค้งใหม่ทันที ระบุ REVERSE เพื่อปล่อยให้ Shaper หยุดชั่วคราวที่ระดับเสียงของจุดควบคุมแรกในเส้นโค้งใหม่ คุณเริ่มใช้เครื่องมือปรับแต่งได้ในภายหลังด้วย apply(VolumeShaper.Operation.PLAY)

เมื่อคุณเรียกใช้ replace() ด้วย join = false ตัวปรับรูปร่างจะเริ่มเส้นโค้งที่ระดับที่ระบุโดยจุดควบคุมแรก ซึ่งอาจทำให้ระดับเสียงไม่ต่อเนื่อง คุณหลีกเลี่ยงปัญหานี้ได้โดยโทรหา replace() ด้วย join = true ซึ่งจะตั้งค่าจุดควบคุมแรกของเส้นโค้งใหม่เป็นระดับปัจจุบันของ Shaper และปรับขนาดระดับเสียงของจุดควบคุมทั้งหมดระหว่างจุดแรกและจุดสุดท้ายเพื่อรักษารูปร่างสัมพัทธ์ของเส้นโค้งใหม่ (จุดควบคุมสุดท้ายจะไม่เปลี่ยนแปลง) การปรับขนาดจะเปลี่ยนจุดควบคุมในเส้นโค้งใหม่ของ Shaper อย่างถาวร

การนำ VolumeShaper ออก

ระบบจะปิดและรวบรวมขยะ VolumeShaper เมื่อ AudioTrack หรือ MediaPlayer ถูกปล่อยหรือไม่ได้ใช้งานแล้ว คุณสามารถเรียกใช้เมธอด close() ใน Shaper เพื่อทำลาย Shaper ทันที ระบบจะนำ Shaper ออกจากไปป์ไลน์เสียงภายในเวลาประมาณ 20 มิลลิวินาที โปรดระมัดระวังเมื่อปิด VolumeShaper ขณะที่เสียงกำลังเล่นอยู่ หาก Shaper มีระดับเสียงน้อยกว่า 1.0 เมื่อคุณเรียกใช้ close() ระดับเสียงของ Shaper จะเปลี่ยนเป็น 1.0 ซึ่งอาจทำให้ระดับเสียงเพิ่มขึ้นอย่างกะทันหัน