Class AudioPlayback

Provides the ability to directly manage the system audio output devices and play the PCM (pulse-code modulation) data.

Inheritance

Object

AudioPlayback

Implements

IDisposable

Inherited Members

Object.Equals(Object)

Object.Equals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ReferenceEquals(Object, Object)

Object.ToString()

Namespace: Tizen.Multimedia

Assembly: Tizen.Multimedia.AudioIO.dll

Syntax

public class AudioPlayback : IDisposable

Constructors

AudioPlayback(Int32, AudioChannel, AudioSampleType)

Initializes a new instance of the AudioPlayback class with the specified sample rate, channel, and sample type.

Declaration

public AudioPlayback(int sampleRate, AudioChannel channel, AudioSampleType sampleType)

Parameters

Type	Name	Description
Int32	sampleRate	The audio sample rate (8000 ~ 192000Hz).
AudioChannel	channel	The audio channel type.
AudioSampleType	sampleType	The audio sample type.

API Version

3

Exceptions

Type	Condition
ArgumentOutOfRangeException	sampleRate is less than MinSampleRate. -or- sampleRate is greater than MaxSampleRate.
ArgumentException	channel is invalid. -or- sampleType is invalid.

Fields

MaxSampleRate

Specifies the maximum value allowed for the audio capture, in Hertz (Hz).

Declaration

public static readonly int MaxSampleRate

Field Value

Type	Description
Int32

API Version

3

See Also

SampleRate

MinSampleRate

Specifies the minimum value allowed for the audio capture, in Hertz (Hz).

Declaration

public static readonly int MinSampleRate

Field Value

Type	Description
Int32

API Version

3

See Also

SampleRate

Properties

Channel

Gets the channel type of the audio output data stream.

Declaration

public AudioChannel Channel { get; }

Property Value

Type	Description
AudioChannel

API Version

3

SampleRate

Gets the sample rate of the audio output data stream, in Hertz (Hz).

Declaration

public int SampleRate { get; }

Property Value

Type	Description
Int32

API Version

3

SampleType

Gets the sample type of the audio output data stream.

Declaration

public AudioSampleType SampleType { get; }

Property Value

Type	Description
AudioSampleType

API Version

3

StreamType

Gets the sound type supported by the audio output device.

Declaration

public AudioStreamType StreamType { get; }

Property Value

Type	Description
AudioStreamType

API Version

3

Exceptions

Type	Condition
ObjectDisposedException	The AudioPlayback has already been disposed of.

Methods

ApplyStreamPolicy(AudioStreamPolicy)

Applies the sound stream information to the AudioPlayback.

Declaration

public void ApplyStreamPolicy(AudioStreamPolicy streamPolicy)

Parameters

Type	Name	Description
AudioStreamPolicy	streamPolicy	The AudioStreamPolicy to apply for the AudioPlayback.

API Version

3

Exceptions

Type	Condition
ArgumentNullException	streamPolicy is null.
ObjectDisposedException	streamPolicy has already been disposed of. -or- The AudioPlayback has already been disposed of.
NotSupportedException	streamPolicy is not supported.
ArgumentException	Not able to retrieve information from streamPolicy.

Dispose()

Releases all resources used by the AudioPlayback object.

Declaration

public void Dispose()

API Version

3

Dispose(Boolean)

Releases the resources used by the AudioPlayback object.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
Boolean	disposing	true to release both managed and unmanaged resources; false to release only unmanaged resources.

API Version

3

Drain()

Drains the buffered audio data from the output stream. It blocks the calling thread until the drain of the stream buffer is complete, for example, at the end of playback.

Declaration

public void Drain()

API Version

3

Exceptions

Type	Condition
ObjectDisposedException	The AudioPlayback has already been disposed of.
InvalidOperationException	The current state is Idle.

Finalize()

Finalizes an instance of the AudioPlayback class.

Declaration

protected void Finalize()

Flush()

Flushes and discards the buffered audio data from the output stream.

Declaration

public void Flush()

API Version

3

Exceptions

Type	Condition
InvalidOperationException	The current state is Idle.
ObjectDisposedException	The AudioPlayback has already been disposed of.

GetBufferSize()

Gets the size allocated for the audio output buffer.

Declaration

public int GetBufferSize()

Returns

Type	Description
Int32

API Version

3

Exceptions

Type	Condition
ObjectDisposedException	The AudioPlayback has already been disposed of.

Pause()

Pauses feeding of the audio data to the device.

Declaration

public void Pause()

Remarks

It has no effect if the current state is Paused.

API Version

3

Exceptions

Type	Condition
InvalidOperationException	The current state is Idle. -or- The method is called in the BufferAvailable event handler.
ObjectDisposedException	The AudioPlayback has already been disposed of.

See Also

Resume()

Prepare()

Prepares the AudioPlayback.

Declaration

public void Prepare()

Remarks

This must be called before Write(Byte[]).

API Version

3

Exceptions

Type	Condition
InvalidOperationException	Operation failed due to an internal error. -or- The current state is not Idle.
ObjectDisposedException	The AudioPlayback has already been disposed of.

See Also

Unprepare()

Resume()

Resumes feeding of the audio data to the device.

Declaration

public void Resume()

Remarks

It has no effect if the current state is Running.

API Version

3

Exceptions

Type	Condition
InvalidOperationException	The current state is Idle. -or- The method is called in an event handler.
ObjectDisposedException	The AudioPlayback has already been disposed of.

See Also

Pause()

Unprepare()

Unprepares the AudioPlayback.

Declaration

public void Unprepare()

API Version

3

Exceptions

Type	Condition
InvalidOperationException	Operation failed due to an internal error. -or- The current state is Idle.
ObjectDisposedException	The AudioPlayback has already been disposed of.

See Also

Prepare()

Write(Byte[])

Starts writing the audio data to the device.

Declaration

public int Write(byte[] buffer)

Parameters

Type	Name	Description
Byte[]	buffer	The buffer to write.

Returns

Type	Description
Int32	The written size.

API Version

3

Exceptions

Type	Condition
ArgumentNullException	buffer is null.
ArgumentException	The length of buffer is zero.
InvalidOperationException	The current state is not Running.
ObjectDisposedException	The AudioPlayback has already been disposed of.

Events

BufferAvailable

Occurs when the audio playback data can be written.

Declaration

public event EventHandler<AudioPlaybackBufferAvailableEventArgs> BufferAvailable

Event Type

Type	Description
EventHandler<AudioPlaybackBufferAvailableEventArgs>

API Version

3

See Also

Write(Byte[])

StateChanged

Occurs when the state of the AudioPlayback is changed.

Declaration

public event EventHandler<AudioIOStateChangedEventArgs> StateChanged

Event Type

Type	Description
EventHandler<AudioIOStateChangedEventArgs>

API Version

3

Implements

System.IDisposable