OS TECHNICAL DOCUMENTATION

Transcription

1 SIP PHONE SDK Microsoft Windows Desktop OS TECHNICAL DOCUMENTATION VERSION 3.4 Page 1 of 199

2 CONTENTS INTRODUCTION AND QUICK START... 6 EXPORTED FUNCTIONS... 7 GetVersionFile()... 7 GetVersionSDK()... 8 AudioDeviceVU()... 9 GetAudioInDevTotal() GetAudioOutDevTotal() GetAudioOutDevName() GetAudioInDevName() Initialize() RegisterToProxy() UnRegisterToProxy() OpenLine() CloseLine() GetVaxErrorCode() GetVaxErrorMsg() DialCall() DisconnectCall() AcceptCall() RejectCall() TransferCallBlind() TransferCallConsult() HoldLine() UnHoldLine() IsOpenLine() IsLineConnected() IsLineHold() IsLineBusy() EnableKeepAlive() DisableKeepAlive() SelectAllVoiceCodec() SelectVoiceCodec() DeselectAllVideoCodec() DeselectVoiceCodec() SelectAllVideoCodec() SelectVideoCodec() DeselectAllVideoCodec() DeselectVideoCodec() DigitDTMF() SetVolumeDTMF() GetVolumeDTMF() ForceDigitDTMF() MuteMic() MuteSpk() MuteLineSpk() MuteLineMic() AutoGainMic() Page 2 of 199

3 AutoGainSpk() SetVolumeMic() GetVolumeMic() SetVolumeSpk() GetVolumeSpk() SetLineVolumeSpk() GetLineVolumeSpk() EchoCancellation() DonotDisturb() IsRecording() StartRecording() StopRecording() IsWaveFilePlaying() PlayWaveOpen() PlayWaveClose() PlayWaveSkipTo PlayWaveTotalTime() PlayWavePause() PlayWaveStart() PlayWaveStop() PlayWavePosition() GetOutboundCodec() GetInboundCodec() SetSessionLostTick() SetUSerAgentSIP() GetUserAgentSIP() SetSubjectSDP() GetSubjectSDP() ConfAllowLine() LineVoiceChannelSpk() ChatAddContact() ChatRemoveContact() ChatFindContact() ChatSendMessageTyping() ChatSendMessageText() ChatSetMyStatus() VoiceChanger() ForwardCall() PlayAddPCM() PlayResetPCM() DetectAMD() AddCustomHeader() RemoveCustomHeader() RemoveCustomHeaderAll() GetCountPacketLost() GetSizeJitterBuffer() GetVideoDevTotal() GetVideoDevName() OpenVideoDev() CloseVideoDev() CryptCOMM() DialCallToREC() OpenLineREC() Page 3 of 199

4 RegisterToProxyREC() UnRegisterToProxyREC() DialRingEnable() DialRingDisable() BusyRingEnable() BusyRingDisable() EnableVideo() GetCallId() IsNetworkAvailable() NetworkReachability() AutoRegistration() VideoCodecBitRate() CaptureStreamPCM() ActivateQosSIP() DeactivateQosSIP() DeactivateQosRTP() ActivateQosRTP() OpenMediaSecondry() CloseMediaSecondry() ChangeMEDIA() EXPORTED EVENTS OnInitialized() OnUnInitialized() OnConnectingToRegister() OnTryingToRegister() OnFailToRegister() OnSuccessToRegister() OnConnectingToReRegister() OnTryingToReRegister() OnFailToReRegister() OnSuccessToReRegister() OnTryingToUnRegister() OnFailToUnRegister() OnSuccessToUnRegister() OnTryingToRegisterREC() OnFailToRegisterREC() OnSuccessToRegisterREC() OnTryingToReRegisterREC() OnFailToReRegisterREC() OnSuccessToReRegisterREC() OnTryingToUnRegisterREC() OnFailToUnRegisterREC() OnSuccessToUnRegisterREC() OnDialCallStarted() OnDialingCall() OnDialCallFailed() OnConnectedCall() OnHungupCall() OnInComingCallStarted() OnInComingCallEnded() OnRingToneStarted() Page 4 of 199

5 OnRingToneEnded() OnTransferCallAccepted() OnTransferCallFailed() OnPlayWaveDone() OnDigitDTMF() OnMsgNOTIFY() OnVoic Msg() OnIncomingDiagnostic() OnOutgoingDiagnostic() OnAudioSessionLost() OnSuccessToHold() OnTryingToHold() OnFailToHold() OnSuccessToUnHold() OnTryingToUnHold() OnFailToUnHold() OnChatContactStatus() OnChatSendMsgTextSuccess() OnChatSendMsgTextFail() OnChatSendMsgTypingSuccess() OnChatSendMsgTypingFail() OnChatRecvMsgText() OnChatRecvMsgTypingStart() OnVoiceStreamPCM() OnDetectAMD() OnHoldCall() OnUnHoldCall() OnVideoRemoteStarted() OnVideoRemoteEnded() OnVideoRemoteFrameRGB() OnVideoDeviceFrameRGB() OnServerConnectingREC() OnServerConnectedREC() OnServerFailedREC() OnServerHungupREC() OnAddCallHistory() OnNetworkReachability() OnAudioDeviceMicVU() OnAudioDeviceSpkVU() Page 5 of 199

