Audio oscillator

[waynemwashuma]

Objective

Introduces a new AudioOscillator component to the audio module, allowing users to generate and control oscillator-based audio signals directly within the engine.

Solution

The solution adds a new AudioOscillator component that wraps the Web Audio API's OscillatorNode. The component supports configurable waveform types (sine, square, triangle, sawtooth), frequency and detune. It integrates with the existing audio graph system and follows similar pattern as the audio player.

Showcase

To use the audio oscillator component:

import { AudioOscillator, AudioOscillatorType } from 'wima'

// Create an oscillator entity
commands
  .spawn()
  .insert(new AudioOscillator({
    type: AudioOscillatorType.Sine,
    frequency: 440, // A4 note
    detune: 0
  }))
  .build()

The oscillator will automatically start playing when added to an entity and stop when the entity is removed.

Migration Guide

No breaking changes were introduced. Existing audio functionality remains unchanged.

Checklist

• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.