====== line ======
line is an object of class lineObject that is automatically created by wrtc whenever it needs a new connection a new "telephone line" to the server

It takes care of one telephone connection, one "telephone line". To be able to call someone, or receive a call, you need to first have a line.

Users usually do not need to do anything with the line object, except in [[ixnx:wrtc:js:api:wrtc:onauthenticate|wrtc.onAuthenticate()]], [[ixnx:wrtc:js:api:wrtc:onauthenticatefailed|wrtc.onAuthenticateFailed()]] and [[ixnx:wrtc:js:api:wrtc:onrejected|wrtc.onRejected()]] there the line object is one of the function arguments.

====== line API ======
The line object can be controlled using function calls and properties.

===== Properties =====
Useful line object properties:
| [[ixnx:wrtc:js:api:line:addressname|line.addressName]] | username / SIP address given by server |
| [[ixnx:wrtc:js:api:line:call|line.call]] | call object using this line |
| [[ixnx:wrtc:js:api:line:displayname|line.displayName]] | user's informal, descriptive name given by server |
| [[ixnx:wrtc:js:api:line:nam|line.nam]] | line object name |
| [[ixnx:wrtc:js:api:line:objtype|line.objType]] | object type |
| [[ixnx:wrtc:js:api:line:online|line.online]] | logged in |
<WRAP center round important 100%>
In order to avoid malfunction **please do not change any of the line object's properties**.
</WRAP>
 
===== Functions =====
Useful line object functions:
| [[ixnx:wrtc:js:api:line:authenticate|line.authenticate()]] | log in user |