iaxclient.h

我自己根据kiax改写的iax协议软终端

		struct iaxc_ev_call_state       call;
		struct iaxc_ev_netstats         netstats;
		struct iaxc_ev_video_stats      videostats;
		struct iaxc_ev_url              url;
		struct iaxc_ev_video            video;
		struct iaxc_ev_audio            audio;
		struct iaxc_ev_registration     reg;
	} ev;
} iaxc_event;

typedef int (*iaxc_event_callback_t)(iaxc_event e);
EXPORT void iaxc_set_event_callback(iaxc_event_callback_t func);

/* Sets iaxclient to post a pointer to a copy of event using o/s specific Post method */
EXPORT int iaxc_set_event_callpost(void *handle, int id);

/* frees event delivered via o/s specific Post method */
EXPORT void iaxc_free_event(iaxc_event *e);


/* Event Accessors */
EXPORT struct iaxc_ev_levels *iaxc_get_event_levels(iaxc_event *e);
EXPORT struct iaxc_ev_text *iaxc_get_event_text(iaxc_event *e);
EXPORT struct iaxc_ev_call_state *iaxc_get_event_state(iaxc_event *e);

// Set Preferred UDP Port:
// 0: Use the default port (4569)
// <0: Use a dynamically assigned port
// >0: Try to bind to the specified port
// NOTE: must be called before iaxc_initialize()
EXPORT void iaxc_set_preferred_source_udp_port(int sourceUdpPort);

EXPORT int iaxc_get_bind_port();
EXPORT int iaxc_initialize(int num_calls);
EXPORT void iaxc_shutdown();
EXPORT void iaxc_set_formats(int preferred, int allowed);
EXPORT void iaxc_set_min_outgoing_framesize(int samples);
EXPORT void iaxc_set_callerid(const char * name, const char * number);
EXPORT int iaxc_start_processing_thread();
EXPORT int iaxc_stop_processing_thread();
EXPORT int iaxc_call(const char * num);
EXPORT int iaxc_unregister( int id );
EXPORT int iaxc_register(const char * user, const char * pass, const char * host);
EXPORT void iaxc_send_busy_on_incoming_call(int callNo);
EXPORT void iaxc_answer_call(int callNo);
EXPORT void iaxc_blind_transfer_call(int callNo, const char * number);
EXPORT void iaxc_dump_all_calls(void);
EXPORT void iaxc_dump_call(void);
EXPORT void iaxc_reject_call(void);
EXPORT void iaxc_reject_call_number(int callNo);
EXPORT void iaxc_send_dtmf(char digit);
EXPORT void iaxc_send_text(const char * text);
EXPORT void iaxc_send_url(const char *url, int link); /* link == 1 ? AST_HTML_LINKURL : AST_HTML_URL */
EXPORT void iaxc_millisleep(long ms);
EXPORT void iaxc_set_silence_threshold(float thr);
EXPORT void iaxc_set_audio_output(int mode);
EXPORT int iaxc_select_call(int callNo);
EXPORT int iaxc_first_free_call();
EXPORT int iaxc_selected_call();
EXPORT int iaxc_quelch(int callNo, int MOH);
EXPORT int iaxc_unquelch(int call);
EXPORT int iaxc_mic_boost_get( void ) ;
EXPORT int iaxc_mic_boost_set( int enable ) ;
EXPORT char* iaxc_version(char *ver);

/* Fine tune jitterbuffer control */
EXPORT void iaxc_set_jb_target_extra( long value );

/* application-defined networking; give substiture sendto and recvfrom functions,
 * must be called before iaxc_initialize! */
EXPORT void iaxc_set_networking(iaxc_sendto_t st, iaxc_recvfrom_t rf) ;

/* wrapper for libiax2 get_netstats */
EXPORT int iaxc_get_netstats(int call, int *rtt, struct iaxc_netstat *local, struct iaxc_netstat *remote);

#define IAXC_AD_INPUT           (1<<0)
#define IAXC_AD_OUTPUT          (1<<1)
#define IAXC_AD_RING            (1<<2)
#define IAXC_AD_INPUT_DEFAULT   (1<<3)
#define IAXC_AD_OUTPUT_DEFAULT  (1<<4)
#define IAXC_AD_RING_DEFAULT    (1<<5)

struct iaxc_audio_device {
	const char * name;      /* name of the device */
	long capabilities;      /* flags, defined above */
	int devID;              /* driver-specific ID */
};

/* Get audio device information:
 *    **devs: a pointer to an array of device structures, as declared above.  function
 *    will give you a pointer to the proper array, which will be valid as long as iaxc is
 *    initialized.
 *
 *    *nDevs: a pointer to an int, to which the count of devices in the array devs will be
 *    written
 *
 *    *input, *output, *ring: the currently selected devices for input, output, ring will
 *    be written to the int pointed to by these pointers.
 */
EXPORT int iaxc_audio_devices_get(struct iaxc_audio_device **devs, int *nDevs, int *input, int *output, int *ring);
EXPORT int iaxc_audio_devices_set(int input, int output, int ring);

EXPORT float iaxc_input_level_get();
EXPORT float iaxc_output_level_get();
EXPORT int iaxc_input_level_set(float level);
EXPORT int iaxc_output_level_set(float level);


struct iaxc_sound {
	short   *data;           /* sound data */
	long    len;             /* length of sample */
	int     malloced;        /* should the library free() the data after it is played? */
	int     channel;         /* 0 for outputSelected, 1 for ringSelected */
	int     repeat;          /* number of times to repeat (-1 = infinite) */
	long    pos;             /* internal use: current play position */
	int     id;              /* internal use: sound ID */
	struct iaxc_sound *next; /* internal use: next in list */
};

