เชื่อมต่ออุปกรณ์อินพุตใน AAOS

คุณใช้กลไกเหล่านี้เพื่อเล่นเสียงใน Android ได้

กลไกแต่ละอย่างช่วยให้เล่นเสียงใน Android ได้ สําหรับการเล่นวิทยุหรือการเล่นจากอุปกรณ์อินพุต ตัวเลือกเหล่านี้อาจไม่เพียงพอ แม้ว่าแต่ละตัวเลือกจะจับคู่กับการเก็บเสียงหรือคลาส MediaRecorder ได้เพื่อบันทึกเสียงก่อนแล้วเล่นจาก Android สำหรับแอประบบโดยเฉพาะ คุณสามารถใช้ข้อมูลต่อไปนี้เพื่อเชื่อมต่ออุปกรณ์อินพุตกับมิกเซอร์เอาต์พุตใน AAOS

โปรแกรมเล่น HwAudioSource

HwAudioSource เชื่อมต่ออุปกรณ์แหล่งที่มาของเสียงกับมิกเซอร์ Android โดยตรง

แรงจูงใจ

อาจมีข้อจำกัดหลายประการเมื่อใช้การต่ออุปกรณ์ต่ออุปกรณ์หรือการต่อเชื่อมเสียงผ่านฮาร์ดแวร์กับ Android ตัวเลือกแต่ละรายการไม่สามารถรับเหตุการณ์ของแป้นสื่อ เช่น เล่น หยุดชั่วคราว และหยุด และเนื่องจากตัวเลือกเหล่านี้หลีกเลี่ยงการผสมเสียงของ Android แต่ละตัวเลือกจึงต้องใช้ฮาร์ดแวร์เพื่อผสมแพตช์เข้ากับเสียงอื่นๆ จาก Android

ใช้ HwAudioSource

HwAudioSource เป็นโปรแกรมเล่นประเภทใหม่ที่ออกแบบมาในรูปแบบแพตช์ซอฟต์แวร์ ซึ่งจะช่วยให้แอปที่ใช้โปรแกรมเล่นนี้รับเหตุการณ์สําคัญของสื่อและ Android สามารถผสมและกำหนดเส้นทางสตรีมเอาต์พุตได้

mHwAudioSource = new HwAudioSource.Builder()
                .setAudioDeviceInfo(AudioDeviceInfo: info)
                .setAudioAttributes(new AudioAttributes.Builder()
                        .setUsage(AudioAttributes.USAGE_MEDIA)
                        .build())
                .build();
mHwAudioSource.play();
mHwAudioSource.stop();

การเปลี่ยนแปลง HAL เสียง

เมื่อใช้โปรแกรมเล่นใหม่นี้ ให้พิจารณาถึงสิ่งที่คาดหวังต่อไปนี้สำหรับ HAL เสียง เช่น device/generic/car/emulator/audio/driver/audio_hw.c

  • adev_create_audio_patch คาดว่าคําขอจะสร้างการต่อสายสัญญาณเสียงจากอุปกรณ์ไปยังมิกเซอร์

  • adev_open_input_stream คาดว่า audio_source จะเท่ากับ AUDIO_SOURCE_FM_TUNER

  • in_read จะเติมข้อมูลเสียงวิทยุออกอากาศลงในบัฟเฟอร์เสียง

เราขอแนะนำให้คุณกำหนดค่าอุปกรณ์จูนเนอร์ประเภท AUDIO_DEVICE_IN_FM_TUNER ใน audio_policy_configuration.xml ดังนี้

<devicePort
    tagName="Tuner_source"
    type="AUDIO_DEVICE_IN_FM_TUNER"
    role="source"
    address="tuner0">
    <profile
        name=""
        format="AUDIO_FORMAT_PCM_16_BIT"
        samplingRates="48000"
        channelMasks="AUDIO_CHANNEL_IN_STEREO"/>
</devicePort>