6 INTRODUCTION AND QUICK START The VaxVoIP SIP softphone SDK is a software development kit which is used to quickly embed SIP (Session Initiation Protocol) based softphone features to web and software. It provides full support to tailor the softphones features as desired like having your own GUIs or incorporating your brand name. Page 6 of 199

7 EXPORTED FUNCTIONS GetVersionFile() The GetVersionFile() method returns the current version of component file. string GetVersionFile() No parameters. The function returns the files/component file version number. GetVersionFile() GetVersionSDK() Page 7 of 199

8 GetVersionSDK() The GetVersionSDK() method returns the current version of SDK. string GetVersionSDK() No parameters. The function returns the SDK version number. GetVersionSDK() GetVersionFile() Page 8 of 199

9 AudioDeviceVU() The AudioDeviceVU() activates VU (Volume Unit) functionality on a specific audio device (mic or spk). Such method can be used to develop VU meter. boolean AudioDeviceVU(Activate, MicVU, SpkVU) Activate(boolean) The Activate parameter value can be 0 or 1. Assign value 1 to this parameter if you want to activate VU otherwise zero. MicVU(boolean) The MicVU parameter value can be 0 or 1. Assign value 1 to this parameter if you want to activate VU on MICROPHONE device otherwise zero. SpkVU(boolean) The SpkVU parameter value can be 0 or 1. Assign value 1 to this parameter if you want to activate VU on SPEAKER device otherwise zero. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. AudioDeviceVU(1, 1, 0) OnAudioDeviceMicVU(), OnAudioDeviceSpkVU() Page 9 of 199

10 GetAudioInDevTotal() The GetAudioInDevTotal() function provides the total count of input devices attached to device. integer GetAudioInDeviceTotal() No parameters. Total number of audio input devices. GetAudioInDeviceTotal() GetAudioOutDevTotal() Page 10 of 199

11 GetAudioOutDevTotal() The GetAudioOutDevTotal() function provides the total count of output devices attached to device. integer GetAudioOutDeviceTotal() No parameters. Total number of audio output devices. GetAudioOutDeviceTotal() GetAudioInDevTotal() Page 11 of 199

12 GetAudioOutDevName() The GetAudioOutDevName() function returns the name of output audio device for provided device id. string GetAudioOutDevName(DeviceId) DeviceId(integer) This parameter value can be any number from zero to total number of input devices 1. Each number corresponds to a particular audio output device. Device name for corresponding device id, otherwise empty string. GetAudioOutDevName(0) GetAudioInDevName(), GetAudioOutDevTotal(), GetAudioInDevTotal() Page 12 of 199

13 GetAudioInDevName() The GetAudioInDevName() function returns the name of input audio device for provided device id. string GetAudioInDevName(DeviceId) DeviceId(integer) This parameter value can be any number from zero to total number of input devices 1. Each number corresponds to a particular audio input device. Device name for corresponding device id, otherwise empty string. GetAudioInDevName(0) GetAudioOutDevTotal(), GetAudioInDevTotal(), GetAudioOutDevName() Page 13 of 199

14 Initialize() The Initialize() function initializes the VaxVoIP component and once the component is successfully initialized, the user will be able to dial and receive phone calls. boolean Initialize( ListenIP, ListenPort, DisplayName, UserName, AuthLogin, AuthPwd, DomainRealm, ServerAddr, ServerPort, ProxyAddr, ProxyPort, UseSoundDevice ) ListenIP(string) The ListenIP parameter value specifies the IP address of machine on which VaxVoIP is running. ListenPort(integer) The ListenPort parameter specifies the port number for SIP softphone to receive the requests. The standard port is 5060 however any port can be dedicated for this purpose. DisplayName(string) This parameter value specifies the display name for user which is provided by IP-Telephony or VoIP service provider otherwise leave it blank. UserName(string) This parameter value specifies the user name which is provided by IP- Telephony or VoIP service provider otherwise leave it blank. AuthLogin(string) This parameter value specifies the user Login which is provided by IP- Telephony or VoIP service provider. AuthPwd(string) This parameter value specifies the password which is provided by IP- Telephony or VoIP service provider. Page 14 of 199

15 DomainRealm(string) This parameter value specifies the IP/Domain address of the computer on which SIP server is running or provided by IP-Telephony or VoIP service providers. ServerAddr(string) This parameter value specifies the IP/Domain address of the computer on which SIP server is running or provided by IP-Telephony or VoIP service providers. ServerPort(integer) This parameter value specifies the port of the computer on which SIP server is running or provided by IP-Telephony or VoIP service providers, otherwise default port 5060 can be used. ProxyAddr(string) This parameter value specifies the IP/Domain address which is provided by IP-Telephony or VoIP service provider. ProxyPort(integer) This parameter value specifies the port of the computer on which SIP proxy server is running or provided by IP-Telephony or VoIP service providers, otherwise default port 5060 can be used. UseSoundDevice(boolean) The sound devices attached to the system can be captured during component initialization process by setting the value of UseSoundDevice parameter. This can be enabled/disabled by setting UseSoundDevice value 0 or 1. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = Initialize(, 5060, 8002, 8002, 8002, 1234, sip.vaxvoip.com, sip.vaxvoip.com, 5060,, -1, true) If(Result == 0) GetVaxErrorCode() UnInitialize(), GetVaxErrorCode(), GetVaxErrorMsg() Page 15 of 199

