Audio Validation (FR)

mobile:audio:validation

Purpose

Validates audio input for MOS quality (WAV audio files only). The command receives an audio file that may have been recorded from a device and uses parameters to trim off any silence from the beginning or end of the audio. Using this trimmed file, it then executes an analysis service.

Important: This functionality is part of the Advanced Audio Package, a separate license that provides access to tools for testing a device's audio quality. For more information, contact your Perfecto account representative.

Parameters

Name	Values	Default	Description
deviceAudio^*			The URL to the audio file of the device (as, for example, returned by the start audio recording function).
key			The repository key of an audio file.
threshold		3.0	The minimal required MOS threshold. Default value is 3.0.
profile	voip (VOIP) basic (Basic) volte (VOLTE) voip_rms (VOIP RMS)	VOIP	The type of analyzed voice. The default profile is VOIP. The VOLTE profile can be used when the audio was recorded from an LTE connection.
deviceAudio.silenceTrimming.type	absolute (Absolute) relative (Relative)		parameter to control trimming silence from the device audio file. Possible values are absolute and relative. Absolute means that any signal level below the specified level is considered as silence. Relative means that any signal level below the relative threshold is considered as silence.
deviceAudio.silenceTrimming.level			parameter to control trimming silence from the device audio file. The level parameter is set in dB and varies from 0.0 up to 120.0.
deviceAudio.calibration			URL to an audio file recorded while the device is silent, i.e. without any audio. This file is used to calibrate the system by eliminating background noise.
generic			A generic audio parameter. Use this to provide additional audio specifications not exposed by other function parameters. Example: "pvqa.Click-00.IntThresh=0.1" It is possible to provide multiple specifications.

^* Mandatory parameter

Return Value

None

Exceptions

None

Examples

Copy

Java sample

Map<String, Object> params3 = new HashMap<>();
params3.put("deviceAudio", "URL");
params3.put("key", "PUBLIC:File.WAV");
params3.put("threshold", "3.0");
params3.put("profile", "voip");
params3.put("deviceAudio.silenceTrimming.type", "absolute");
params3.put("deviceAudio.silenceTrimming.level", "0");
params3.put("deviceAudio.calibration", "");
List<String> genericOptions3 = new ArrayList<>();
genericOptions3.add("");
params3.put("generic", genericOptions3);
Object result3 = driver.executeScript("mobile:audio:validation", params3);