audio_output.go RawHistoryFolder

1// Package port defines application-layer interfaces for external capabilities.
2// This file defines the Audio Output port for CEF audio streaming on Linux.
3package port
4
5import "context"
6
7// AudioStreamFormat represents the audio stream format configuration.
8// This is a value object that describes how audio data should be streamed.
9type AudioStreamFormat struct {
10	// SampleRate is the audio sample rate in Hz (e.g., 48000, 44100).
11	SampleRate int
12	// ChannelCount is the number of audio channels (e.g., 1 for mono, 2 for stereo).
13	ChannelCount int
14	// FramesPerBuffer is the number of frames per buffer (e.g., 512, 1024).
15	FramesPerBuffer int
16}
17
18// AudioOutputStream represents an active audio output stream.
19// Implementations handle the low-level audio playback.
20type AudioOutputStream interface {
21	// Write sends audio samples to the output device.
22	// Samples are provided as a 2D slice: [channel][frame]float32.
23	// This matches CEF's planar float32 audio format.
24	Write(samples [][]float32) error
25	// Close releases the audio stream and associated resources.
26	Close() error
27}
28
29// AudioOutputFactory creates audio output streams.
30// This is the primary interface for the audio output port.
31type AudioOutputFactory interface {
32	// NewStream creates a new audio output stream with the given format.
33	NewStream(ctx context.Context, format AudioStreamFormat) (AudioOutputStream, error)
34}