Background Audio

class VoiceAgent(Agent):
    def __init__(self, pipeline):
        super().__init__(
            agent_id="assistant",
            instructions="You are a helpful assistant.",
            pipeline=pipeline,
        )
        self.set_thinking_audio(
            file="https://cdn.zeroruntime.ai/zrt/bg-audio/bg-noise-1.wav",
            volume=0.3,
        )

import { Agent } from '@zeroruntime/js-sdk';

class VoiceAgent extends Agent {
  constructor(pipeline) {
    super({
      agent_id: 'assistant',
      instructions: 'You are a helpful assistant.',
      pipeline,
    });
  }

  // The thinking sound is set on the live session, so it is armed once the
  // agent has joined rather than in the constructor.
  async on_enter(): Promise<void> {
    await this.session!.set_thinking_audio(
      'https://cdn.zeroruntime.ai/zrt/bg-audio/bg-noise-1.wav',
      { volume: 0.3 },
    );
  }
}

@function_tool
async def control_background_music(self, action: str):
    """Play or stop background music. action: 'play' or 'stop'."""
    if action == "play":
        await self.play_background_audio(
            file="https://cdn.zeroruntime.ai/zrt/bg-audio/bg-noise-1.wav",
            volume=0.8,
            looping=True,
            override_thinking=False,
        )
        return "Music started."
    await self.stop_background_audio()
    return "Music stopped."

import { current_session, function_tool } from '@zeroruntime/js-sdk';

const control_background_music = function_tool({
  name: 'control_background_music',
  description: "Play or stop background music. action: 'play' or 'stop'.",
  parameters: {
    action: { type: 'string', description: "Either 'play' or 'stop'." },
  },
  // Background audio is a session call, so this reads the live session rather
  // than the agent. Hold the tool on an agent field and `this` is bound for you.
  execute: async ({ action }) => {
    const session = current_session();
    if (action === 'play') {
      await session.play_background_audio(
        'https://cdn.zeroruntime.ai/zrt/bg-audio/bg-noise-1.wav',
        { volume: 0.8, looping: true, override_thinking: false },
      );
      return 'Music started.';
    }
    await session.stop_background_audio();
    return 'Music stopped.';
  },
});