Methods > Init, info and tags > SilenceDetectionOnPlayerLoadAutoSet method

Remarks

Enable/disables the automatic detection of silent sound's portions during the loading of a sound through one of the many methods having the "Load" prefix like LoadSound or LoadSoundFromMemory: the automatic silence detection is disabled by default.

This method doesn't work with sounds with more than 2 channels (5.1 or 7.1) or if the EnableMixingFeatures property has been set to false.

When the automatic silence detection is enabled, the container application will be notified about initial and final positions of silent portions at the start and end of loaded songs through the CallbackForPlayersEvents delegate which is invoked with the nEvent parameter set to EV_SILENCE_AVAIL.

When the automatic silence detection is disabled, the loaded song silence can be requested at any time calling the SilenceDetectionOnPlayerRequest method.

For further details about silence detection management see the How to detect silent portions of sound files tutorial.

Syntax

[Visual Basic]

Public Sub SilenceDetectionOnPlayerLoadAutoSet (

bAutomatic as Boolean,

nThresholdInitial as Int32,

nThresholdFinal as Int32

)

[C#]

public void SilenceDetectionOnPlayerLoadAutoSet (

bool bAutomatic,

Int32 nThresholdInitial,

Int32 nThresholdFinal

);

[C++]

public: void SilenceDetectionOnPlayerLoadAutoSet (

bool bAutomatic,

Int32 nThresholdInitial,

Int32 nThresholdFinal

);

Parameter

Description

bAutomatic

Boolean value that specifies to execute the automatic silence detection on each loaded sound.

Supported values are the following:

Value	Meaning
false	Automatic silence detection is disabled (default)
true	Automatic silence detection is enabled

nThresholdInitial

Number representing the silence threshold at the start of the loaded sound: can assume values from 0 (no sound) to 32767 (max volume).

nThresholdFinal

Number representing the silence threshold at the end of the loaded sound: can assume values from 0 (no sound) to 32767 (max volume).

Return value

None