Legacy | Audio validation

  • Command: audio

  • Subcommand: validation

  • Supported Platforms: Native (legacy), UFT (legacy), Selenium, Appium

    All commands must be executed using the same framework. Sharing the execution ID between different frameworks is not possible. This means that if you work with a Selenium/Appium driver, you need to call the commands using the Selenium/Appium driver (or, in the case of Reporting commands, through the Reporting SDK that works with the driver) and not as part of a UFT test or another framework.

  • Supported OS: Android, iOS

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 Perfecto Support.

Parameters

Name Value Default Description
deviceAudio*     The device for this command.
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 that controls 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 that controls 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, that is 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. For example: "pvqa.Click-00.IntThresh=0.1"

It is possible to provide multiple specifications.
       

* Mandatory parameter

Request & Response

Copy

Request

https://mycloud.perfectomobile.com/services/executions/john@perfectomobile.com_controller_16-11-10_12_43_16_28?operation=command&securityToken=<your_token>&command=audio&subcommand=validation&param.repositoryFile=PUBLIC:SampleAudio_0.7mb.wav
Copy

JSON response

 Pass:true, 
 mos: 3.584615, 
 intervals: [
    [AudioQualityInterval:
        Impairments:[
            [AudioQualityImpairment: 
                Detector:DeadAir01,
                Probability:0.088235]], 
    Average:0.0, 
    Quality:OK, 
    Start:0.0, 
    End:0.0],
    [AudioQualityInterval: ...]], Average:0.0, Quality:OK, Start:0.0,
End:0.0], ...]
Note:

The main field of the response is the mos score assigned to the audio recording.