เอฟเฟ็กต์เสียง

ตั้งแต่ Android 11 เป็นต้นไป ผู้ผลิตอุปกรณ์จะสามารถแนบและเปิดใช้เอฟเฟกต์เสียงที่เฉพาะเจาะจงโดยอัตโนมัติเมื่อเลือกอุปกรณ์เสียงหนึ่งๆ สำหรับการบันทึกหรือเล่นเสียง การปรับปรุงที่สำคัญอย่างหนึ่งคือเอฟเฟกต์เสียงที่แทรกในเส้นทางเสียงที่ติดตั้งใช้งานทั้งหมดใต้ HAL เสียง (การเชื่อมต่อโดยตรงระหว่างอุปกรณ์อินพุตและอุปกรณ์เอาต์พุต) จะควบคุมได้โดยเฟรมเวิร์กเอฟเฟกต์เสียง

ฟีเจอร์นี้มีไว้สำหรับ OEM ยานยนต์เป็นหลัก แต่สามารถใช้กับรูปแบบอื่นๆ ของ Android ได้เช่นกัน ตัวอย่างแอปคือการแทรกเอฟเฟกต์การปรับปรุงเสียงในเอาต์พุตของจูนเนอร์ FM เมื่อเชื่อมต่อกับลำโพงโดยตรงผ่าน DSP เสียง

สิ่งที่ต้องมีก่อน

  • สำหรับเอฟเฟกต์เสียงอื่นๆ เอฟเฟกต์ดังกล่าวจะต้องใช้งานโดยไลบรารีของผู้ให้บริการและระบุไว้ในรายการ ในไฟล์การกำหนดค่า audio_effects.xml
  • เอฟเฟกต์ต้องเป็นประเภทการประมวลผลล่วงหน้าหรือประมวลผลภายหลัง (แจ้งว่า TYPE_PRE_PROC หรือ TYPE_POST_PROC ไม่เหมาะสม ที่ตั้งไว้ใน EffectDescriptor.flags)
  • หากการใช้เอฟเฟกต์เป็นแบบเร่งความเร็ว (ตั้งค่า Flag HW_ACC_TUNNEL ใน EffectDescriptor.flags) จึงสามารถเชื่อมต่อกับเส้นทางเสียงที่เชื่อมต่ออยู่ด้านล่าง HAL โดยสมบูรณ์ (ไม่สามารถเล่น หรือบันทึกสตรีมเสียงที่เปิดที่ HAL เสียง)

สร้างและเปิดใช้เอฟเฟกต์อุปกรณ์

คุณสามารถสร้างอินสแตนซ์เอฟเฟกต์เสียงสำหรับอุปกรณ์โดยเฉพาะได้โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

ใช้ไฟล์การกำหนดค่าเอฟเฟกต์เสียง

วิธีนี้ช่วยให้สร้างเอฟเฟกต์เสียงแบบคงที่ซึ่งแนบมาอย่างเป็นระบบและเปิดใช้กับเส้นทางเสียงที่เลือกอุปกรณ์ที่ระบุเป็นปลายทางหรือแหล่งที่มาได้

ซึ่งทำได้ด้วยการเพิ่มหัวข้อที่เฉพาะเจาะจงใน audio_effects.xml ดังนี้ 

<deviceEffects>
<devicePort type="AUDIO_DEVICE_IN_BUILTIN_MIC" address="bottom">
      	<apply effect="agc"/>
      </devicePort>
  </deviceEffects>

ใช้ API ระบบ

มีการเพิ่มตัวสร้าง @SystemApi ใหม่ใน วิธีสร้างและเปิดใช้เอฟเฟกต์อุปกรณ์ android.media.audiofx.AudioEffect 

AudioEffect(@NonNull UUID uuid, @NonNull AudioDeviceAttributes device);

หลังจากสร้างเอฟเฟกต์โดยระบุรหัสเอฟเฟกต์เสียงที่ไม่ซ้ำกันและข้อบ่งชี้อุปกรณ์เสียง เปิดหรือปิดใช้ได้ด้วย API ของ AudioEffect ที่มีอยู่

นอกจากนี้ คุณยังใช้ API เพื่อสอบถามได้ว่าการติดตั้งใช้งานรองรับชุดค่าผสมอุปกรณ์/เอฟเฟกต์ใดหรือไม่ 

static boolean isEffectSupportedForDevice(
            @NonNull UUID uuid, @NonNull AudioDeviceAttributes device);

HAL API ใหม่

HAL สำหรับเอฟเฟกต์เสียง

เอฟเฟกต์เสียง HAL V6.0 มีลายเซ็นใหม่สำหรับเมธอด createEffect() อนุญาตให้สร้างเอฟเฟกต์ที่แนบมากับอุปกรณ์ได้ 

IEffectFactory::createEffect(Uuid uid, AudioSession session,
AudioIoHandle ioHandle, AudioPortHandle device)
  • AudioSession ที่ระบุต้องเป็น AudioSessionConsts.DEVICE
  • ระบบจะละเว้น AudioIoHandle หาก session มีค่าเป็น AudioSessionConsts.DEVICE
  • device จะระบุด้วย AudioPortHandle ที่ไม่ซ้ำกันซึ่งเฟรมเวิร์กเสียงกำหนดเมื่อเลือกอุปกรณ์ที่ HAL เสียงด้วยเมธอด IDevice::createAudioPatch()

HAL เสียง

หากต้องการรองรับฟีเจอร์เอฟเฟกต์ของอุปกรณ์ HAL เสียงต้องใช้การควบคุมการกำหนดเส้นทางเสียงโดยใช้ IDevice::createAudioPatch() API ซึ่งจะระบุโดย IDevice::supportsAudioPatches() การรายงานวิธีการ true

เมธอด API ใหม่ 2 รายการ ได้แก่ IDevice::addDeviceEffect(AudioPortHandle device, uint64_t effectId) และ IDevice::removeDeviceEffect(AudioPortHandle device, uint64_t effectId) จะบอกการใช้งาน HAL ว่าเปิดหรือปิดใช้เอฟเฟกต์ของอุปกรณ์ในอุปกรณ์หนึ่งๆ แล้ว

อุปกรณ์จะระบุด้วยรหัส AudioPortHandle ซึ่งใช้เมื่อเสียง สร้างแพตช์โดยใช้เมธอด IDevice::createAudioPatch()

การใช้งาน API เสียง HAL สามารถใช้ หากต้องมีการประสานงานระหว่าง HAL ของเสียงและเอฟเฟกต์เมื่อเปิดหรือปิดใช้เอฟเฟกต์