wrtc.onLoggedIn() is an event function called when when IXNX server has accepted you and you are ready to make and receive calls.
You should use the event to check if server has changed your name, and to indicate to user she can start make calls.
The IXNX server may change your addressName and displayName upon login.
Eg if you had wrtc.addressName="john.doe" before login server may change your name to "john.doe@company.com"
wrtc.addressName is then still unchanged but the connection to server will use your new server-given name.
The new given name is stored in line.addressName
If you display user's address or displayname somewhere then you should change it to this received given name.
If you use digest authentication wrtc.onLoggedIn() is a good place to save wrtc.sipHa1 to the cookie.
When you have logged in.
wrtc.onLoggedIn(arg)
One or both arguments may be missing. If name has not changed empty arg structure is returned.
Ignored.
If server has changed our addressName or displayName we need to change it globally, to affect all future calls.
wrtc.onLoggedIn = function(arg) {
...
if (arg.addressName)
wrtc.addressName = arg.addressName;
if (arg.displayName)
wrtc.displayName = arg.displayName;
...
}
wrtc.onLoggedIn() is also a good place to save password hashsum wrtc.sipHa1 to be used for future digest logins. If user has entered a new wrtc.sipPassword a new wrtc.sipHa1 has just been calculated (as part of the login process) and server has approved it as valid.
wrtc.onLoggedIn = function(arg) {
...
document.cookie= "sipHa1=" + wrtc.sipHa1 + "; expires=Fri, 31 Dec 9999 23:59:59 GMT";
...
}