vx_call_stats

Reference the Vivox Core SDK API.

Read time 6 minutes

Last updated 8 months ago

The common structure for holding call-related statistics.

#include <VxcEvents.h>

Public Attributes

	Name
int	insufficient_bandwidth RESERVED FOR FUTURE USE.
int	min_bars RESERVED FOR FUTURE USE.
int	max_bars RESERVED FOR FUTURE USE.
int	current_bars An indication of the network quality in the range of 1-5, with 5 indicating the best quality.
int	pk_loss RESERVED FOR FUTURE USE.
int	incoming_received The number of packets received.
int	incoming_expected RESERVED FOR FUTURE USE.
int	incoming_packetloss The number of packets lost in the network.
int	incoming_out_of_time The number of packets received too late to be useful and discarded.
int	incoming_discarded The number of packets received but discarded because the local queue overflowed.
int	outgoing_sent The number of packets sent.
int	render_device_underruns The number of render device underruns.
int	render_device_overruns The number of render device overruns.
int	render_device_errors The number of render device errors.
char *	call_id The SIP call ID.
int	plc_on A flag that indicates whether packet loss concealment (error correction) has happened.
int	plc_synthetic_frames The number of 10ms synthetic frames generated by packet loss concealment.
char *	codec_name A codec negotiated in the current call.
int	codec_mode
double	min_latency The minimum network latency detected in seconds.
double	max_latency The maximum network latency detected in seconds.
int	latency_measurement_count The number of times that latency was measured.
double	latency_sum The total number of seconds of measured network latency.
double	last_latency_measured The last latency that was measured.
int	latency_packets_lost The number of times that latency packet were received where their prior expected response was not received.
double	r_factor A computation of quality.
int	latency_packets_sent The number of latency measurement request packets sent.
int	latency_packets_dropped The number of latency measurement response packets lost.
int	latency_packets_malformed The number of latency measurement packets that were too short or otherwise malformed.
int	latency_packets_negative_latency The number of latency measurement packets that arrived before they were sent.
double	sample_interval_begin The beginning of the sample period in fractional seconds since midnight January 1, 1970 GMT.
double	sample_interval_end The end of the sample period in fractional seconds since midnight January 1, 1970 GMT.
int[5]	capture_device_consecutively_read_count The number of intervals where 0, 1, 2, 3, or 4 or greater audio frames were read from the capture device.
int	current_opus_bit_rate The OPUS bit rate that was used for encoding the last transmitted OPUS packet.
int	current_opus_complexity The OPUS complexity that was used for encoding the last transmitted OPUS packet.
int	current_opus_vbr_mode The OPUS VBR mode (vx_opus_vbr_mode) that was used for encoding the last transmitted OPUS packet.
int	current_opus_bandwidth The OPUS bandwith (vx_opus_bandwidth) that was used for encoding the last transmitted OPUS packet.
int	current_opus_max_packet_size The OPUS max packet size limit that was used for encoding the last transmitted OPUS packet.

Public Attributes Documentation

variable insufficient_bandwidth


int insufficient_bandwidth;

RESERVED FOR FUTURE USE.

variable min_bars


int min_bars;

RESERVED FOR FUTURE USE.

variable max_bars


int max_bars;

RESERVED FOR FUTURE USE.

variable current_bars


int current_bars;

An indication of the network quality in the range of 1-5, with 5 indicating the best quality.

variable pk_loss


int pk_loss;

RESERVED FOR FUTURE USE.

variable incoming_received


int incoming_received;

The number of packets received.

variable incoming_expected


int incoming_expected;

RESERVED FOR FUTURE USE.

variable incoming_packetloss


int incoming_packetloss;

The number of packets lost in the network.

variable incoming_out_of_time


int incoming_out_of_time;

The number of packets received too late to be useful and discarded.

variable incoming_discarded


int incoming_discarded;

The number of packets received but discarded because the local queue overflowed.

variable outgoing_sent


int outgoing_sent;

The number of packets sent.

variable render_device_underruns


int render_device_underruns;

The number of render device underruns.

Note: Mobile platforms only.

variable render_device_overruns


int render_device_overruns;

The number of render device overruns.

Note: Mobile platforms only.

variable render_device_errors


int render_device_errors;

The number of render device errors.

Note: Mobile platforms only.

variable call_id


char * call_id;

The SIP call ID.

variable plc_on


int plc_on;

A flag that indicates whether packet loss concealment (error correction) has happened.

variable plc_synthetic_frames


int plc_synthetic_frames;

The number of 10ms synthetic frames generated by packet loss concealment.

variable codec_name


char * codec_name;

A codec negotiated in the current call.

variable codec_mode


int codec_mode;

Deprecated:

This is deprecated and should not be used.

variable min_latency


double min_latency;

The minimum network latency detected in seconds.

This is zero if no latency measurements are made.

variable max_latency


double max_latency;

The maximum network latency detected in seconds.

This is zero if no latency measurements are made.

variable latency_measurement_count


int latency_measurement_count;

The number of times that latency was measured.

variable latency_sum


double latency_sum;

The total number of seconds of measured network latency.

variable last_latency_measured


double last_latency_measured;

The last latency that was measured.

variable latency_packets_lost


int latency_packets_lost;

The number of times that latency packet were received where their prior expected response was not received.

variable r_factor


double r_factor;

A computation of quality.

variable latency_packets_sent


int latency_packets_sent;

The number of latency measurement request packets sent.

variable latency_packets_dropped


int latency_packets_dropped;

The number of latency measurement response packets lost.

variable latency_packets_malformed


int latency_packets_malformed;

The number of latency measurement packets that were too short or otherwise malformed.

variable latency_packets_negative_latency


int latency_packets_negative_latency;

The number of latency measurement packets that arrived before they were sent.

Note: This can occur if there are clock adjustments.

variable sample_interval_begin


double sample_interval_begin;

The beginning of the sample period in fractional seconds since midnight January 1, 1970 GMT.

variable sample_interval_end


double sample_interval_end;

The end of the sample period in fractional seconds since midnight January 1, 1970 GMT.

variable capture_device_consecutively_read_count


int[5] capture_device_consecutively_read_count;

The number of intervals where 0, 1, 2, 3, or 4 or greater audio frames were read from the capture device.