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

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

Każdy mechanizm umożliwia odtwarzanie dźwięku w Androidzie. W przypadku odtwarzania radia lub odtwarzania z urządzeń wejściowych te opcje mogą nie wystarczyć, ale można je połączyć z przechwyceniem dźwięku lub klasą MediaRecorder, aby najpierw przechwycić dźwięk, a następnie odtworzyć go na urządzeniu z Androidem. W przypadku aplikacji systemowych te informacje mogą służyć do połączenia urządzenia wejściowego 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 audio między urządzeniami lub sprzętowego przekierowywania dźwięku na urządzeniu z Androidem mogą wystąpić pewne ograniczenia. Żadna z tych opcji nie może odbierać zdarzeń związanych z klawiszami multimedialnymi, takich jak ODTWARZ, WZNAJ PAUZĘZATWIERDZ. Ponieważ omijają one pakiet audio Androida, każda z nich wymaga sprzętu, aby zmiksować wtyczkę z innymi dźwiękami z Androida.

Używanie HwAudioSource

HwAudioSource to nowy typ odtwarzacza zaprojektowany jako poprawka oprogramowania. Dzięki temu aplikacje korzystające z tego odtwarzacza mogą otrzymywać kluczowe zdarzenia dotyczące multimediów, a wyjście może być miksowane i przekierowywane 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 interfejsie HAL dźwięku

W przypadku tego nowego odtwarzacza weź pod uwagę te oczekiwania dotyczące HAL dźwięku. Na przykład: device/generic/car/emulator/audio/driver/audio_hw.c.

  • adev_create_audio_patch oczekuje, że żądanie utworzy ścieżkę audio z urządzenia do miksera.

  • Parametr adev_open_input_stream wymaga, aby wartość audio_source była równa AUDIO_SOURCE_FM_TUNER.

  • in_read wypełnia bufor audio danymi z radia.

Zalecamy skonfigurowanie urządzenia z tunerem o typie AUDIO_DEVICE_IN_FM_TUNER w urządzeniu 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ć znalezienie urządzenia wejściowego radia FM, używając AudioManager.getDevices(AudioManager.GET_DEVICES_INPUTS w połączeniu z AudioDeviceInfo.TYPE_FM_TUNER.

Tworzenie poprawek audio

Możesz utworzyć przełączanie dźwięku między dwoma portami audio, czyli portem miksowania lub portem urządzenia. Zwykle ścieżka audio z portu mix do portu urządzenia służy do odtwarzania, a w odwrotnym kierunku – do nagrywania.

Na przykład łatka audio, która kieruje próbki dźwięku ze źródła FM_TUNER bezpośrednio do odbiornika multimediów, pomija mikser oprogramowania. Następnie musisz użyć miksera sprzętowego, aby zmiksować próbki dźwięku z Androida i FM_TUNER dla sinka. Podczas tworzenia łatki audio bezpośrednio z 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 FM_TUNER.

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

W przypadku wdrożeń w samochodach może być też konieczne utworzenie łącznika audio między 2 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 mix 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

Za pomocą polecenia getExternalSources() możesz pobrać listę dostępnych źródeł (identyfikowanych według adresu), a potem utworzyć połączenia audio między tymi źródłami a portami odbiorczym na podstawie zastosowań audio. Odpowiednie punkty wejścia w Audio HAL 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życie HwAudioSource, ponieważ umożliwia ona tworzenie poprawek oraz sesji multimedialnej do obsługi zdarzeń związanych z kluczami multimedialnymi. Dla tego samego źródła i tych samych atrybutów dźwięku można utworzyć wiele źródeł dźwięku. Możesz mieć jeden profil do zwykłego słuchania radia i drugi do słuchania komunikatów drogowych.

W Androidzie 11 uprawnienia do nagrywania FM_TUNER zostały zmienione na android.permission.CAPTURE_AUDIO_OUTPUT. Nie przechodzi już przez proces weryfikacji uprawnień OP_RECORD_AUDIO, który dotyczy tylko mikrofonów. Nie powinno to mieć wpływu na aplikacje, ponieważ FM_TUNER wymaga już uprawnienia SYSTEM_API.

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