Podłączanie urządzenia wejściowego w AAOS

Do odtwarzania dźwięku na Androidzie możesz używać tych mechanizmów:

Każdy mechanizm umożliwia odtwarzanie dźwięku na Androidzie. W przypadku odtwarzania radia lub odtwarzania z urządzeń wejściowych te opcje mogą nie wystarczyć, chociaż każdą z nich można połączyć z przechwytywaniem dźwięku lub klasą MediaRecorder, aby najpierw przechwycić dźwięk, a potem odtworzyć go na Androidzie. W przypadku aplikacji systemowych można użyć tych informacji, aby połączyć urządzenie wejściowe z mikserem wyjściowym w AAOS.

Odtwarzacz HwAudioSource

HwAudioSource – łączy urządzenie będące źródłem dźwięku bezpośrednio z mikserem Androida.

Motywacje

Podczas korzystania z połączenia między urządzeniami lub sprzętowego połączenia audio w Androidzie może wystąpić kilka ograniczeń. Każda z tych opcji nie może odbierać zdarzeń klawiszy multimedialnych, takich jak PLAY, PAUSE i STOP. Ponieważ omijają one stos audio Androida, wymagają sprzętu do miksowania ścieżki z innym dźwiękiem z Androida.

Używanie HwAudioSource

HwAudioSource to nowy rodzaj odtwarzacza zaprojektowany jako poprawka oprogramowania. Dzięki temu aplikacje korzystające z tego odtwarzacza mogą otrzymywać zdarzenia klawiszy multimedialnych, a strumień wyjściowy może być miksowany i kierowany przez Androida.

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

Zmiany w warstwie HAL audio

W przypadku tego nowego odtwarzacza należy wziąć pod uwagę te oczekiwania dotyczące interfejsu HAL audio. Na przykład: device/generic/car/emulator/audio/driver/audio_hw.c.

  • adev_create_audio_patch oczekuje, że żądanie nawiąże połączenie audio z urządzenia do miksera.

  • adev_open_input_stream oczekuje, że audio_source będzie mieć wartość AUDIO_SOURCE_FM_TUNER.

  • in_read wypełnia bufor audio danymi audio z radia.

Zalecamy skonfigurowanie urządzenia z tunerem o typie AUDIO_DEVICE_IN_FM_TUNER w 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>

Dzięki tej konfiguracji urządzenia możesz ułatwić znajdowanie urządzenia wejściowego radia FM za pomocą AudioManager.getDevices(AudioManager.GET_DEVICES_INPUTS w połączeniu z AudioDeviceInfo.TYPE_FM_TUNER.

Tworzenie poprawek audio

Możesz utworzyć połączenie audio między dwoma portami audio, portem miksu lub portem urządzenia. Zwykle ścieżka audio z portu miksera do portu urządzenia służy do odtwarzania, a w przeciwnym kierunku – do nagrywania.

Na przykład ścieżka audio, która kieruje próbki dźwięku z FM_TUNERźródłaFM_TUNER bezpośrednio do odbiornika multimediów, omija mikser oprogramowania. Następnie musisz użyć miksera sprzętowego, aby zmiksować próbki dźwięku z Androida i FM_TUNER na potrzeby odbiornika. Podczas tworzenia poprawki audio bezpośrednio ze FM_TUNER źródła do odbiornika multimediów:

  • Sterowanie głośnością dotyczy odbiornika multimediów i powinno wpływać zarówno na dźwięk z Androida, jak i z FM_TUNER.

  • Użytkownicy mogą przełączać się między Androidem a FM_TUNER dźwiękiem za pomocą prostego przełącznika aplikacji (nie jest wymagany wybór źródła multimediów).

Implementacje w branży motoryzacyjnej mogą też wymagać utworzenia ścieżki audio między dwoma portami urządzenia. Aby to zrobić, musisz najpierw zadeklarować porty urządzenia i możliwe trasy w audio_policy_configuration.xml, a następnie powiązać porty mieszane z portami urządzenia.

Przykładowa konfiguracja

Zobacz tę przykładową konfigurację: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>

Interfejs API sterownika audio

Możesz użyć getExternalSources(), aby pobrać listę dostępnych źródeł (identyfikowanych przez adres), a następnie utworzyć połączenia audio między tymi źródłami a portami wyjściowymi według zastosowań audio. Odpowiednie punkty wejścia w warstwie HAL audio są widoczne w 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);
...
}

Tuner radiowy

Podczas tworzenia aplikacji radiowej zalecamy używanie HwAudioSource, ponieważ obsługuje ona zarówno tworzenie poprawki, jak i sesję multimedialną do obsługi zdarzeń klucza multimedialnego. Dla tego samego źródła i tych samych atrybutów audio można utworzyć wiele źródeł dźwięku. Możesz mieć jeden profil do zwykłego korzystania z radia i drugi do komunikatów drogowych.

Jeśli nagrywasz FM_TUNER, w Androidzie 11 uprawnienia do tego działania zostały zmienione na android.permission.CAPTURE_AUDIO_OUTPUT. Nie przechodzi już OP_RECORD_AUDIOsprawdzania uprawnień, które dotyczy tylko mikrofonów. Nie powinno to mieć wpływu na aplikacje, ponieważ FM_TUNER już wymaga uprawnienia SYSTEM_API do uzyskania dostępu.

Szczegółowe informacje o tworzeniu aplikacji radiowej znajdziesz w artykule Wdrażanie radia.