88 lines
2.1 KiB
Markdown
88 lines
2.1 KiB
Markdown
# Introduction
|
|
`UUX` is a command introduced with [MSNP11](../versions/msnp11.md).
|
|
|
|
It is a Notification Server command, WITH a request payload and WITH a response payload.
|
|
|
|
For the version of the command that is sent from the server that relates to another user, read [UBX](ubx.md).
|
|
|
|
# Client/Request
|
|
```
|
|
UUX TrID length
|
|
payload
|
|
```
|
|
|
|
Where `length` is the size (in bytes) of the `payload`.
|
|
|
|
Where `payload` is the combined XML data you would like to publish,
|
|
contained in a `<Data>` element:
|
|
* `<PSM>`: Your new Personal Status Message.
|
|
* `<CurrentMedia>`: Your new currently playing media status.
|
|
* `<MachineGuid>`: The GUID of the computer you are using.
|
|
Added since [MSNP13](../versions/msnp13.md).
|
|
|
|
# Server/Response
|
|
`UUX TrID length`
|
|
|
|
Where `length` is always `0`.
|
|
|
|
# Examples
|
|
|
|
## Without MachineGuid
|
|
*Only in [MSNP11](../versions/msnp11.md) and [MSNP12](../versions/msnp12.md).*
|
|
|
|
### Blank status
|
|
```
|
|
C: UUX 1 53
|
|
<Data><PSM></PSM><CurrentMedia></CurrentMedia></Data>
|
|
S: UUX 1
|
|
```
|
|
|
|
### With PSM
|
|
```
|
|
C: UUX 2 75
|
|
<Data><PSM>example status message</PSM><CurrentMedia></CurrentMedia></Data>
|
|
S: UUX 2
|
|
```
|
|
|
|
### With playing media
|
|
```
|
|
C: UUX 3 137
|
|
<Data><PSM>example status message</PSM><CurrentMedia>\0Music\01\0{0} - {1}\0Song Title\0Song Artist\0Song Album\0\0</CurrentMedia></Data>
|
|
S: UUX 3
|
|
```
|
|
|
|
## With MachineGuid
|
|
*Since [MSNP13](../versions/msnp13.md).*
|
|
|
|
### Blank status
|
|
```
|
|
C: UUX 4 118
|
|
<Data><PSM></PSM><CurrentMedia></CurrentMedia><MachineGuid>{44BFD5A4-7450-4BDA-BA3A-C51B3031126D}</MachineGuid></Data>
|
|
S: UUX 4
|
|
```
|
|
|
|
### With PSM
|
|
```
|
|
C: UUX 5 140
|
|
<Data><PSM>example status message</PSM><CurrentMedia></CurrentMedia><MachineGuid>{44BFD5A4-7450-4BDA-BA3A-C51B3031126D}</MachineGuid></Data>
|
|
S: UUX 5
|
|
```
|
|
|
|
### With playing media
|
|
```
|
|
C: UUX 6 202
|
|
<Data><PSM>example status message</PSM><CurrentMedia>\0Music\01\0{0} - {1}\0Song Title\0Song Artist\0Song Album\0\0</CurrentMedia><MachineGuid>{44BFD5A4-7450-4BDA-BA3A-C51B3031126D}</MachineGuid></Data>
|
|
S: UUX 6
|
|
```
|
|
|
|
## Invalid data
|
|
```
|
|
C: UUX 7 19
|
|
<invalid></invalid>
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
# Known changes
|
|
* [MSNP13](../versions/msnp13.md): Added `<MachineGuid>` to payload.
|