Class AudioDucking

Definition

Namespace:
Tizen.Multimedia
Assembly:
Tizen.Multimedia.dll
API Level:
6

Provides the functionalities to control audio ducking.

C#
Copy
public sealed class AudioDucking : IDisposable
Inheritance
System.Object
AudioDucking
Implements
System.IDisposable

Constructors

View Source

AudioDucking(AudioStreamType)

Initializes a new instance of the AudioDucking class with AudioStreamType.

Declaration
C#
Copy
public AudioDucking(AudioStreamType targetType)
Parameters
Type Name Description
AudioStreamType targetType

The type of sound stream affected by this new instance.

Exceptions
Type Condition
System.ArgumentException

targetType is invalid.

System.InvalidOperationException

Operation failed; internal error.

API Level: 6

Properties

View Source

IsDucked

Gets the ducking state of the stream.

Declaration
C#
Copy
public bool IsDucked { get; }
Property Value
Type Description
Boolean

true if the audio stream is ducked; otherwise, false.

Exceptions
Type Condition
System.InvalidOperationException

Operation failed; internal error.

ObjectDisposedException

The AudioDucking has already been disposed of.

API Level: 6

Methods

View Source

Activate(UInt32, Double)

Activate audio ducking

Declaration
C#
Copy
public void Activate(uint duration, double ratio)
Parameters
Type Name Description
System.UInt32 duration

The duration for ducking in milliseconds.

System.Double ratio

The volume ratio when ducked.

Remarks

To activate ducking, the specified privilege is required.

Exceptions
Type Condition
System.ArgumentOutOfRangeException

duration is less than 0 or greater than 3000.
-or-
ratio is less than 0.0 or greater than or equal to 1.0.

System.InvalidOperationException

Operation failed; internal error.
-or-
The target stream is already ducked.

UnauthorizedAccessException

The caller does not have required privilege to set volume.

ObjectDisposedException

The AudioDucking has already been disposed of.

API Level: 6
Privilege Level: public
Privilege: http://tizen.org/privilege/volume.set
View Source

Deactivate()

Deactivate audio ducking

Declaration
C#
Copy
public void Deactivate()
Remarks

To deactivate ducking, the specified privilege is required.

Exceptions
Type Condition
System.InvalidOperationException

Operation failed; internal error.
-or-
The target stream is already unducked.

UnauthorizedAccessException

The caller does not have required privilege to set volume.

ObjectDisposedException

The AudioDucking has already been disposed of.

API Level: 6
Privilege Level: public
Privilege: http://tizen.org/privilege/volume.set
View Source

Dispose()

Releases all resources used by the AudioDucking.

Declaration
C#
Copy
public void Dispose()
API Level: 6

Events

View Source

DuckingStateChanged

Occurs when the ducking state is changed.

Declaration
C#
Copy
public event EventHandler<AudioDuckingStateChangedEventArgs> DuckingStateChanged
Event Type
Type Description
System.EventHandler<AudioDuckingStateChangedEventArgs>
API Level: 6

Implements

System.IDisposable

See Also