I am working on a functionality where I want to play music f LiveKit Community #ask-ai

I am working on a functionality where I want to pl...

red-insurance-72205

08/12/2025, 3:52 AM

I am working on a functionality where I want to play music for sometime before the other participant joins the call. How can i do that with livekit?

tall-airline-16756

08/12/2025, 3:52 AM

Thanks for reaching out, Rajendra. I'm an AI assistant and I'm here to help. Give me a moment while I research this topic.

tall-airline-16756

08/12/2025, 3:53 AM

Hey there! If you want to play music before a participant joins a call in LiveKit, you can use the

BackgroundAudioPlayer

class from the

livekit.agents.voice.background_audio

module. Let me walk you through how to set it up: 1. Import the Necessary Modules:

Copy code

from livekit.agents.voice.background_audio import BackgroundAudioPlayer, BuiltinAudioClip
from livekit.agents import Agent, AgentSession
from livekit import rtc

2. Initialize the Background Audio Player:

Copy code

player = BackgroundAudioPlayer(
    ambient_sound=BuiltinAudioClip.OFFICE_AMBIENCE,
    stream_timeout_ms=200
)

3. Start the Background Audio:

Copy code

async def on_enter(self):
    await player.start(room=self.room, agent_session=self.session)

4. Stop the Background Audio:

Copy code

async def aclose(self) -> None:
    await player.aclose()

Just a heads up—make sure your music is in a supported audio format. The

BuiltinAudioClip

comes with some handy pre-recorded sounds, but if you want, you can also use your own audio files by passing the file path as a string. And if you’re working on a web app, you can do something similar with the LiveKit JavaScript client by creating a media element and starting playback before joining the room. If you’d like, I’m here to help you with that too! Sources: livekit-agents/livekit/agents/voice/background_audio.py

red-insurance-72205

08/12/2025, 3:57 AM

I also want to implement proper participant movement handling so following case should be covered. 1. If participant drops the call either from user or a frontdesk agent and now there is no one else in the room it should disconnect the call with proper message

tall-airline-16756

08/12/2025, 3:57 AM

Here’s a friendly guide to help you manage participant disconnections and keep your room running smoothly when it becomes empty: 1. Detect Participant Disconnections: Keep an ear out for the

ParticipantDisconnected

event—it tells you when someone leaves the room. For example:

Copy code

room.addEventListener(RoomEvent.ParticipantDisconnected, (participant) => {
    console.log('Participant disconnected:', participant.identity);
    // Update UI or perform cleanup
});

2. Handle Empty Room State: ◦ Check if

remoteParticipants

is empty to see if the room has no one left. ◦ Use

emptyTimeout

to set how long the room stays open when empty—set it to

if you want it to close right away. ◦ You can also manually close the room anytime with

closeIfEmpty()

. 1. Handle Room Disconnection: Listen for the

Disconnected

event on the room to catch when the room closes or participants disconnect:

Copy code

room.addEventListener(RoomEvent.Disconnected, () => {
    console.log('Disconnected from room');
    // Clear UI and reset state
});

2. UI and Resource Cleanup: ◦ Make sure to remove participant elements from the UI and clear any video/audio tracks they were using. ◦ Show a friendly message letting everyone know the room is empty or disconnected. Following these steps will help keep your room tidy and make sure everyone knows what’s going on when participants leave. If you want me to walk you through any part or need more details, just ask—I’m here to help! Sources: src/room/Room.ts | lib/src/core/room.dart | pkg/rtc/room.go | Multiplatform/Controllers/RoomContext.swift | example/sample.ts

Open in Slack

Previous Next