/* play a sound.  sound = an iaxc_sound structure, ring: 0: play through output device; 1: play through "ring" device */
EXPORT int iaxc_play_sound(struct iaxc_sound *sound, int ring);

/* stop sound with ID "id" */
EXPORT int iaxc_stop_sound(int id);


#define IAXC_FILTER_DENOISE     (1<<0)
#define IAXC_FILTER_AGC         (1<<1)
#define IAXC_FILTER_ECHO        (1<<2)
#define IAXC_FILTER_AAGC        (1<<3) /* Analog (mixer-based) AGC */
#define IAXC_FILTER_CN          (1<<4) /* Send CN frames when silence detected */
EXPORT int iaxc_get_filters(void);
EXPORT void iaxc_set_filters(int filters);
EXPORT int iaxc_set_files(FILE *input, FILE *output);

/* speex specific codec settings */
/* a good choice is (1,-1,-1,0,8000,3): 8kbps ABR */
/* Decode options:
 *   decode_enhance: 1/0  perceptual enhancement for decoder
 *   quality: Generally, set either quality (0-9) or bitrate.
 *      -1 for "default"
 *   bitrate: in kbps.  Applies to CBR only; -1 for default.
 *      (overrides "quality" for CBR mode)
 *   vbr: Variable bitrate mode:  0/1
 *   abr mode/rate:  0 for not ABR, bitrate for ABR mode
 *   complexity:  algorithmic complexity.  Think -N for gzip.
 *      Higher numbers take more CPU for better quality.  3 is
 *      default and good choice.
 */
EXPORT void iaxc_set_speex_settings(int decode_enhance, float quality, int bitrate, int vbr, int abr, int complexity);

/*
 * Functions and flags for setting and getting audio callback preferences
 * The application can request to receive local/remote, raw/encoded audio
 * through the callback mechanism. Please note that changing callback
 * settings will overwrite all previous settings.
 */
#define IAXC_AUDIO_PREF_RECV_LOCAL_RAW      (1 << 0)
#define IAXC_AUDIO_PREF_RECV_LOCAL_ENCODED  (1 << 1)
#define IAXC_AUDIO_PREF_RECV_REMOTE_RAW     (1 << 2)
#define IAXC_AUDIO_PREF_RECV_REMOTE_ENCODED (1 << 3)
#define IAXC_AUDIO_PREF_SEND_DISABLE        (1 << 4)

/* Get and set various audio delivery preferences.
 * Returns 0 on success and -1 on error.
 */
EXPORT unsigned int iaxc_get_audio_prefs(void);
EXPORT int iaxc_set_audio_prefs(unsigned int prefs);

/*
 * Acceptable range for video rezolution
 */
#define IAXC_VIDEO_MAX_WIDTH    704
#define IAXC_VIDEO_MAX_HEIGHT   576
#define IAXC_VIDEO_MIN_WIDTH    80
#define IAXC_VIDEO_MIN_HEIGHT   60

/*
 * Video callback preferences
 * The client application can obtain any combination of
 * remote/local, encoded/raw video through the event callback
 * mechanism
 * Use these flags to specify what kind of video do you want to receive
 */

#define IAXC_VIDEO_PREF_RECV_LOCAL_RAW      (1 << 0)
#define IAXC_VIDEO_PREF_RECV_LOCAL_ENCODED  (1 << 1)
#define IAXC_VIDEO_PREF_RECV_REMOTE_RAW     (1 << 2)
#define IAXC_VIDEO_PREF_RECV_REMOTE_ENCODED (1 << 3)
#define IAXC_VIDEO_PREF_SEND_DISABLE        (1 << 4)
/*
 * Use this flag to specify that you want raw video in RGB32 format
 * RGB32: FFRRGGBB aligned 4 bytes per pixel
 * When this flag is set, iaxclient will convert YUV420 raw video into
 * RGB32 before passing it to the main app.
 */
#define IAXC_VIDEO_PREF_RECV_RGB32          (1 << 5)

/*
 * Use this flag to disable/enable camera hardware
 */
#define IAXC_VIDEO_PREF_CAPTURE_DISABLE     (1 << 6)

/*
 * Set video preferences.
 *
 * Please note that this overwrites all previous preferences. In other
 * words, a read-modify-write must be done to change a single preference.
 */

EXPORT unsigned int iaxc_get_video_prefs(void);
EXPORT int iaxc_set_video_prefs(unsigned int prefs);

EXPORT int listVidCapDevices(char *buff, int buffSize);

/*
 * Video format settings
 */
EXPORT void iaxc_video_format_get_cap(int *preferred, int *allowed);
EXPORT void iaxc_video_format_set_cap(int preferred, int allowed);

/* set allowed/preferred video encodings */
EXPORT void iaxc_video_format_set(int preferred, int allowed, int framerate, int bitrate, int width, int height, int fs);

/*
 * Change video params for the current call on the fly
 * This will destroy the existing encoder and create a new one
 * use negative values for parameters that should not change
 */
EXPORT void iaxc_video_params_change(int framerate, int bitrate, int width, int height, int fs);

/* Set holding frame to be used in some kind of video calls */
EXPORT int iaxc_set_holding_frame(char *);

/* Helper function to control use of jitter buffer for video events */
/* TODO: make this a video pref, perhaps? */
EXPORT int iaxc_video_bypass_jitter(int);

/*
 * Check if the default camera is working
 */
EXPORT int iaxc_is_camera_working();

EXPORT void iaxc_YUV420_to_RGB32(int width, int height, char *src, char *dest);

#ifdef __cplusplus
}
#endif

#endif