109 lines
4.0 KiB
Markdown
109 lines
4.0 KiB
Markdown
# Introduction
|
|
`NLN` is a command introduced with [MSNP2](../versions/msnp2.md).
|
|
|
|
It is a Notification Server command, without a response payload.
|
|
|
|
Specifies that a user has now came online.
|
|
For the version sent with a Transaction ID as a response to some commands, read [ILN](iln.md).
|
|
|
|
# Client/Request
|
|
This command can not be sent from the client.
|
|
|
|
# Server/Response
|
|
`NLN status user-handle {network-id} friendly-name {client-capabilities{:extended-client-capabilities}} {msnobj} {presence-icon-url}`
|
|
|
|
Where `status` is any of the defined statuses:
|
|
* `NLN`: Online
|
|
* `BSY`: Busy
|
|
* `IDL`: Idle
|
|
* `BRB`: Be Right Back
|
|
* `AWY`: Away
|
|
* `PHN`: On The Phone
|
|
* `LUN`: Out To Lunch
|
|
* `HDN`: Appear Offline (previously Invisible, Valid but should never be sent.)
|
|
* `FLN`: Offline (Valid but should never be sent.)
|
|
|
|
Where `user-handle` is the relevant user's handle.
|
|
|
|
Where `network-id` is the Network Identification Number. Added since [MSNP14](../versions/msnp14.md).
|
|
|
|
Where `friendly-name` is the relevant user's friendly name.
|
|
|
|
Where `client-capabilities` are the relevant user's Client Capabilities. Optional? Added since [MSNP8](../versions/msnp8.md).
|
|
|
|
Where `extended-client-capabilities` are the relevant user's Extended Client Capabilities.
|
|
Optional. Added since [MSNP16](../versions/msnp16.md).
|
|
|
|
Where `msnobj` is the MSNObject the relevant user has set. Optional. Added since [MSNP9](../versions/msnp9.md).
|
|
|
|
Where `presence-icon-url` is an image that is rendered to this client that replaces the default user icon.
|
|
Optional. Added since [MSNP14](../versions/msnp14.md).
|
|
|
|
# Examples
|
|
|
|
## Wihout anything special
|
|
```
|
|
S: NLN NLN anotheruser@example.com another%20user
|
|
```
|
|
|
|
## With Client Capabilities
|
|
*Since [MSNP8](../versions/msnp8.md).*
|
|
```
|
|
S: NLN NLN anotheruser@example.com another%20user 0
|
|
```
|
|
|
|
## With a MSNObject
|
|
*Since [MSNP9](../versions/msnp9.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
S: NLN NLN anotheruser@hotmail.com another%20user 268435500 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
|
|
.. %20Size%3D%2225235%22%20Type%3D%223%22
|
|
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
|
|
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
|
|
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
|
|
```
|
|
|
|
## With Network IDs and Presence Icon URLs
|
|
*Since [MSNP14](../versions/msnp14.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
S: NLN NLN anotheruser@hotmail.com 1 another%20user insert-wlm-8-cid-here %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
|
|
.. %20Size%3D%2225235%22%20Type%3D%223%22
|
|
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
|
|
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
|
|
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
|
|
.. http://example.com/interop/online.png
|
|
```
|
|
|
|
## With Extended Client Capabilities
|
|
*Since [MSNP16](../versions/msnp16.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
S: NLN NLN anotheruser@hotmail.com 1 another%20user 2789003324:48 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
|
|
.. %20Size%3D%2225235%22%20Type%3D%223%22
|
|
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
|
|
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
|
|
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
|
|
.. http://example.com/interop/online.png
|
|
```
|
|
|
|
## Invalid context
|
|
*Inherited from being an unimplemented command.*
|
|
```
|
|
C: NLN FLN example@hotmail.com example%20user
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
# Known changes
|
|
* [MSNP8](../versions/msnp8.md): Added a parameter for Client Capabilities.
|
|
* [MSNP9](../versions/msnp9.md): Added a parameter for the MSNObject.
|
|
* [MSNP14](../versions/msnp14.md): Added a way to override the default presense icon, and added a new non-optional Network ID parameter.
|
|
* [MSNP16](../versions/msnp16.md): Added Extended Client Capabilities support to the Client Capabilities parameter, delimited by a colon.
|