Audio validation command

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 Type Possible values Description

Device audio URL*

String

 

The URL to the audio file of the device (as, for example, returned by the Start audio recording command).

Reference file key

Media

 

The full repository path, including directory and file name, where to locate the reference file. You can select a file that already resides in the Perfecto repository or select a file from your computer that is then uploaded to the Perfecto repository. To learn more about the Perfecto repository, see Manage the repository. Click the Select media link, browse to the file, and then click SELECT.

Example: Public:2364030/db7575532d124db0b67e476a52e98736.js

MOS threshold

String

 

The minimal required MOS threshold. Default value is 3.0.

Profile

String

VOIP | Basic | VOLTE | VOIP RMS

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.

Device audio silence trimming type

String

Absolute | Relative

Controls trimming silence from the device audio file. 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.

Device audio silence trimming level

Number

 

Controls the trimming silence from the device audio file. The level parameter is set in dB and varies from 0.0 up to 120.0.

Calibration audio URL

String

 

URL to an audio file recorded while the device is silent, that is without any audio. This file is used to calibrate the system by eliminating background noise.

Comment

String

 

Adds a comment to the script

On-fail Result*

Condition

Ignore | Break | Continue | Abort | Catch

The behavior when the command fails.

* Mandatory parameter