Provides an interface to output raw audio data.
Well-defined value for an invalid audio sink.
An opaque handle to an implementation-private structure representing an audio sink.
typedef struct SbAudioSinkPrivate* SbAudioSink
Callback used to report frames consumed. The consumed frames will be removed from the source frame buffer to free space for new audio frames.
typedef void(* SbAudioSinkConsumeFramesFunc) (int frames_consumed, void *context)
An array of frame buffers. For interleaved audio streams, there will be only one element in the array. For planar audio streams, the number of elements in the array equal to the number of channels.
typedef void** SbAudioSinkFrameBuffers
Callback being called periodically to retrieve the status of the audio source.
The first two output parameters indicating the filling level of the audio frame
buffer passed to SbAudioSinkCreate as
frame_buffers is a
offset_in_frames can be used to calculate the number of
continuous frames towards the end of the buffer. The audio sink can play the
frames only when
is_playing is true. It should pause the playback when
is_playing is false. The audio sink may cache certain amount of audio frames
before start playback. It will start playback immediately when
is true even if the amount of cached audio frames are not enough as no more
frames will be appended into the buffer when
is_eos_reached is true. It is
possible for a host to set
is_eos_reached to false after setting it to true,
usually this is caused by a seek. All parameters except
context cannot be
NULL. Note that this function only reports the status of the source, it doesn't
remove audio data from the source frame buffer.
typedef void(* SbAudioSinkUpdateSourceStatusFunc) (int *frames_in_buffer, int *offset_in_frames, bool *is_playing, bool *is_eos_reached, void *context)
audio_sink, freeing all associated resources. Before returning, the
function waits until all callbacks that are in progress have finished. After the
function returns, no further calls are made callbacks passed into
SbAudioSinkCreate. In addition, you can not pass
audio_sink to any other
SbAudioSink functions after SbAudioSinkDestroy has been called on it.
This function can be called on any thread. However, it cannot be called within any of the callbacks passed into SbAudioSinkCreate.
audio_sink: The audio sink to destroy.
void SbAudioSinkDestroy(SbAudioSink audio_sink)
Returns the maximum number of channels supported on the platform. For example,
the number would be
2 if the platform only supports stereo.
Returns the minimum frames required by audio sink to play without underflows.
Returns -1, if
sampling_frequency_hz is not
supported. It's user's responsibility to ensure that there're enough frames
written into audio sink during playing, or it may have underflows.
channels: The number of audio channels, such as left and right channels in
audio_sample_type: The type of each sample of the audio data –
sampling_frequency_hz: The sample frequency of the
audio data being streamed. For example, 22,000 Hz means 22,000 sample elements
represents one second of audio data.
int SbAudioSinkGetMinBufferSizeInFrames(int channels, SbMediaAudioSampleType sample_type, int sampling_frequency_hz)
Returns the supported sample rate closest to
platforms that don't support all sample rates, it is the caller's responsibility
to resample the audio frames into the supported sample rate returned by this
int SbAudioSinkGetNearestSupportedSampleFrequency(int sampling_frequency_hz)
audio_frame_storage_type is supported on this platform.
bool SbAudioSinkIsAudioFrameStorageTypeSupported(SbMediaAudioFrameStorageType audio_frame_storage_type)
audio_sample_type is supported on this platform.
bool SbAudioSinkIsAudioSampleTypeSupported(SbMediaAudioSampleType audio_sample_type)
Indicates whether the given audio sink handle is valid.
audio_sink: The audio sink handle to check.
bool SbAudioSinkIsValid(SbAudioSink audio_sink)