---
updatedAt: 2026-02-04T10:19:10.000Z
agentTools:
  siteIndex: https://developer.bitmovin.com/llms.txt
  projectIndex: https://developer.bitmovin.com/playback/llms.txt
---

# EventBus

Both `Player` and individual `Sources` expose `events` namespace, and behind it is a dynamic EventBus.

These EventBus components are dynamic - meaning any package could extend it to dispatch additional events on it.

```typescript
export type EventBus<EventMap extends { [key: string]: object }> = {
  on<Name extends keyof EventMap>(name: Name, listener: EventListener<EventMap[Name]>): void;
  off<Name extends keyof EventMap>(name: Name, listener: EventListener<EventMap[Name]>): void;
  dispatch<Name extends keyof EventMap>(
    context: EventBusContext,
    name: Name,
    event: EventMap[Name] & Partial<EventBase>,
  ): void;
};
```

The API is pretty standard - on the outside, this means that we are able to access it simply and add/remove our listeners, similar to any DOM listeners.

```
function onSourceAdded(event) {
	console.warn('SourceAdded', event);
}
// Adding
player.events.on('source-added', onSourceAdded);
// Removing
player.events.off('source-added', onSourceAdded);
```