Prosody speech processing: API: sm_conf_prim_config_activity_reporting

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
The channel which is a conference output.
delay
The minimum time (in ms) between active input reports.
sensitivity
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.