16 UnInitialize() The UnInitialize() function releases all the memory/resources that were held during component initialization. UnInitialize() No parameters. No return value. UnInitialize() Initialize() Page 16 of 199

17 RegisterToProxy() The RegisterToProxy() function registers the client to SIP server. The registration with server is mandatory to receive calls however calls can be dialed without registration. boolean RegisterToProxy(Expire) Expire(integer) The Expire parameter specifies the time interval after which the registration with server will be refreshed consequently server will remain updated about the present client status. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. RegisterToProxy(1800) UnRegisterToProxy(), GetVaxErrorCode() Page 17 of 199

18 UnRegisterToProxy() The UnRegisterToProxy() function unregisters/disconnects the client from server. SIP boolean UnRegisterToProxy() No parameters. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. UnRegisterToProxy() RegisterToProxy(), GetVaxErrorCode() Page 18 of 199

19 OpenLine() The OpenLine() function opens a specific line to dial/receive call. As VaxVoIP supports multiple calls simultaneously so this function should be called prior to establishing connection, allowing user to dial/receive new calls on available free line. boolean OpenLine(LineNo, RTPRxIP, RxAudioPortRTP, RxVideoPortRTP) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. RTPRxIP(string) The RTPRxIP parameter value specifies the IP address of computer on which VaxVoIP receives voice streams. The ListenIP and RTPRxIP can be different if a computer has multiple IP addresses. RxAudioPortRTP(integer) The RxAudioPortRTP parameter value specifies the port number to receive voice streams. The Listen ports should be in range of 1024 to for UDP based transmission and for RTP compliance port number should be even. RxVideoPortRTP(integer) The RxVideoPortRTP parameter value specifies the port number to receive video streams. The Listen ports should be in range of 1024 to for UDP based transmission and for RTP compliance port number should be even. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = OpenLine(2,, -1, -1) if (Result==0) GetVaxErrorCode( ) // = auto, -1 = auto CloseLine(), GetVaxErrorCode() Page 19 of 199

