This app is used for the testing of sports pitches by recording the sound of a ball falling from 2 meters high and bouncing twice. The main functionality of the app is to conduct a test of how a certain pitch performs. The pitch is tested at 6 different locations, with 5 drops being conducted at each location. Additional functionality includes calibrating the ball used for the test, exporting the results of the test to a CSV or PDF file and using Bluetooth to operate the drop equipment.
This software uses code of FFmpeg licensed under the LGPLv2.1 and its source can be downloaded here
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
To build the project, the Android SDK and an installation of the Java JDK is required. Only instructions for setting up the SDK are included. The recommended way is to install Android Studio which will install the SDK for you and allows you to open and build the project
Java JDK installation is required.
For building on the command line, the Android SDK is required. Scroll down the page to find command line only tools and download the appropriate file for your system. Extract the file to a destination of your choice. Next follow the instructions for your system
- Right-click on ‘My Computer’ and select Properties. Go to Advanced system settings and select ‘Environmental Variables’ option.
- Under the User Variable table, click New to open New User Variable dialog.
- Put ANDROID_HOME as Variable name and provide the path of the SDK folder next to Variable value.
- Click OK to close the dialog box
- Go to the folder where SDK has been installed.
- Inside the SDK folder look for ‘tools’ and ‘platform-tools’ folder.
- Copy the path for both tools and platform-tools.
- Open ‘Environmental Variables’ dialog box.
- Go to System Variables table and locate the Path variable.
- Edit the path variable from ‘Edit system Variables’ dialog box.
- Add the ‘tools’ and platform-tools’ folder’s full path
Open the file .bash_profile in your home directory and add the following lines, replacing the path with the path where you extracted the folder
export PATH="path/to/Android/tools:$PATH"
export PATH="$path/to/Android/platform-tools:$PATH"
export ANDROID_HOME="$path/to/Android"
Save the file and reboot your computer
Open the file .bashrc in your home directory and add the following lines, replacing the path with the path where you extracted the folder
export PATH="path/to/Android/tools:$PATH"
export PATH="path/to/Android/platform-tools:$PATH"
export ANDROID_HOME="path/to/Android"
To build the project, run the commands below, but git is required. Otherwise you can download the source code manually from the repository and extract to your home directory and follow from the second command. The built APK files will be within the app/build/outputs/apk directory.
git clone http://stgit.dcs.gla.ac.uk/tp3-2018-cs23/codebase.git
cd codebase/SoundRecord
./gradlew build
git clone http://stgit.dcs.gla.ac.uk/tp3-2018-cs23/codebase.git
cd codebase/SoundRecord
gradlew.bat build
If the last command does not work, check that you have permissions to execute the correct file.
The built APK can then be copied to an Android device and installed by navigating to it using a file manager and running it.
- Artem Usov
- Olga Jodelka
- Conall Clements
- Kara Newlands
See also the list of contributors for contact details
This project is licensed under the GNU General Public License version 3 - see the LICENSE.md file for details.
This project uses FFmpeg which we do not own but can be found at FFmpeg and its source can be downloaded here
- TarsosDSP library
- Joren Six and Olmo Cornelis and Marc Leman
- TarsosDSP, a Real-Time Audio Processing Framework in Java
- Proceedings of the 53rd AES Conference (AES 53rd), 2014
- Nicola Corso
- [SportLabs](https://www.sportslabs.co.uk
- iText (https://itextpdf.com)
- PDF, A PDF Toolkit for PDF generation, PDF programming, handling & manipulation.