Prosody speech processing: API: sm_conf_prim_config_activity_reporting

This function is only in Preliminary Documentation.

Prototype Definition

int sm_conf_prim_config_activity_reporting(struct sm_conf_prim_config_activity_reporting_parms *activityp)

Parameters

*activityp
a structure of the following type: 
typedef struct sm_conf_prim_config_activity_reporting_parms {
	tSMChannelId channel;					/* in */
	tSM_UT32 delay;						/* in */
	tSM_UT32 sensitivity;					/* in */
} SM_CONF_PRIM_CONFIG_ACTIVITY_REPORTING_PARMS;

Description

Configures the active speaker reporting for a conference output. Once configured a conference output will report changes in the active inputs via sm_conf_prim_status(). The delay is the minimum time between these reports. Specifying a delay of zero will disable active input reporting. Reports will be generated if the ranking of the active inputs change or the measured input power varies significantly. The sensitivity determines how much the power must have changed by before a report is generated. The valid range is 0 to 100. A value of 100 will cause any change in the input power to produce a report.

The activity reporting configuration is not copied to conferences created with sm_conf_prim_clone(). Activity reporting is disabled by default.

Fields

channel (Only in Preliminary Documentation)
The channel which is a conference output.
delay (Only in Preliminary Documentation)
The minimum time (in ms) between active input reports.
sensitivity (Only in Preliminary Documentation)
The sensitivity to input power variation

Returns

0 if call completed successfully, otherwise a standard error such as:

This function is part of the Prosody speech processing API.