sip.js.useragentoptions.md

October 21, 2022 ยท View on GitHub

Home > sip.js > UserAgentOptions

UserAgentOptions interface

Options for UserAgent constructor.

Signature:

export interface UserAgentOptions 

Properties

PropertyModifiersTypeDescription
allowLegacyNotificationsbooleanIf true, the user agent will accept out of dialog NOTIFY.
authorizationHa1stringAuthorization ha1.
authorizationPasswordstringAuthorization password.
authorizationUsernamestringAuthorization username.
contactNamestringThe user portion of user agent's contact URI.
contactParams{ [name: string]: string; }The URI parameters of the user agent's contact URI.
delegateUserAgentDelegateDelegate for UserAgent.
displayNamestringThe display name associated with the user agent.
forceRportbooleanForce adding rport to Via header.
gracefulShutdownbooleanIf true, the stop() method will attempt to gracefully end all dialogs and registrations before disconnecting. Otherwise stop() will transition immediately abandoning all dialogs and registrations.
hackAllowUnregisteredOptionTagsbooleanHack
hackIpInContactboolean | stringHack
hackViaTcpbooleanHack
instanceIdstringUUID to provide with "+sip.instance" Contact header parameter.
instanceIdAlwaysAddedbooleanAdd "+sip.instance" Contact header parameter to all requests.
logBuiltinEnabledbooleanIndicates whether log messages should be written to the browser console.
logConfigurationbooleanIf true, constructor logs the user agent configuration.
logConnectorLogConnectorA function which will be called every time a log is generated.
logLevelLogLevelIndicates the verbosity level of the log messages.
noAnswerTimeoutnumberNumber of seconds after which an incoming call is rejected if not answered.
preloadedRouteSetArray<string>Adds a Route header(s) to outgoing requests.
reconnectionAttemptsnumber
reconnectionDelaynumber
sendInitialProvisionalResponsebooleanIf true, a first provisional response after the 100 Trying will be sent automatically if UAC does not require reliable provisional responses.
sessionDescriptionHandlerFactorySessionDescriptionHandlerFactoryA factory for generating SessionDescriptionHandler instances.
sessionDescriptionHandlerFactoryOptionsobjectOptions to passed to sessionDescriptionHandlerFactory.
sipExtension100relSIPExtensionReliable provisional responses. https://tools.ietf.org/html/rfc3262
sipExtensionExtraSupportedArray<string>Extra option tags to claim support for.
sipExtensionReplacesSIPExtensionReplaces header. https://tools.ietf.org/html/rfc3891
sipjsIdstringAn id uniquely identify this user agent instance.
transportConstructornew (logger: Logger, options: any) => TransportA constructor function for the user agent's Transport.
transportOptionsunknownAn options bucket object passed to transportConstructor when instantiated.
uriURISIP Addresses-of-Record URI associated with the user agent.
userAgentStringstringUser agent string used in the UserAgent header.
viaHoststringHostname to use in Via header.