Audio to text validation command

Accepts an audio file that may be recorded from a device and creates a text file that contains the textual translation (transcript) of the audio file. In addition, the command performs a text checkpoint function, checking for the existence of a text string in the translated text file. This function utilizes matching parameters similar to the text checkpoint function.

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

Expected text (needle)*

String

  

Text that should be validated against the generated text file.

Device audio URL

String

  

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

Audio file key

Media

  

The full repository path, including directory and file name, where to locate the audio 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

Target

String

As is | Any | All

The target search in case the needle includes more than one word, where:

  • As is searches for the entire string content as is, as a complete phrase

  • Any searches for any word in the string

  • All searches for all the words and phrases

When selecting Any or All, the words in the Expected text parameter can be divided into phrases with quotation marks.

Example: "new contact" "add contact"

When selecting All, the words and phrases can be located in several places on the screen. This enables multiple text verifications.

Match mode

String

Contain | Equal | Start with | End with | First | Last | Index

The needle comparison method, where: 

  • Contain indicates that the needle is part of the haystack

  • Equal indicates that the needle is equal to the haystack

  • Start with indicates that the haystack text begins with the needle

  • End with indicates that the haystack ends with the needle

  • First searches for the first occurrence of the needle

  • Last searches for the last occurrence of the needle

  • Index indicates a defined occurrence of the needle, used alongside the Index parameter

Index

Number

 

If the needle has multiple occurrences on the screen, specifies the index of the required occurrence

Whole-words search

String

False | True

When set to true, searches only for whole words in the haystack. When set to false, includes also partial words

For example, to define whether 'person' in 'personal' is a good match or not, set this parameter to:

  • True to match whole needle words in the haystack

  • False to match whole or sub-string words in the haystack

Exact phrase

String

  

Enter a phrase to to find the exact needle phrase with no errors.

This parameter is not relevant when using native screen source.

Threshold

Number

  

The acceptable match level percentage, between 20 and 100.

Values that are too low can lead to a false positive result. Values that are too high can lead to a false negative result.

Confidence

Number

  

Indicates the minimal confidence level that the audio to text tool measures for the conversion. If the conversion does not reach this confidence level, the parameter will return a failed status.

Result variable

String

  

The variable to receive the retrieved values.

Language

String

US English | UK English | Spanish | Japanese | French | Chinese | Portuguese | Arabic

The supported audio file languages.

Rate

String

Broad | Narrow

The sampling rate of the audio recording

Profile

String

Performance | Accuracy

The profile of the NLP network

Phrase

String

  

A list of phrases for the speech-to-text library to use to avoid confusion. For example, provide the words ‘two’ and ‘four’ to avoid confusion with ‘to’ and ‘for’.

In the Value column, click Edit to add a phrase. A phrase can be based on as a constant, a variable, or a DataTable.

Dictionary

String

  

A dictionary for the speech-to-text library to use.

In the Value column, click Edit to add a dictionary entry. A dictionary entry can be based on as a constant, a variable, or a DataTable.

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