การกําหนดค่าอุปกรณ์นี้ช่วยให้คุณค้นหาอุปกรณ์อินพุตวิทยุ FM ได้ง่ายขึ้นโดยใช้ AudioManager.getDevices(AudioManager.GET_DEVICES_INPUTS ร่วมกับ AudioDeviceInfo.TYPE_FM_TUNER

สร้างแพตช์เสียง

คุณสามารถสร้างการต่อสายสัญญาณเสียงระหว่างพอร์ตเสียง 2 พอร์ต ซึ่งอาจเป็นพอร์ตมิกซ์หรือพอร์ตอุปกรณ์ก็ได้ โดยทั่วไปแล้ว การต่อสายแพทช์เสียงจากพอร์ตมิกซ์ไปยังพอร์ตอุปกรณ์มีไว้สำหรับการเล่น ขณะที่การต่อสายย้อนกลับมีไว้สำหรับการบันทึก

เช่น แพตช์เสียงที่กำหนดเส้นทางตัวอย่างเสียงจากFM_TUNERแหล่งที่มา ไปยังสื่อที่รับโดยตรงจะข้ามมิกเซอร์ซอฟต์แวร์ จากนั้นคุณต้องใช้ตัวผสมสัญญาณฮาร์ดแวร์เพื่อมิกซ์ตัวอย่างเสียงจาก Android และ FM_TUNER สำหรับซิงค์ เมื่อสร้างแพตช์เสียงจากแหล่งที่มา FM_TUNER ไปยังสื่อโดยตรง การดำเนินการจะมีลักษณะดังนี้

  • การควบคุมระดับเสียงจะมีผลกับ Media Sink และควรส่งผลต่อทั้งเสียงของ Android และ FM_TUNER

  • ผู้ใช้สามารถสลับระหว่างเสียงของ Android กับ FM_TUNER ผ่านสวิตช์แอปง่ายๆ (ไม่ต้องเลือกแหล่งที่มาของสื่ออย่างชัดเจน)

การติดตั้งใช้งานยานยนต์อาจต้องสร้างการต่อสายสัญญาณเสียงระหว่างพอร์ตอุปกรณ์ 2 พอร์ตด้วย โดยคุณต้องประกาศพอร์ตของอุปกรณ์และเส้นทางที่เป็นไปได้ใน audio_policy_configuration.xml ก่อน แล้วจึงเชื่อมโยงพอร์ตมิกซ์กับพอร์ตของอุปกรณ์

ตัวอย่างการกําหนดค่า

ดูตัวอย่างการกําหนดค่านี้ device/generic/car/emulator/audio/audio_policy_configuration.xml

<audioPolicyConfiguration>
    <modules>
        <module name="primary" halVersion="3.0">
            <attachedDevices>
                <item>bus0_media_out</item>
                <item>bus1_audio_patch_test_in</item>
            </attachedDevices>
            <mixPorts>
                <mixPort name="mixport_bus0_media_out" role="source"
                        flags="AUDIO_OUTPUT_FLAG_PRIMARY">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                            samplingRates="48000"
                            channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                </mixPort>
                <mixPort name="mixport_audio_patch_in" role="sink">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                           samplingRates="48000"
                           channelMasks="AUDIO_CHANNEL_IN_STEREO"/>
                </mixPort>
            </mixPorts>
            <devicePorts>
                <devicePort tagName="bus0_media_out" role="sink" type="AUDIO_DEVICE_OUT_BUS"
                        address="bus0_media_out">
                    <profile balance="" format="AUDIO_FORMAT_PCM_16_BIT"
                            samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                    <gains>
                        <gain name="" mode="AUDIO_GAIN_MODE_JOINT"
                                minValueMB="-8400" maxValueMB="4000" defaultValueMB="0" stepValueMB="100"/>
                    </gains>
                </devicePort>
                <devicePort tagName="bus1_audio_patch_test_in" type="AUDIO_DEVICE_IN_BUS" role="source"
                        address="bus1_audio_patch_test_in">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                            samplingRates="48000" channelMasks="AUDIO_CHANNEL_IN_STEREO"/>
                    <gains>
                        <gain name="" mode="AUDIO_GAIN_MODE_JOINT"
                                minValueMB="-8400" maxValueMB="4000" defaultValueMB="0" stepValueMB="100"/>
                    </gains>
                </devicePort>
            </devicePorts>
            <routes>
                <route type="mix" sink="bus0_media_out" sources="mixport_bus0_media_out,bus1_audio_patch_test_in"/>
                <route type="mix" sink="mixport_audio_patch_in" sources="bus1_audio_patch_test_in"/>
            </routes>
        </module>
    </modules>
</audioPolicyConfiguration>

API ของโปรแกรมควบคุมเสียง

คุณสามารถใช้ getExternalSources() เพื่อเรียกข้อมูลแหล่งที่มาที่ใช้ได้ (ระบุตามที่อยู่) จากนั้นสร้างการต่อเชื่อมเสียงระหว่างแหล่งที่มาเหล่านี้กับพอร์ตขาออกตามการใช้งานเสียง จุดแรกเข้าที่เกี่ยวข้องใน HAL เสียงจะปรากฏใน IDevice.hal

Interface IDevice {
...
/
*   Creates an audio patch between several source and sink ports.  The handle
*   is allocated by the HAL and must be unique for this audio HAL module.
*
*   @param sources patch sources.
*   @param sinks patch sinks.
*   @return retval operation completion status.
*   @return patch created patch handle.
*/
createAudioPatch(vec<AudioPortConfig> sources, vec<AudioPortConfig> sinks)
       generates (Result retval, AudioPatchHandle patch);

*   Release an audio patch.
*
*   @param patch patch handle.
*   @return retval operation completion status.
*/
releaseAudioPatch(AudioPatchHandle patch) generates (Result retval);
...
}

ตัวรับสัญญาณวิทยุ

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

หากบันทึก FM_TUNER ใน Android 11 ระบบจะเปลี่ยนสิทธิ์ในการบันทึกเป็น android.permission.CAPTURE_AUDIO_OUTPUT โดยจะไม่ผ่านการตรวจสอบสิทธิ์ OP_RECORD_AUDIO อีกต่อไป ซึ่งมีผลกับไมโครโฟนเท่านั้น การดำเนินการนี้จะไม่ส่งผลต่อแอป เนื่องจาก FM_TUNER ต้องใช้สิทธิ์ SYSTEM_API ในการเข้าถึงอยู่แล้ว

ดูรายละเอียดการสร้างแอปวิทยุได้ที่ติดตั้งใช้งานวิทยุ