Detect When PC Audio Finishes

There isn’t a built-in ARC global variable named $PCPlayingAudio for PC audio playback.

For PC audio played with Audio.playAudioFile(filename), the usual approach is:

1. Start the audio
2. Poll a flag you control, or
3. Use a known duration + sleep(), if the file length is fixed

Best simple solution: use your own flag

Since ARC doesn’t expose a built-in "PC audio is still playing" variable like it does for some EZB states, you can track it yourself in script.

JavaScript example

setVar("$PCAudioPlaying", "true")

Audio.playAudioFile("C:\\Sounds\\mysound.wav")

// If you know the file length, wait that long
sleep(3500)

setVar("$PCAudioPlaying", "false")

Better approach: use TTS audio from ARC and wait

If you’re using Audio.saySSMLWait() or Audio.saySSML(), the Wait version blocks until speaking is finished:

Audio.saySSMLWait("<speak>Hello, world.</speak>")
print("Speech finished")

That works for speech synthesis, but not for Audio.playAudioFile().

If you need to know when a file ends

ARC scripting does not currently provide a direct built-in callback or status variable for PC audio file playback completion. So your options are:

• Estimate duration of the file and sleep() for that long
• Use a script-managed variable
• Convert the file to speech/SSML if appropriate, then use the Wait version

Related variable note

ARC does have:

• $EZBPlayingAudio for EZB audio state
• $IsSpeaking for speech state

But those are not the same as PC audio file playback.

Helpful reference

• Console / Print() output: https://synthiam.com/Support/Programming/code-editor/console

If you want, I can help you write a small JavaScript or Python wrapper that plays a PC audio file and then automatically clears a flag after the correct duration.

That's a tough one - because every robot skill has its own connection to the default audio device. It's because pc audio works differently than an ezb audio stream. An ezb audio stream is singular, where only one audio stream can play at a time, no matter what robot skill tries to play. The difference with the PC speaker is that it plays audio synchronously from any robot skill or command. So there's no way to know who's playing, when it's playing, or why it's playing. When one audio stream stops, another could still be playing, and without knowing that, there would be no way to monitor the system-wide audio.

I think the way to do it is to monitor the audio out device using the Sound servo PC Speaker.

Sound Servo (PC Speaker) by Synthiam

Maps PC audio volume to servos in real time with scalar, min/max, invert & multi-servo options-ideal for syncing robot mouth to sound

Requires ARC

Audio

You could assign the servo to NA, so it's not actually trying to move a servo. Then you can either monitor the variable or the servo position. Check when the value is 0 if using the variable.

Audio.say("Hello world there");

// small pause for the audio to start playing
sleep(500);

// loop until the audio output device has no audio
while (getVar("$SoundLeft") != 0)
  sleep(100);