Class SIPClientConfiguration
- java.lang.Object
-
- com.avaya.clientservices.provider.sip.SIPClientConfiguration
-
public class SIPClientConfiguration extends java.lang.ObjectConfiguration data that is common for a SIP Client.
-
-
Constructor Summary
Constructors Constructor Description SIPClientConfiguration()
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description intgetFailedSessionRemovalTimeout()The number of seconds the session line appearance will be displayed after an invalid extension has been dialed if the user does not press the End Call softkey.intgetFastResponseTimeout()Get the length of time that the SIP stack will wait for a provisional response on INVITE requests.intgetInterDigitTimeout()The number of seconds that the telephone will wait after a digit is dialed before sending a SIP INVITE.Layer2PriorityMarkinggetLayer2PriorityMarking()The layer 2 priority marking value as per IEEE 802.1p requirements to be for signaling frames generated by the endpoint.intgetLineReservationTimeout()Get the line reservation time during which line stays reserved (in seconds).intgetLocalVideoResponseTimeout()Get the local video response timeout (in seconds).intgetMaxForwardLimit()Get the max forward limit as indicated in the Max-Forwards SIP header.intgetNoDigitTimeout()The number of seconds that the telephone will wait for a digit to be dialed after going off-hook before generating a warning tone.intgetPeriodicRingbackTimeout()Get the default time to re-transmit 180 Ringing while in alerting state (in seconds).intgetPublishTimeout()Get the default publish timeout (in seconds).intgetRegistrationTimeout()Get the default registration timeout (in seconds).intgetSessionRefreshTimeout()Get the session refresh timeout (in seconds).intgetSignalingDSCP()Get the layer 3 Differentiated Services (DiffServ) Code Point used for signaling frames generated by the endpoint.intgetSubscriptionTimeout()Get the default subscription timeout (in seconds).intgetTotalRingbackTimeout()Get the maximum default time that an incoming session stays in the alerting state (in seconds).intgetTransferCompletionTimeout()Get the maximum wait time for completion of call transfer with 200 OK sipfrag notify after REFER is accepted.intgetWaitTimeForCallCancel()Get the maximum wait time for completion of call cancellation.booleanisAutomaticDSCPConfigurationEnabled()Boolean value indicating whether the DSCP tagging values will be updated or notbooleanisExactSIPDomainComparison()* Is the exact SIP domain comparison algorithm used? *booleanisReliableProvisionalResponsesEnabled()Are reliable provisional responses enabled?booleanisSelectCodecBasedOnCallerPreferences()Is the codec selection on the answerer side done based on the codec preferences of the calling UA or the answering UA?booleanisSIPSAndSRTPCouplingEnabled()Deprecated.Use theSIPUserConfiguration.isUseSIPSURIOverTLSEnabled()method instead.voidsetAutomaticDSCPConfigurationEnabled(boolean automaticDscpConfigurationEnabled)Enables or disables the ability to update DSCP tagging values with PPM for signaling.voidsetExactSIPDomainComparison(boolean exactSIPDomainComparison)* Used for SIP domain comparison.voidsetFailedSessionRemovalTimeout(int failedSessionRemovalTimeout)voidsetFastResponseTimeout(int fastResponseTimeout)Set the length of time that the SIP stack will wait for a provisional response on INVITE requests.voidsetInterDigitTimeout(int interDigitTimeout)voidsetLayer2PriorityMarking(Layer2PriorityMarking layer2PriorityMarking)Set the layer 2 priority marking value as per IEEE 802.1p requirements to be used for signaling frames generated by the endpoint.voidsetLineReservationTimeout(int lineReservationTimeout)Set the line reservation time during which line stays reserved (in seconds).voidsetLocalVideoResponseTimeout(int localVideoResponseTimeout)Set the local video response timeout (in seconds).voidsetMaxForwardLimit(int maxForwardLimit)Set the max forward limit as indicated in the Max-Forwards SIP header.voidsetNoDigitTimeout(int noDigitTimeout)voidsetPeriodicRingbackTimeout(int periodicRingbackTimeout)voidsetPublishTimeout(int publishTimeout)Set the default publish timeout (in seconds).voidsetRegistrationTimeout(int registrationTimeout)Set the default registration timeout (in seconds).voidsetReliableProvisionalResponsesEnabled(boolean reliableProvisionalResponsesEnabled)Set whether reliable provisional responses are enabled.voidsetSelectCodecBasedOnCallerPreferences(boolean selectCodecBasedOnCallerPreferences)Set whether the codec selection on the answerer side done based on the codec preferences of the calling UA or the answering UA.voidsetSessionRefreshTimeout(int sessionRefreshTimeout)Set the session refresh timeout (in seconds).voidsetSignalingDSCP(int signalingDscp)Set the layer 3 Differentiated Services (DiffServ) Code Point to be used for signaling frames generated by the endpoint.voidsetSIPSAndSRTPCouplingEnabled(boolean sipsAndSrtpCouplingEnabled)Deprecated.Use theSIPUserConfiguration.setUseSIPSURIOverTLSEnabled(boolean)method instead.voidsetSubscriptionTimeout(int subscriptionTimeout)Set the default subscription timeout (in seconds).voidsetTotalRingbackTimeout(int totalRingbackTimeout)Set the maximum default time that an incoming session stays in the alerting state (in seconds).voidsetTransferCompletionTimeout(int transferCompletionTimeout)Set the maximum wait time for completion of call transfer with 200 OK sipfrag notify after REFER is accepted.voidsetWaitTimeForCallCancel(int waitTimeForCallCancel)Set the maximum wait time for completion of call cancellation.
-
-
-
Method Detail
-
getSignalingDSCP
public int getSignalingDSCP()
Get the layer 3 Differentiated Services (DiffServ) Code Point used for signaling frames generated by the endpoint.The default is 24 - Class Selector 3 (CS3).
- Returns:
- The DSCP value used for signaling.
-
setSignalingDSCP
public void setSignalingDSCP(int signalingDscp)
Set the layer 3 Differentiated Services (DiffServ) Code Point to be used for signaling frames generated by the endpoint.- Parameters:
signalingDscp- The DSCP value to be used for signaling.
-
setAutomaticDSCPConfigurationEnabled
public void setAutomaticDSCPConfigurationEnabled(boolean automaticDscpConfigurationEnabled)
Enables or disables the ability to update DSCP tagging values with PPM for signaling. When it is enabled the values that come from PPM will be set for the next tag, and if it is disabled then the tagging values will be the ones set by the client, or default ones if none was set.The default is true.
- Parameters:
automaticDscpConfigurationEnabled- Indicates if enabled.- See Also:
isAutomaticDSCPConfigurationEnabled()
-
isAutomaticDSCPConfigurationEnabled
public boolean isAutomaticDSCPConfigurationEnabled()
Boolean value indicating whether the DSCP tagging values will be updated or not- Returns:
- True if dscp enabled, False otherwise.
- See Also:
setAutomaticDSCPConfigurationEnabled(boolean)
-
getLayer2PriorityMarking
public Layer2PriorityMarking getLayer2PriorityMarking()
The layer 2 priority marking value as per IEEE 802.1p requirements to be for signaling frames generated by the endpoint.The default is Layer2PriorityMarking.BEST_EFFORT.
- Returns:
- The layer 2 priority marking value to be used for signaling.
-
setLayer2PriorityMarking
public void setLayer2PriorityMarking(Layer2PriorityMarking layer2PriorityMarking)
Set the layer 2 priority marking value as per IEEE 802.1p requirements to be used for signaling frames generated by the endpoint.802.1p tagging is not supported on generic non-Vantage Android devices.
- Parameters:
layer2PriorityMarking- The layer 2 priority marking value to be used for signaling.
-
getMaxForwardLimit
public int getMaxForwardLimit()
Get the max forward limit as indicated in the Max-Forwards SIP header.The default is 70.
- Returns:
- The max forward limit set in new outgoing SIP requests.
-
setMaxForwardLimit
public void setMaxForwardLimit(int maxForwardLimit)
Set the max forward limit as indicated in the Max-Forwards SIP header.- Parameters:
maxForwardLimit- The new max forward limit to use.
-
getRegistrationTimeout
public int getRegistrationTimeout()
Get the default registration timeout (in seconds).The default is 3600 (1 hour).
- Returns:
- The registration timeout in seconds.
-
setRegistrationTimeout
public void setRegistrationTimeout(int registrationTimeout)
Set the default registration timeout (in seconds).- Parameters:
registrationTimeout- The new registration timeout to use.
-
getSubscriptionTimeout
public int getSubscriptionTimeout()
Get the default subscription timeout (in seconds).The default is 3600 (1 hour).
- Returns:
- The subscription timeout in seconds.
-
setSubscriptionTimeout
public void setSubscriptionTimeout(int subscriptionTimeout)
Set the default subscription timeout (in seconds).- Parameters:
subscriptionTimeout- The new subscription timeout to use.
-
getPublishTimeout
public int getPublishTimeout()
Get the default publish timeout (in seconds).The default is 3600 (1 hour).
- Returns:
- The publish timeout in seconds.
-
setPublishTimeout
public void setPublishTimeout(int publishTimeout)
Set the default publish timeout (in seconds).- Parameters:
publishTimeout- The new publish timeout to use.
-
getSessionRefreshTimeout
public int getSessionRefreshTimeout()
Get the session refresh timeout (in seconds).The default is 0 (feature disabled).
- Returns:
- The session refresh timeout in seconds.
-
setSessionRefreshTimeout
public void setSessionRefreshTimeout(int sessionRefreshTimeout)
Set the session refresh timeout (in seconds). It is not recommended to enable this feature in Avaya (Aura, IPO) deployment. If session refresh is enabled, active call might be ended automatically without media preservation in case session expires due to refresh failure. Default value 0 means Session Timer is disabled. Session refresh timeout have to be equal or more than 90 seconds. Otherwise user creatioin will be failed.- Parameters:
sessionRefreshTimeout- The new session refresh timeout to use.
-
getPeriodicRingbackTimeout
public int getPeriodicRingbackTimeout()
Get the default time to re-transmit 180 Ringing while in alerting state (in seconds).The default is 60 (1 minute).
- Returns:
- The default time for retransmitting 180 Ringing in the alerting state in seconds.
-
setPeriodicRingbackTimeout
public void setPeriodicRingbackTimeout(int periodicRingbackTimeout)
-
getTotalRingbackTimeout
public int getTotalRingbackTimeout()
Get the maximum default time that an incoming session stays in the alerting state (in seconds).The default is 180 (3 minutes).
- Returns:
- The maximum timeout for the alerting state in seconds.
-
setTotalRingbackTimeout
public void setTotalRingbackTimeout(int totalRingbackTimeout)
Set the maximum default time that an incoming session stays in the alerting state (in seconds).- Parameters:
totalRingbackTimeout- The new maximum timeout for the alerting state in seconds.
-
getWaitTimeForCallCancel
public int getWaitTimeForCallCancel()
Get the maximum wait time for completion of call cancellation.The default is 5.
- Returns:
- The maximum wait time for completion of call cancellation.
-
setWaitTimeForCallCancel
public void setWaitTimeForCallCancel(int waitTimeForCallCancel)
Set the maximum wait time for completion of call cancellation.- Parameters:
waitTimeForCallCancel- The new maximum wait time for completion of call cancellation to use.
-
getTransferCompletionTimeout
public int getTransferCompletionTimeout()
Get the maximum wait time for completion of call transfer with 200 OK sipfrag notify after REFER is accepted.The default is 185.
- Returns:
- The maximum wait time for completion of call transfer.
-
setTransferCompletionTimeout
public void setTransferCompletionTimeout(int transferCompletionTimeout)
Set the maximum wait time for completion of call transfer with 200 OK sipfrag notify after REFER is accepted.- Parameters:
transferCompletionTimeout- The new maximum wait time for completion of call transfer to use.
-
getLocalVideoResponseTimeout
public int getLocalVideoResponseTimeout()
Get the local video response timeout (in seconds).This is the time waited for a local response to the incoming video request before automatically denying the request.
The default is 15.
- Returns:
- The local video response timeout in seconds.
-
setLocalVideoResponseTimeout
public void setLocalVideoResponseTimeout(int localVideoResponseTimeout)
Set the local video response timeout (in seconds).- Parameters:
localVideoResponseTimeout- The new local video response timeout in seconds to use.
-
getLineReservationTimeout
public int getLineReservationTimeout()
Get the line reservation time during which line stays reserved (in seconds).The default is 30.
- Returns:
- The line reservation timeout in seconds.
-
setLineReservationTimeout
public void setLineReservationTimeout(int lineReservationTimeout)
Set the line reservation time during which line stays reserved (in seconds).- Parameters:
lineReservationTimeout- Thew new line reservation timeout in seconds to use.
-
getFastResponseTimeout
public int getFastResponseTimeout()
Get the length of time that the SIP stack will wait for a provisional response on INVITE requests.The default is 5.
- Returns:
- The fast response timeout.
-
setFastResponseTimeout
public void setFastResponseTimeout(int fastResponseTimeout)
Set the length of time that the SIP stack will wait for a provisional response on INVITE requests.- Parameters:
fastResponseTimeout- Set the new fast response timeout.
-
isSelectCodecBasedOnCallerPreferences
public boolean isSelectCodecBasedOnCallerPreferences()
Is the codec selection on the answerer side done based on the codec preferences of the calling UA or the answering UA?The default is
true, meaning the common codec is selected based on the preferences of the calling UA.- Returns:
trueif the common codec is selected based on the calling UA's preferences,falseif it is selected based on the answering UA's preferences.
-
setSelectCodecBasedOnCallerPreferences
public void setSelectCodecBasedOnCallerPreferences(boolean selectCodecBasedOnCallerPreferences)
Set whether the codec selection on the answerer side done based on the codec preferences of the calling UA or the answering UA.- Parameters:
selectCodecBasedOnCallerPreferences- Iftrue, the common codec is selected based on the calling UA's preferences. Iffalse, it is selected based on the answering UA's preferences.
-
isSIPSAndSRTPCouplingEnabled
@Deprecated public boolean isSIPSAndSRTPCouplingEnabled()
Deprecated.Use theSIPUserConfiguration.isUseSIPSURIOverTLSEnabled()method instead. Starting with Client SDK 3.1.Are SIPS and SRTP coupled?The SIPS mechanism is used to secure the signaling, while SRTP is used to secure the media. If
true, do not offer secure media (SRTP) for a SIP URI (unsecure) request over TLS.The default is
true.- Returns:
- If SIPS and SRTP are coupled.
-
setSIPSAndSRTPCouplingEnabled
@Deprecated public void setSIPSAndSRTPCouplingEnabled(boolean sipsAndSrtpCouplingEnabled)
Deprecated.Use theSIPUserConfiguration.setUseSIPSURIOverTLSEnabled(boolean)method instead. Starting with Client SDK 3.1.Set whether SIPS and SRTP are coupled.- Parameters:
sipsAndSrtpCouplingEnabled- Iftrue, secure media (SRTP) will not be offered for a SIP URI (unsecure) request over TLS.
-
isReliableProvisionalResponsesEnabled
public boolean isReliableProvisionalResponsesEnabled()
Are reliable provisional responses enabled?If
true, outgoing requests support reliable provisional responses. This gives the far-end the option of using reliable provisional responses if desired.The default is
false.- Returns:
- true If reliable provisional responses are enabled, false otherwise
-
setReliableProvisionalResponsesEnabled
public void setReliableProvisionalResponsesEnabled(boolean reliableProvisionalResponsesEnabled)
Set whether reliable provisional responses are enabled.- Parameters:
reliableProvisionalResponsesEnabled- Iftrue, outgoing requests support reliable provisional responses. This gives the far-end the option of using reliable provisional responses if desired.
-
isExactSIPDomainComparison
public boolean isExactSIPDomainComparison()
* Is the exact SIP domain comparison algorithm used? ** The default is
true, meaning the exact SIP domain comparison algorithm will be used *- Returns:
- true if the exact SIP domain comparison algorithm will be used, false if the weak comparison algorithm will be used.
-
setExactSIPDomainComparison
public void setExactSIPDomainComparison(boolean exactSIPDomainComparison)
* Used for SIP domain comparison. ** In case Avaya Aura servers have deployed a non split horizon DNS, the small difference in domain names of caller and user can be observed: * Ex.: 123456@sbc.avaya.com and 654321@avaya.com. * To support cases where split-horizon DNS is not being used and cases when SM hosted at other domains than SBC, this new setting is used to control how SIP domain names will be compared. When this property is set to false, the comparison of different domains is considered to be a match when one of the domains is the root domain of the other. For example, userid@domain.com and userid@sbc.domain.com are considered to be matching domains even though the exact string comparison is not a match. *
- Parameters:
exactSIPDomainComparison- true to enable exact SIP domain comparison, false to disable (this is the default setting)
-
getInterDigitTimeout
public int getInterDigitTimeout()
The number of seconds that the telephone will wait after a digit is dialed before sending a SIP INVITE. Valid values are 1 through 10 seconds; the default value is 5 seconds.- Returns:
- the number of seconds that the telephone will wait after a digit is dialed before sending a SIP INVITE
-
setInterDigitTimeout
public void setInterDigitTimeout(int interDigitTimeout)
- Parameters:
interDigitTimeout- the number of seconds that the telephone will wait after a digit is dialed before sending a SIP INVITE- See Also:
getInterDigitTimeout()
-
getNoDigitTimeout
public int getNoDigitTimeout()
The number of seconds that the telephone will wait for a digit to be dialed after going off-hook before generating a warning tone. Valid values are 1 through 60 seconds; the default value is 20 seconds.- Returns:
- The number of seconds that the telephone will wait
-
setNoDigitTimeout
public void setNoDigitTimeout(int noDigitTimeout)
- Parameters:
noDigitTimeout- The number of seconds that the telephone will wait for a digit- See Also:
getNoDigitTimeout()
-
getFailedSessionRemovalTimeout
public int getFailedSessionRemovalTimeout()
The number of seconds the session line appearance will be displayed after an invalid extension has been dialed if the user does not press the End Call softkey. Valid values are 5 through 99; the default value is 15.- Returns:
- The number of seconds that the telephone will wait
-
setFailedSessionRemovalTimeout
public void setFailedSessionRemovalTimeout(int failedSessionRemovalTimeout)
- Parameters:
failedSessionRemovalTimeout- The number of seconds the session line appearance will be displayed after an invalid extension has been dialed if the user does not press the End Call softkey. Valid values are 5 through 99; the default value is 15.- See Also:
getFailedSessionRemovalTimeout()
-
-