Audiotoolbox Plugin

How to use the Audiotoolbox Plugin robot skill

Allows ARC to use UWP speech voices, change default audio devices, capture sound and route to an EZB.

*** Version 14 ***

Minor bug fix (memory release)

*** Version 13 ***

Fix for ARC 2020.02.28.00 release

*** Version 12 ***

Fix for ARC 2020.02.19.00 release

*** Version 11 ***

Fix for new ARC version

*** Version 10 ***

ImportUWPVoices command restored

*** Version 9 ***

Bug Fix (UI sync monitor object waits indefinitely, solution pulse the monitor when leaving ARC) 

*** Version 8 ***

Build Fix 

*** Version 7 ***

Bug Fixes

*** Version 6 ***

Added Audio Session Tracking 

Audio Session Tracking mode can be configured to:
1) None
No tracking (default)

2) All
Tracks all audio sessions from all processes 

3) CurrentProcess
Tracks only the current process (ARC instance) audio sessions




When the Audio Session Tracking is active (All / CurrentProcess) an EZ-Script variable $NumberOfActiveAudioSessions counts the number audio sessions are active (playing) on the default render (output) device.




a value of zero means the render device is idle.

sample script:

Code:

#Say and do not wait
Say("How vexingly quick daft zebras jump!")

#wait 100 ms to allow the session counter variable to update 
Sleep(100) 

#at least 1 will be printed 
print($NumberOfActiveAudioSessions)
#wait for #active audio sessions is zero (render/output device is idle) 
WaitFor($NumberOfActiveAudioSessions=0)

Say("Jived fox nymph grabs quick waltz.")
Sleep(100)
print($NumberOfActiveAudioSessions)
WaitFor($NumberOfActiveAudioSessions=0)

print($NumberOfActiveAudioSessions)

*** Version 5

Cortana Voice Added

*** Version 4 : New Features

Code:

ControlCommand("AudioToolbox Plugin", "ImportUWPVoices")

The above script command allows ARC to access the UWP Voices.

How to use quick video:


*** Version 2 : New Features

Set Default Devices:




Select the desired devices and press "Set Default" button

Set Default Devices via EZ-Script:

First configure the devices:




script:

Code:

#SetDefault takes in consideration the device type (input or output)

#Set device 0 as default  
ControlCommand("AudioToolbox Plugin", "SetDefault", 0)
SayWait("Hello Device 0") 

#Set device 1 as default  
ControlCommand("AudioToolbox Plugin", "SetDefault", 1)
SayWait("Hello Device 1") 

*** Version 1

1) Start Capturing sound on device #1:

Code:

ControlCommand("AudioToolbox Plugin", "StartCapture", 1)

2) Set EZB #0 to listen to device #1:

Code:

#0 = EZB Controller Index (0..4)
#1 = Device Index (0..2) 
#75 = Volume 
ControlCommand("AudioToolbox Plugin", "StartEZBListen", 0, 1, 75)

2.1) Add EZB #1 to listen to device #1:

Code:

ControlCommand("AudioToolbox Plugin", "StartEZBListen", 1, 1, 100)

3) Stop EZB #0 to listen

Code:

ControlCommand("AudioToolbox Plugin", "StopEzbListen", 0)

4) Stop Capture on device #1

Code:

ControlCommand("AudioToolbox Plugin", "StopCapture", 1)

*****
Note:

You have the option to configure the 3 devices (device num: 0 .. 2):