Class AudioPlayback

    Definition

    Namespace:
    Tizen.Multimedia
    Assembly:
    Tizen.Multimedia.AudioIO.dll

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

    public class AudioPlayback : IDisposable
    Inheritance
    object
    AudioPlayback
    Implements
    System.IDisposable

    Constructors

    View Source

    AudioPlayback(int, 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
    int sampleRate

    The audio sample rate (8000 ~ 192000Hz).

    AudioChannel channel

    The audio channel type.

    AudioSampleType sampleType

    The audio sample type.

    Exceptions
    Type Condition
    System.ArgumentOutOfRangeException

    sampleRate is less than MinSampleRate.
    -or-
    sampleRate is greater than MaxSampleRate.

    System.ArgumentException

    channel is invalid.
    -or-
    sampleType is invalid.

    Fields

    View Source

    MaxSampleRate

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

    Declaration
    public static readonly int MaxSampleRate
    Field Value
    Type Description
    int
    See Also
    SampleRate
    View Source

    MinSampleRate

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

    Declaration
    public static readonly int MinSampleRate
    Field Value
    Type Description
    int
    See Also
    SampleRate

    Properties

    View Source

    Channel

    Gets the channel type of the audio output data stream.

    Declaration
    public AudioChannel Channel { get; }
    Property Value
    Type Description
    AudioChannel
    View Source

    SampleRate

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

    Declaration
    public int SampleRate { get; }
    Property Value
    Type Description
    int
    View Source

    SampleType

    Gets the sample type of the audio output data stream.

    Declaration
    public AudioSampleType SampleType { get; }
    Property Value
    Type Description
    AudioSampleType
    View Source

    StreamType

    Gets the sound type supported by the audio output device.

    Declaration
    public AudioStreamType StreamType { get; }
    Property Value
    Type Description
    AudioStreamType
    Exceptions
    Type Condition
    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    Methods

    View Source

    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.

    Exceptions
    Type Condition
    System.ArgumentNullException

    streamPolicy is null.

    System.ObjectDisposedException

    streamPolicy has already been disposed of.
    -or-
    The AudioPlayback has already been disposed of.

    System.NotSupportedException

    streamPolicy is not supported.

    System.ArgumentException

    Not able to retrieve information from streamPolicy.

    View Source

    Dispose()

    Releases all resources used by the AudioPlayback object.

    Declaration
    public void Dispose()
    View Source

    Dispose(bool)

    Releases the resources used by the AudioPlayback object.

    Declaration
    protected virtual void Dispose(bool disposing)
    Parameters
    Type Name Description
    bool disposing

    true to release both managed and unmanaged resources; false to release only unmanaged resources.

    View Source

    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()
    Exceptions
    Type Condition
    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    System.InvalidOperationException

    The current state is Idle.

    View Source

    ~AudioPlayback()

    Finalizes an instance of the AudioPlayback class.

    Declaration
    protected ~AudioPlayback()
    View Source

    Flush()

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

    Declaration
    public void Flush()
    Exceptions
    Type Condition
    System.InvalidOperationException

    The current state is Idle.

    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    View Source

    GetBufferSize()

    Gets the size allocated for the audio output buffer.

    Declaration
    public int GetBufferSize()
    Returns
    Type Description
    int
    Exceptions
    Type Condition
    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    View Source

    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.

    Exceptions
    Type Condition
    System.InvalidOperationException

    The current state is Idle.
    -or-
    The method is called in the BufferAvailable event handler.

    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    See Also
    Resume()
    View Source

    Prepare()

    Prepares the AudioPlayback.

    Declaration
    public void Prepare()
    Remarks

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

    Exceptions
    Type Condition
    System.InvalidOperationException

    Operation failed due to an internal error.
    -or-
    The current state is not Idle.

    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    See Also
    Unprepare()
    View Source

    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.

    Exceptions
    Type Condition
    System.InvalidOperationException

    The current state is Idle.
    -or-
    The method is called in an event handler.

    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    See Also
    Pause()
    View Source

    Unprepare()

    Unprepares the AudioPlayback.

    Declaration
    public void Unprepare()
    Exceptions
    Type Condition
    System.InvalidOperationException

    Operation failed due to an internal error.
    -or-
    The current state is Idle.

    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    See Also
    Prepare()
    View Source

    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
    int

    The written size.

    Exceptions
    Type Condition
    System.ArgumentNullException

    buffer is null.

    System.ArgumentException

    The length of buffer is zero.

    System.InvalidOperationException

    The current state is not Running.

    System.ObjectDisposedException

    The AudioPlayback has already been disposed of.

    Events

    View Source

    BufferAvailable

    Occurs when the audio playback data can be written.

    Declaration
    public event EventHandler<AudioPlaybackBufferAvailableEventArgs> BufferAvailable
    Event Type
    Type Description
    System.EventHandler<TEventArgs><AudioPlaybackBufferAvailableEventArgs>
    See Also
    Write(byte[])
    View Source

    StateChanged

    Occurs when the state of the AudioPlayback is changed.

    Declaration
    public event EventHandler<AudioIOStateChangedEventArgs> StateChanged
    Event Type
    Type Description
    System.EventHandler<TEventArgs><AudioIOStateChangedEventArgs>

    Implements

    System.IDisposable
    • View Source
    Back to top Copyright © 2016-2024 Samsung
    Generated by DocFX