Disable BT audio devices for Element Call on Android < 12

[jmartinesp]

Content

• Disable audio devices on Android devices with an OS version < 12 - using some legacy audio APIs.
• When this happens, mute the audio from the call, display a dialog and unmute the call once a different audio device is selected.
• Also add a workaround for an issue where some devices weren't able to easily leave the call after hanging up.

Motivation and context

After trying several strategies to make BT audio devices play nice with the embedded Element Call instance on Android versions using the legacy audio APIs - Android 11 and lower - and it failing in several ways - wrong audio device being used when switching, audio just dying until the app is force closed or the app crashing with a native OS error and no stacktrace - we had to make a difficult decision of preventing using these devices at all.

This change makes it so when selecting a BT audio device or when it's selected by default by the OS, we notify the user about the device not being usable, and mute the audio to prevent it from being streamed through some other audio device. Once a new device is selected, the audio is enabled again and that device can be used normally.

Screenshots / GIFs

Tests

With an Android device using Android 11 or lower:

• Open a call with a BT audio device connected. You should see the error dialog and be able to switch to another device and have the audio working properly with those.
• When selecting the BT audio device again you should see the same result.
• Everything else related to audio in calls should still work as before.

Tested devices

• Physical
• Emulator
• OS version(s): 10

Checklist

• Changes have been tested on an Android device or Android emulator with API 24
• UI change has been tested on both light and dark themes
• Accessibility has been taken into account. See https://github.com/element-hq/element-x-android/blob/develop/CONTRIBUTING.md#accessibility
• Pull request is based on the develop branch
• Pull request title will be used in the release note, it clearly define what will change for the user
• Pull request includes screenshots or videos if containing UI changes
• You've made a self review of your PR

[github-actions]

📱 Scan the QR code below to install the build (arm64 only) for this PR.

If you can't scan the QR code you can install the build via this link: https://i.diawi.com/tp2WNt

[jmartinesp]

This is replaced by the actual string in a following commit.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[codecov]

Codecov Report

Attention: Patch coverage is 38.23529% with 21 lines in your changes missing coverage. Please review.

Project coverage is 80.25%. Comparing base (148b3d9) to head (58fda70).
Report is 9 commits behind head on develop.

Files with missing lines	Patch %	Lines
...id/features/call/impl/utils/WebViewAudioManager.kt	16.66%	14 Missing and 1 partial ⚠️
...nt/android/features/call/impl/ui/CallScreenView.kt	66.66%	5 Missing ⚠️
...droid/features/call/impl/ui/CallScreenPresenter.kt	0.00%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #4876      +/-   ##
===========================================
- Coverage    80.27%   80.25%   -0.02%     
===========================================
  Files         2140     2140              
  Lines        56909    56938      +29     
  Branches      7164     7168       +4     
===========================================
+ Hits         45686    45698      +12     
- Misses        8789     8805      +16     
- Partials      2434     2435       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[bmarty]

Thanks. LGTM.

Sadly I'll have to update again #4863, but that's my fault, it's still a draft PR.