Speech Channel Monitoring¶
Speech channel monitoring evaluates the quality and content of the speech channel established between two phones that are under intaQt's control. When speech channel monitoring is requested, the caller
plays a given reference audio file using the intaQt Audio Service. At the same time, the callee
records the call that is established between the phones. In parallel, the speech channel's reverse direction is covered by playing the reference audio file on the callee
and recording it on the caller
. The recordings on A and B are attached to the test report for evaluation.
The recording analysis evaluates three characteristics about the sounds emitted, their frequency and their duration. Analysis parameters can be adjusted in the Audio Monitoring configuration.
-
Total number of beeps: If the total number of beeps does not exceed a given limit, the monitoring is considered failed.
-
Predominant frequency: The recording's predominant frequency must match the beeps' nominal frequency. If the call channel is broken, a white noise recording would fail the frequency check.
-
Pause position and duration: If a pause is too long, one or more beeps are missing from the recording.
Important! Having multiple recordings or playbacks at the same time on a given Raspberry Pi is not possible. However, running a single recording and a single playback simultaneously is possible. Trying to run multiple recordings simultaneously leads to an error that resets the Audio Service.
Speech Channel Monitoring |
---|
Start Speech Channel Monitoring |
Stop Speech Channel Monitoring |
Evaluate Speech Channel Monitoring |
Start Speech Channel Monitoring ¶
This step:
-
Starts audio recording on two specified phones
-
Starts the playback of a predetermined audio file on both phones
-
Specifies a name for the speech channel monitoring (optional)
Syntax
1 2 3 4 5 | // Does not specify a name for the speech channel monitoring start speech channel monitoring for <phone Identifier> and <phone Identifier> // Specifies a name for the speech channel monitoring start speech channel monitoring for <phone Identifier> and <phone Identifier> as <name Identifier> |
Parameters
-
phone - The identifiers of the phones participating in the monitored call
-
name (Optional) - The name assigned to the Speech Channel Monitoring initiated for the two participating phones
- When not specified, the name
SCM_<phone1>_<phone2>
will be used to uniquely identify the Speech Channel Monitoring
- When not specified, the name
Example
1 2 3 4 5 6 | // No name specified And start speech channel monitoring for A and B Resulting speech channel monitoring name : SCM_A_B // With specified name And start speech channel monitoring for A and B as monitoring_phones |
Stop Speech Channel Monitoring ¶
This step:
-
Stops audio recording by either specifying the participating phones or the speech channel monitoring name
-
Stops the audio playback on both phones
Syntax
1 2 3 4 | // Specifies the phones stop speech channel monitoring for <phone Identifier> and <phone Identifier> // Specifies the speech channel monitoring name stop speech channel monitoring <name Identifier> |
Parameters
-
phone - The identifiers of the phones participating in the monitored call
-
name - The explicit name identifying a Speech Channel Monitoring, as given in the
start speech channel monitoring
step- Stopping an unnamed speech channel monitoring can also be done by using its implicit name, for example, its default name
SCM_<phone1>_<phone2>
- Stopping an unnamed speech channel monitoring can also be done by using its implicit name, for example, its default name
Named Speech Channel Monitoring Example
1 2 3 | // With a named speech channel monitoring And start speech channel monitoring for A and B as monitoring_phones And stop speech channel monitoring monitoring_phones |
Phone Identifiers Example
1 2 3 | // With an unnamed speech channel monitoring And start speech channel monitoring for A and B And stop speech channel monitoring for A and B |
Implicitly-Named Speech Channel Monitoring Example
1 2 3 | // With a named speech channel monitoring And start speech channel monitoring for A and B And stop speech channel monitoring SCM_A_B |
In the example above, the speech channel monitoring was assigned the default name SCM
, meaning it is can be referenced in the stop speech channel
step as SCM_A_B
.
Evaluate Speech Channel Monitoring ¶
This step:
-
Retrieves the recordings using the speech channel monitoring name, either the implicit (
SCM_<phone1>_<phone2>
) or the explicitly-assigned name. -
Evaluates the speech channel based on the retrieved recordings.
Note:
The start
and stop
speech channel monitoring steps MUST have preceded the evaluate
step.
Syntax
1 2 3 4 5 | // Specifies the phones evaluate speech channel monitoring for <phone Identifier> and <phone Identifier> // Specifies the speech channel monitoring name evaluate speech channel monitoring <name Identifier> |
Parameters
-
phone - The identifiers of the phones participating in the monitored call
-
name - The explicit speech channel monitoring name
Named Speech Channel Monitoring Example
1 2 3 | And start speech channel monitoring for A and B as monitoring_phones And stop speech channel monitoring monitoring_phones And evaluate speech channel monitoring monitoring_phones |
Phone Identifiers Example
1 2 3 | And start speech channel monitoring for A and B And stop speech channel monitoring for A and B And evaluate speech channel monitoring for A and B |
Implicitly-Named Speech Channel Monitoring Example
1 2 3 | And start speech channel monitoring for A and B And stop speech channel monitoring for A and B And evaluate speech channel monitoring SCM_A_B |