20 CloseLine() The CloseLine() function closes the specific line which is no longer in use. This method can be called every time a call is disconnected to close the specific line or all open lines can be closed once at component uninitialization. boolean CloseLine(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. OpenLine(2,, -1, -1) = auto, -1 = auto CloseLine(2) OpenLine(), GetVaxErrorCode() Page 20 of 199

21 GetVaxErrorCode() The GetVaxErrorCode() method returns the error code for the last operation which is failed to execute. integer GetVaxErrorCode() No parameters The function returns error code. Result = Initialize(, 5060, 8002, 8002, 8002, 1234, sip.vaxvoip.com, sip.vaxvoip.com, 5060,, -1, true) If(Result == 0) GetVaxErrorCode() GetVaxErrorMsg() Page 21 of 199

22 GetVaxErrorMsg() The GetVaxErrorMsg() method returns the error text message for the last operation which is failed to execute. string GetVaxErrorMsg() No parameters The function returns error message text. Result = Initialize(, 5060, 8002, 8002, 8002, 1234, sip.vaxvoip.com, sip.vaxvoip.com, 5060,, -1, true) If(Result == 0) GetVaxErrorMsg() GetVaxErrorCode() Page 22 of 199

23 DialCall() The DialCall() function sends call request to SIP server. boolean DialCall( LineNo, CallerName, CallerId, DialNo, InputDeviceId, OutputDeviceId ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. CallerName(string) This parameter specifies the user name to be dialed. CallerId(string) This parameter specifies the user id to be dialed. DialNo(string) This parameter specifies the user name or phone number to be dialed. InputDeviceId(integer) This parameter specifies the id of specific input device to be connected upon dialing call however -1 value can be provided for default input device. OutputDeviceId(integer) This parameter specifies the id of specific output device to be used upon dialing call however -1 value can be provided for default output device. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Page 23 of 199

24 Result = DialCall(2, John, , , -1, -1) if(result == 0) GetVaxErrorCode() Disconnect(), GetAudioOutDevName(), GetAudioInDevName(), GetVaxErrorCode() Page 24 of 199

25 DisconnectCall() The DisconnectCall() function disconnects the specific call in progress. boolean DisconnectCall(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = DisconnectCall(2) if(result == 0) GetVaxErrorCode() DialCall(), Connect(), GetVaxErrorCode() Page 25 of 199

26 AcceptCall() The AcceptCall() function accepts the incoming call. boolean AcceptCall( LineNo, CallId, InputDeviceId, OutputDeviceId ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. CallId(string) The CallId parameter value is a unique identifier for each incoming call. The value of This parameter is generated internally by the system (Incoming call-id, please see OnIncomingCall() event details). InputDeviceId(integer) This parameter specifies the id of specific input device to be connected upon accepting call however -1 value can be provided for default input device. OutputDeviceId(integer) This parameter specifies the id of specific output device to be connected upon accepting call however -1 value can be provided for default output device. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = AcceptCall(0, 24c654c@ , -1, -1) if(result == 0) GetVaxErrorCode() GetAudioOutDevName(), GetAudioInDevName(), RejectCall(), GetVaxErrorCode() Page 26 of 199

27 RejectCall() The RejectCall() function cancels/rejects the incoming call. boolean RejectCall(CallId) CallId(string) The CallId parameter value is a unique identifier for each incoming call. The value of This parameter is generated internally by the system (Incoming call-id, please see OnIncomingCall() event details). The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = RejectCall( 24c654c@ ) if(result == 0) GetVaxErrorCode() AcceptCall(), GetVaxErrorCode() Page 27 of 199

28 TransferCallBlind() The TransferCallBlind() function transfers the call from a specific line to a specific number or user. This function can be used to implement unannounced/blind call transfer i-e transferring the call without notifying the desired party/extension of the impending call. boolean TransferCallBlind( LineNo, ToUserName ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. ToUserName(string) This parameter specifies the to user name or phone number to be dialed. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = TransferCallBlind(2, ) if(result == 0) GetVaxErrorCode() AcceptCall(), GetVaxErrorCode() Page 28 of 199

29 TransferCallConsult() The TransferCallConsult() function sends transfer call consult request to SIP Server and SIP Server links both calls. This function can be used to implement the feature announced/consult call transfer i-e notifying the desired party/extension of the impending call by putting the caller on hold and dialing the desired party/extension. boolean TransferCallConsult( LineNoA, LineNoB ) LineNoA(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. LineNoB(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = TransferCallConsult (1, 3) if(result == 0) GetVaxErrorCode() TransferCallBlind(), GetVaxErrorCode() Page 29 of 199

30 HoldLine() The HoldLine() method puts a specific line on hold. HoldLine(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = HoldLine(3) if(result == 0) GetVaxErrorCode() HoldLine(), GetVaxErrorCode() Page 30 of 199

31 UnHoldLine() The UnHoldLine() function unholds a specific line. boolean UnHoldLine(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = UnHoldLine(2) if(result == 0) GetVaxErrorCode() HoldLine(), GetVaxErrorCode() Page 31 of 199

32 IsOpenLine() The IsOpenLine() function returns open/close status of a specific line. boolean IsOpenLine(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns value 1 (true) if line is open otherwise zero. IsOpenLine(4) OpenLine(), IsLineBusy() Page 32 of 199

33 IsLineConnected() The IsLineConnected() function returns the status of already opened line i-e line is connected or free. boolean IsLineConnected(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns value 1 (true) if line is connected otherwise zero. IsLineConnected(4) OpenLine(), IsOpenLine(), IsLineBusy() Page 33 of 199

34 IsLineHold() The IsLineHold() method returns the HOLD status of a specific line. boolean IsLineHold(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns value 1 (true) if line is on hold otherwise zero. Result = IsLineHold(3) if(result == 0) GetVaxErrorCode() HoldLine(), GetVaxErrorCode() Page 34 of 199

35 IsLineBusy() The IsLineBusy() function checks the status of already opened line i-e line is busy or free. boolean IsLineBusy(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns value 1 (true) if line is busy otherwise zero. IsLineBusy(4) OpenLine(), IsOpenLine() Page 35 of 199

36 EnableKeepAlive() The EnableKeepAlive() function keeps the ports open for connection by sending keep alive packets periodically. It helps to keep the ports open at NAT/firewall end. boolean EnableKeepAlive(Seconds) Seconds(integer) This Seconds parameter value specifies the time interval in seconds after which keep alive packets will be sent to keep the port open for connection. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. OpenLine(2, , 7006, 7008) EnableKeepAlive(10) DisableKeepAlive(), GetVaxErrorCode() Page 36 of 199

37 DisableKeepAlive() The DisableKeepAlive() method stops sending keep-alive packets i-e it disables the functionality of EnableKeepAlive() method. void DisableKeepAlive() No parameters. No return value. DisableKeepAlive() EnableKeepAlive(), GetVaxErrorCode() Page 37 of 199

38 SelectAllVoiceCodec() The SelectAllVoiceCodec() function selects all the voice codec. void SelectAllVoiceCodec() No parameters. No return value. SelectAllVoiceCodec() DeselectAllVoiceCodec(), GetVaxErrorCode() Page 38 of 199

39 SelectVoiceCodec() The SelectVoiceCodec() function selects a voice codec for provided codec number. The function can be called multiple times to select more than one voice codec. Moreover the sequence of selection of voice codec decides the priority of codec i-e the voice codec selected first has higher priority than the codec selected afterward. boolean SelectVoiceCodec(CodecNo) CodecNo(integer) This parameter value ranges from 0-4 and each value corresponds to a particular voice codec. VaxVoIP SIP SDK supports the following voice codecs: 0 = G711 U-Law 1 = G711 A-Law 2 = GSM = ilbc 4 = G729 The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. DeselectAllVoiceCodec() SelectVoiceCodec(4) SelectVoiceCodec(1) SelectVoiceCodec(2) SelectVoiceCodec(3) In this example G729 has the highest priority where as ilbc has Lowest priority. DeselectVoiceCodec(), GetVaxErrorCode() Page 39 of 199

40 DeselectAllVideoCodec() The DeselectAllVideoCodec() function deselects all the video codec options. void DeselectAllVideoCodec() No parameters. No return value. DeselectAllVideoCodec() SelectAllVideoCodec(), GetVaxErrorCode() Page 40 of 199

41 DeselectVoiceCodec() The DeselectVoiceCodec() function deselects a voice codec for provided codec number. boolean DeselectVoiceCodec(CodecNo) CodecNo(integer) This parameter value ranges from 0-4 and each value corresponds to a particular voice codec. VaxVoIP SIP SDK supports the following voice codecs: 0 = G711 U-Law 1 = G711 A-Law 2 = GSM = ilbc 4 = G729 The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = DeselectVoiceCodec(1) if(result == 0) GetVaxErrorCode() SelectVoiceCodec(), GetVaxErrorCode() Page 41 of 199

42 SelectAllVideoCodec() The SelectAllVideoCodec() function selects all the VaxVoIP SDK s supported video codecs. void SelectAllVideoCodec() No parameters. No return value. SelectAllVideoCodec() DeselectAllVideoCodec(), GetVaxErrorCode() Page 42 of 199

43 SelectVideoCodec() The SelectVideoCodec() function selects a video codec for provided codec number. The function can be called multiple times to select more than one video codec. Moreover the sequence of selection of video codec decides the priority of codec i-e the video codec selected first has higher priority than the codec selected afterward. boolean SelectVideoCodec(CodecNo) CodecNo(integer) This parameter value ranges from 0-2 and each value corresponds to a particular video codec. VaxVoIP SIP SDK supports the following video codecs: 0 = VP8 1 = H263 2 = H263+ The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. DeselectAllVideoCodec() SelectVideoCodec(0) SelectVideoCodec(2) In this example VP8 has the highest priority where as H263+ has lowest priority DeselectVideoCodec(), GetVaxErrorCode() Page 43 of 199

44 DeselectAllVideoCodec() The DeselectAllVideoCodec() function deselects all the video codec options. void DeselectAllVideoCodec() No parameters. No return value. DeselectAllVideoCodec() SelectAllVideoCodec(), GetVaxErrorCode() Page 44 of 199

45 DeselectVideoCodec() The DeselectVideoCodec() function deselects a video codec for provided codec number. boolean DeselectVideoCodec(CodecNo) CodecNo(integer) This parameter value ranges from 0-2 and each value corresponds to a particular video codec. VaxVoIP SIP SDK supports the following video codecs: 0 = VP8 1 = H263 2 = H263+ The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = DeselectVideoCodec(1) if(result == 0) GetVaxErrorCode() SelectVideoCodec(), GetVaxErrorCode() Page 45 of 199

46 DigitDTMF() The DigitDTMF() function sends DTMF digit to the remote end SIP server. This method can also be used to play DTMF tones. boolean DigitDTMF( LineNo, Digit ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. Digit(string) This parameter value specifies any digit that has been pressed. (1, 2, 3, 4, 5,... 0, *, #). The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. DigitDTMF(1, 3 ) SetVolumeDTMF(), GetVolumeDTMF() Page 46 of 199

47 SetVolumeDTMF() The SetVolumeDTMF() function adjusts the volume of DTMF tones. boolean SetVolumeDTMF(Volume) Volume(integer) This parameter specifies the volume level for DTMF tones ranges between The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. SetVolumeDTMF(6) DigitDTMF(), GetVolumeDTMF() Page 47 of 199

48 GetVolumeDTMF() The GeVolumeDTMF() function returns the volume level of DTMF tones. integer GeVolumeDTMF() No parameters. The function returns the volume of DTMF tones ranges between SeVolumeDTMF(6) GeVolumeDTMF() DigitDTMF(), SeVolumeDTMF() Page 48 of 199

49 ForceDigitDTMF() The ForceDigitDTMF() function can be used to adjust the DTMF type. boolean ForceDigitDTMF( LineNo, TypeId, Enable ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. TypeId(integer) This parameter value specifies the Type Id. The supported types are: 0 = RFC2833 TYPE 1 = SIP INFO TYPE 2 = INBAND or VOICE TYPE Enable(boolean) This parameter value enables/disables the DTMF type. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. ForceDigitDTMF(1, 0, true) SetVolumeDTMF(), GetVolumeDTMF() Page 49 of 199

50 MuteMic() The MuteMic() function mutes the microphone. Call to MuteMic() method does not affect the Master Mute Control. It simply starts sending silence data. boolean MuteMic(Mute) Mute(boolean) The Mute parameter value can be 0 or 1. Assign value 1 to This parameter to mute the microphone otherwise zero. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. MuteMic(0) MuteMic(1) MuteSpk(), GetVaxErrorCode() Page 50 of 199

51 MuteSpk() The MuteSpk() function mutes the speaker. Call to MuteSpk() does not affect the Master Mute Control. boolean MuteSpk(Mute) Mute(boolean) The Mute parameter value can be 0 or 1. Assign value 1 to This parameter to mute the speaker otherwise zero. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. MuteSpk(0) MuteSpk(1) MuteMic(), GetVaxErrorCode() Page 51 of 199

52 MuteLineSpk() The MuteLineSpk() method mutes output voice stream of specific line. boolean MuteLineSpk( LineNo, Mute, ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. Mute(boolean) The Enable parameter value can be 0 or 1. Assign value 1 to This parameter to mute output voice stream otherwise zero. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. MuteLineSpk(2, 0) MuteLineSpk(2, 1) MuteLineMic(), GetVaxErrorCode() Page 52 of 199

53 MuteLineMic() The MuteLineMic() method mutes input voice stream of specific line. boolean MuteLineMic( LineNo, Mute ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. Mute(boolean) The Enable parameter value can be 0 or 1. Assign value 1 to This parameter to mute input voice stream otherwise zero. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. MuteLineMic(2, 0) MuteLineMic(2, 1) MuteLineSpk(), GetVaxError Page 53 of 199

54 AutoGainMic() The AutoGainMic() method enables auto gain functionality on outgoing voice stream. boolean AutoGainMic( Enable, Volume ) Enable(boolean) This parameter value enables/disables AGC functionality. Volume(integer) This parameter value specifies volume level ranges between [0-255] The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. AutoGainMic(1, 150) AutoGainSpk(), GetVaxError Page 54 of 199

55 AutoGainSpk() The AutoGainSpk() method enables auto gain functionality on incoming voice stream. boolean AutoGainSpk( Enable, Volume ) Enable(boolean) This parameter value enables/disables AGC functionality. Volume(integer) This parameter value specifies volume level ranges between [0-255] The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. AutoGainSpk(0, 100) AutoGainMic(), GetVaxErrorCode() Page 55 of 199

56 SetVolumeMic() The SetVolumeMic() function sets the volume of input voice stream. The microphone volume ranges between 0-255(0 = Min Volume, 255 = Max Volume). boolean SetVolumeMic(Volume) Volume(integer) This parameter value specifies volume level ranges between [0-255]. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = SetVolumeMic(200) if(result == 0) GetVaxErrorCode() GetVolumeSpk(), SetVolumeSpk(), GetVolumeMic() Page 56 of 199

57 GetVolumeMic() The GetVolumeMic() function returns the microphone volume. The microphone volume ranges between (0 = Min Volume, 255 = Max Volume). integer GetVolumeMic() No parameters. The function returns microphone volume on its successful execution otherwise -1. GetVolumeMic() GetVolumeSpk(), SetVolumeSpk(), SetVolumeMic() Page 57 of 199

58 SetVolumeSpk() The SetVolumeSpk() function sets the volume of output voice stream. The speaker volume ranges between 0-255(0 = Min Volume, 255 = Max Volume). boolean SetVolumeSpk(Volume) Volume(integer) This parameter value specifies volume level ranges between [0-255]. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = SetVolumeSpk(150) if(result == 0) GetVaxErrorCode() GetVolumeSpk(), GetVaxErrorCode() Page 58 of 199

59 GetVolumeSpk() The GetVolumeSpk() function returns the speaker volume. The speaker volume ranges between (0 = Min Volume, 255 = Max Volume). integer GetVolumeSpk() No parameters. The function returns speaker volume on its successful execution otherwise -1. GetVolumeSpk() MuteSpk(), SetVolumeSpk() Page 59 of 199

60 SetLineVolumeSpk() The SetLineVolumeSpk() function adjusts the output volume of a specific line without affecting the operating system master volume control. boolean SetLineVolumeSpk( LineNo, Volume ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. Volume(integer) This parameter value specifies volume level ranges between [0-255]. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = SetLineVolumeSpk(2, 200) if(result == 0) GetVaxErrorCode() GetLineVolumeSpk() Page 60 of 199

61 GetLineVolumeSpk() The GetLineVolumeSpk() function returns the output volume of a specific line. The speaker volume ranges between (0 = Min Volume, 255 = Max Volume). integer GetLineVolumeSpk(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns speaker volume on its successful execution otherwise -1. GetLineVolumeSpk(2) SetLineVolumeSpk(), SetVolumeSpk() Page 61 of 199

62 EchoCancellation() The EchoCancellation() enables the significant suppression of echo and any background noise. By default this is enabled to provide high quality of output speech. boolean EchoCancellation(Enable) Enable(boolean) This parameter value can be 0 or 1. Assign value 1 to enable the AEC or 0 to disable it. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. EchoCancellation(1) DonotDisturb(), GetVaxErrorCode() Page 62 of 199

63 DonotDisturb() The DonotDisturb() enables don t disturb functionality. boolean DonotDisturb(Enable) Enable(boolean) This parameter value can be 0 or 1. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. DonotDisturb(1) EchoCancellation(), GetVaxErrorCode() Page 63 of 199

64 IsRecording() The IsRecording() function checks if recording is enabled or not on a specific line. boolean IsRecording(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns value 1(true) if recording is enabled on provided line otherwise 0(false). IsRecording(6) StartRecording(), StopRecording(), GetVaxErrorCode() Page 64 of 199

65 StartRecording() The StartRecording() function starts recording voice stream on specific line. boolean StartRecording( LineNo, FileName, RecordVoice ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. FileName(string) This parameter value specifies wave file name to be saved. RecordVoice(integer) This parameter value specifies the recording mode. It can have three values and each value corresponds to a particular recording mode. 0=Record outgoing only 1=Record incoming only 2=Record both The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. StartRecording(3,, test.wav, 2) IsRecording(), StopRecording(), GetVaxErrorCode() Page 65 of 199

66 StopRecording() The StopRecording() function stops the recording of voice stream on specific line. boolean StopRecording(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. StopRecording(4) StartRecording(), IsRecording(), GetVaxErrorCode() Page 66 of 199

67 IsWaveFilePlaying() The IsWaveFilePlaying() function checks whether the wave file playing is in progress or not on provided line. boolean IsWaveFilePlaying(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns value 1(true) if wave file is playing on provided line otherwise it returns 0(false). IsWaveFilePlaying(2) PlayWaveOpen(), PlayWaveStart(), PlayWaveStop(), PlayWaveSkipTo(), GetVaxErrorCode() Page 67 of 199

68 PlayWaveOpen() The PlayWaveOpen() function makes the wave file ready/set to play int a call. boolean PlayWaveOpen( LineNo, FileName ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. FileName(string) This parameter value specifies wave file name to be played. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = PlayWaveOpen(6, test.wav ) if(result == 0) GetVaxErrorCode() IsWaveFilePlaying(), PlayWaveStart(), PlayWaveStop(), PlayWaveSkipTo(), GetVaxErrorCode() Page 68 of 199

69 PlayWaveClose() The PlayWaveClose() function vacates all the resources that were held by PlayWaveOpen() function. boolean PlayWaveClose(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. PlayWaveOpen(6, test.wav ) Result = PlayWaveClose(6) if(result == 0) GetVaxErrorCode() PlayWaveOpen(), PlayWaveStart(), PlayWaveStop(), PlayWaveSkipTo(), GetVaxErrorCode() Page 69 of 199

70 PlayWaveSkipTo() The PlayWaveSkipTo() function changes the position of playing cursor to the new position. boolean PlayWaveSkipTo( LineNo, MilliSeconds ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. MilliSeconds(integer) This parameter value specifies the time in milli-seconds to be skipped of playing wave file. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = PlayWaveSkipTo(4, 1000) if(result == 0) GetVaxErrorCode() PlayWaveOpen(), PlayWaveClose(), PlayWaveStop(), PlayWaveStart(), GetVaxErrorCode() Page 70 of 199

71 PlayWaveTotalTime() The PlayWaveTotalTime() function returns the total playing time of a wave file on provided line. integer PlayWaveTotalTime(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns total playing time in milli-seconds of wave file otherwise 0. Result = PlayWaveTotalTime(4) PlayWaveOpen(), PlayWaveClose(), PlayWaveStop(), PlayWaveStart(), PlayWavePause(), GetVaxErrorCode() Page 71 of 199

72 PlayWavePause() The PlayWavePause() method pauses the playing wave file on its current position. boolean PlayWavePause(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = PlayWavePause(1) if(result == 0) GetVaxErrorCode() PlayWaveOpen(), PlayWaveClose(), PlayWaveStop(), PlayWaveStart(), PlayWaveSkipTo(), GetVaxErrorCode() Page 72 of 199

73 PlayWaveStart() The PlayWaveStart() method starts playing the already set wave file on provided line. The following sequence of execution starts playing the wave file. PlayWaveOpen() PlayWaveStart() It starts sending wave file data to the remote end, value listen = 1 starts sending and playing (on sound card) wave file data at the same time. boolean PlayWaveStart( LineNo, Listen ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. Listen(boolean) This parameter value can be 0 or 1. To play wave file just to remote end set its value 0 or sets its value 1 to play wave file to both remote end and sound card. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = PlayWaveStart(0, 0) if(result == 0) GetVaxErrorCode() PlayWaveOpen(), PlayWaveClose(), PlayWaveStop(), PlayWaveSkipTo(), GetVaxErrorCode() Page 73 of 199

74 PlayWaveStop() The PlayWaveStop() function stops playing the wave file on provided line and change the position of playing cursor at the beginning of file. boolean PalyWaveStop(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = PlayWaveStop(2) if(result == 0) GetVaxErrorCode() PlayWaveOpen(), PlayWaveClose(), PlayWavePause(), PlayWaveStart(), PlayWaveSkipTo(), GetVaxErrorCode() Page 74 of 199

75 PlayWavePosition() The PlayWavePosition() method gets the current position of playing cursor. integer PlayWavePosition(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. The function returns current position in milli-seconds of playing cursor otherwise -1. PlayWaveOpen(4, test.wav ) PlayWaveStart(4, 0) Result = PlayWavePosition(4) if(result == -1) GetVaxErrorCode() PlayWaveOpen(), PlayWaveClose(), PlayWaveStop(), PlayWaveStart(), PlayWaveSkipTo(), GetVaxErrorCode() Page 75 of 199

76 GetOutboundCodec() The GetOutboundCodec() gets the codec number for the outbound voice stream of provided line. integer GetOutboundCodec(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. VaxVoIP SIP SDK support the following voice codecs: 0 = G711 A-Law 1 = G711 U-Law 2 = GSM = ilbc 4 = G729 The function returns a codec number on its successful execution otherwise -1. Result = GetOutboundCodec(1) if(result == -1) GetVaxErrorCode() GetInboundCodec(), GetVaxErrorCode() Page 76 of 199

77 GetInboundCodec() The GetInboundCodec() gets the codec number for provided line. the Inbound voice stream of integer GetInboundCodec(LineNo) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. VaxVoIP SIP SDK support the following voice codecs: 0 = G711 A-Law 1 = G711 U-Law 2 = GSM = ilbc 4 = G729 The function returns a codec number on its successful execution otherwise -1. Result = GetInBoundCodec(5) if(result == -1) GetVaxErrorCode() GetOutboundCodec(), GetVaxErrorCode() Page 77 of 199

78 SetSessionLostTick() The SetSessionLostTick() function sets the specific time interval to check whether voice session is still intact or lost. NOTE: Due to some reasons, if VaxVoIP does not receives the voice stream for a specific interval of time then it triggers OnAudioSessionLost() event. void SetSessionLostTicket(Second) Second(integer) This parameter value specifies the session lost time in seconds. No return value. SetSessionLostTick(2) OnAudioSessionLost() Page 78 of 199

79 SetUSerAgentSIP() The SetUserAgentSIP() function sets the user agent field of SIP packet. boolean SetUserAgentSIP(UserAgentName) UserAgentName(string) This parameter value specifies the User agent Name. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = SetUserAgentSIP( abc ) if(result == 0) GetVaxErrorCode() GetUserAgentSIP(), GetVaxErrorCode() Page 79 of 199

80 GetUserAgentSIP() The GetUserAgentSIP() function returns the user agent field of SIP packet. string GetUserAgentSIP() No parameters. The function returns the user agent name otherwise empty string. GetUserAgentSIP() SetUserAgentSIP() Page 80 of 199

81 SetSubjectSDP() The SetSubjectSDP() function sets the subject field of SIP packet. boolean SetSubjectSDP(SubjectSDP) SubjectSDP(string) This parameter specifies the value that is to be set as subject of SIP packet. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. SetSubjectSDP( xyz ) GetSubjectSDP() Page 81 of 199

82 GetSubjectSDP() The GetSubjectSDP() function returns the subject field previously set by SetSubjectSDP() method. string GetSubjectSDP() No parameters. The function returns the subject. GetSubjectSDP() SetSubjectSDP() Page 82 of 199

83 ConfAllowLine() The ConfAllowLine() function allows multiple users to speak/listen in conference. This feature of VaxVoIP componnet can be used for supervision of operators at call centers in real time. boolean ConfAllowLine( LineNo, AllowListen, AllowSpeak ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. AllowListen(boolean) This parameter value can be 0 or 1. To allow user on specific line to listen in conference sets This parameter value to 1 otherwise 0. AllowSpeak(boolean) This parameter value can be 0 or 1. To allow user on specific line to speak in conference sets This parameter value to 1 otherwise 0. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. ConfAllowLine(1,0,1) ConfAllowLine(3,1,0 LineVoiceChannelSpk() Page 83 of 199

84 LineVoiceChannelSpk() The LineVoiceChannelSpk() function enables/disables the right and left speaker on specific line. boolean LineVoiceChannelSpk( LineNo, Channel ) LineNo(integer) This parameter value specifies the specific line. The LineNo value is a unique number to identify a specific line. Channel(integer) This parameter value specifies which speaker to be enabled /disabled. 0 = Enable Left Speaker 1 = Enable Right Speaker 2 = Enable both The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = LineVoiceChannelSpk(2, 1) if(result == 0) GetVaxtError() MuteSpk(), MuteLineSpk() Page 84 of 199

85 ChatAddContact() The ChatAddContact() methods adds a contact to receive contact present status e.g online, busy, idle etc. boolean ChatAddContact(UserName) UserName(string) This parameter value specifies the user name to be added to chat. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. Result = ChatAddContact( abc ) if(result == 0) GetVaxErrorCode() ChatRemoveContact(), GetVaxErrorCode() Page 85 of 199

86 ChatRemoveContact() The ChatRemoveContact() method removes a contact that was already added using ChatAddContact() method. boolean ChatRemoveContact(UserName) UserName(string) This parameter value specifies the user name to be removed from chat. The function returns a Non-zero value on its successful execution otherwise 0, a specific error code can be retrieved by calling GetVaxErrorCode() method. ChatAddContact( abc ) ChatRemoveContact( abc ) ChatAddContact(), GetVaxErrorCode() Page 86 of 199