python-audio-autotest-3.10 1.6.8rc0

This is a auto-testing framework of audio functions for Android devices.

AudioAutoTest

Description

This is a auto-testing framework of audio functions for Android devices.

• For checking the detailed information of APIs, please refer to the documentation

Release Note

v1.6.x

v1.6.8

• update audioworker.py to handle speakerphone and Bluetooth SCO correctly.

v1.6.7

• update 81dbb67-python-audio-autotest-v1.6.7
  • fix audioTrack not releasing resources issue
  • add tool to bump the version

v1.6.6

• update audioworker.apk (0bd38c6-python-audio-autotest-v1.6.6)
  • add enable-ns and enable-aec in recording

v1.6.5

• Fix version name in __init__py.

v1.6.4

• Update audioworker.apk (4329037-python-audio-autotest-v1.6.4)
  • audioworker: Add haptic playback and multi-channel amplitude support
    • Added a haptic-playback parameter to enable haptic feedback synchronized with audio playback. This required adding the VIBRATE permission and configuring the correct AudioAttributes.
    • The amplitude parameter now accepts a comma-separated string of floats, allowing for individual amplitude control for each channel in a multi-channel setup.
    • Expanded audio channel support up to 8 channels.
    • Added support for .ogg file playback.
    • Removed the deprecated stream-type attribute in favor of usage and content-type for modern Android versions.
• Update audioworker.py to support new featuers and deprecate unsupported options

v1.6.3

• Relax dependency constraints for modern Python versions.

v1.6.2

• Update audioworker.apk (79cab8a-python-audio-autotest-v1.6.2)
  • Enable background audio and fix startup crash

v1.6.1

• Update audioworker.apk (e15de78-python-audio-autotest-v1.6.1)
  • fix: Correct channel mask selection for AudioFormat

v1.6

• Update audioworker.apk (47d7dac-python-audio-autotest-v1.6)
  • Style: Apply AOSP Java code style
  • audioworker: Comply with Scoped Storage and add audio features
  • chore: Upgrade Gradle and AGP to 8.13
• Dynamically read APK version instead of using a hardcoded value.
• Grant MANAGE_EXTERNAL_STORAGE permission for modern Android.
• Improve robustness of on-device timestamp parsing.
• style: Add pyink configuration and format python files.

v1.5

v1.5.11

• Update audioworker.apk (bc49bba-python-audio-autotest-v1.5.11)
• audioworker: playback: support content_type, usage, and performance_mode

v1.5.10

• Fix Adb.get_devices() in case when adb didn't work well by retrying.

v1.5.9

• Update audioworker.apk (068bd43-python-audio-autotest-v1.5.9)
• audioworker: voip: support customized file for VoIP downlink

v1.5.8

• Update audioworker.apk (47311b4-python-audio-autotest-v1.5.8)
• Add stream_type support and ble support

v1.5.7

• Update audioworker.apk (6d15fe8-python-audio-autotest-v1.5.7)
• Add support to seek during the playback

v1.5.6

• Update the version of scikit-learn for the compatibility of Python 3.11.4

v1.5.5

• Fix the crash when calling Adb.disable_wifi_adb after Adb.is_wifi_adb_supported

v1.5.4

• Add timeout support for Adb APIs.

v1.5.3

• Update audioworker.apk (c66b90f-python-audio-autotest-v1.5.3)
• Add btsco_on option in record_start
• Add file option in playback_nonoffload

v1.5.2

• Update audioworker.apk (ecf0145-python-audio-autotest-v1.5.2)
• Update setup.py to compact Python3.10

v1.5.1

• Update audioworker.apk (44f0c2c66-python-audio-autotest-v1.5.1)
• PlaybackStartFunction supports file playing in offload types (.mp3, .aac)
• Playback and capture support more sampling rates and channels
• Update audioworker_test.py
• Fix versions of dependencies to avoid them from breaking in future releases
• Add get_apk_version in AppInterface
• Add get_version_from_device in AudioWorkerApp

v1.5

• Update audioworker.apk (4ca8a47-python-audio-autotest-v1.5)
• AudioWorker supports concurrent capture
• PyAAT supports concurrent capture control on AudioWorker
• Some coding style reformation on audioworker.py
• Add test scripts to verify the compatibility between AudioWorker and PyAAT
  • Playback
  • Record

v1.4

v1.4.3

• Update audioworker.apk

v1.4.2

• AudioWorker supports different input sources, APIs, and performance modes

v1.4.1 (Deleted)

• fix crashes in Adb.safe_clean_non_default_sockets()

v1.4.0 (Deleted)

• support using an independent socket to manage wifi adb devices
• keep the identical behavior when the adb multi-socket listening is disabled

v1.3

v1.3.6

• pyaatlibs: adb: fix line length
• pyaatlibs: adbutils: use "cmd wifi status" instead of "ip addr show wlan0" to check wifi status
• pyaatlibs: adbutils: suppress logs if tolog is false

v1.3.5 (Deleted)

• support using an independent socket to manage wifi adb devices

v1.3.4

• update audioworker.apk: configurable input source for recording

v1.3.3

• add API to get the IP addr used by Wifi adb.

v1.3.2

• fix the logic of whether it's feasible to use wifi adb

v1.3.1

• add delay between "adb tcpip" and "adb connect"

v1.3.0

• support wifi adb

v1.2

v1.2.12

• fix the memory leakage of repeatedly initialization with the same name.

v1.2.11

• store the running threads instead of directly using the iterator to avoid exceptions.

v1.2.10

• make logger always print messages with default settings.

v1.2.8

• fix granting permissions for Android apps.

v1.2.7

• update audioworker to solve recording underrun.

v1.2.5

• simplify AudioWorkerApp.voip_tx_dump

v1.2.1

• change log tag with verbosity level of pyaat.logger
• correct README

v1.2.0

• add verbosity level control of pyaatlibs.logger
• add wait_for_device API of pyaatlibs.adbutils

Installation

Requirements

• pip
• Python 3.7+
• virtualenv

Create a virtual environment

{WORK_DIR}$ mkdir venv
{WORK_DIR}$ virtualenv -p python3 venv/py3
Running virtualenv with interpreter /usr/bin/python3
New python executable in {WORK_DIR}/venv/py3/bin/python
Also creating executable in {WORK_DIR}/venv/py3/bin/python
Installing setuptools, pip, wheel...done.
{WORK_DIR}$ source venv/py3/bin/activate
(py3) {WORK_DIR}$

The dependencies should be installed with a command

(py3) {WORK_DIR}$ pip install -r requirements-py3.txt