yellows111
/
msnp-wiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
msnp-wiki/docs/commands/nln.md

4.0 KiB
Raw Blame History

Introduction

NLN is a command introduced with MSNP2.

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.

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.

Where friendly-name is the relevant user's friendly name.

Where client-capabilities are the relevant user's Client Capabilities. Optional? Added since MSNP8.

Where extended-client-capabilities are the relevant user's Extended Client Capabilities. Optional. Added since MSNP16.

Where msnobj is the MSNObject the relevant user has set. Optional. Added since MSNP9.

Where presence-icon-url is an image that is rendered to this client that replaces the default user icon. Optional. Added since MSNP14.

Examples

Wihout anything special

S: NLN NLN anotheruser@example.com another%20user

With Client Capabilities

Since MSNP8.

S: NLN NLN anotheruser@example.com another%20user 0

With a MSNObject

Since MSNP9.

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.

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.

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: Added a parameter for Client Capabilities.
  • MSNP9: Added a parameter for the MSNObject.
  • MSNP14: Added a way to override the default presense icon, and added a new non-optional Network ID parameter.
  • MSNP16: Added Extended Client Capabilities support to the Client Capabilities parameter, delimited by a colon.