Protocols/MSNP/MSNC/MSNObject
| MSNP Protocol |
| MSNC |
| Overview • MSNObject |
| Client Capabilities |
| P2P protocol |
| Transports • MSNSLP |
| Headers |
| P2Pv1 Binary headers |
| P2Pv2 Binary headers |
| Transfers |
| Display Pictures |
| Custom Emoticons |
| File Transfer |
| Overview |
| Introduction • Terms • Clients |
| Reference |
| Error List • Commands • Relying Party Suite • Spotlife |
| Services |
| XMPP • HTTP Gateway • Tabs • Activities |
| Documentation |
| Development Tools • MSNP Grid |
| Polygamy • URLs used by MSN |
| Documents |
| Protocol Versions |
| Version 21 |
| Version 18 |
| Version 16 |
| Version 15 |
| Version 14 |
| Version 13 |
| Version 12 |
| Version 11 |
| Version 9 |
| Version 8 |
| Version 2 |
| MSNC |
| Introduction • P2P • Object Descriptor • Display Pictures • File Transfer |
| Scenarios |
| Microsoft Messenger for Mac |
| MSNP on WebTV (MSNTV) |
The MSNObject was introduced with MSNP9 and is part of the Protocols/MSNP/MSNC1 specification. The MSNObject serves as a way to identify Display Pictures, Custom Emoticons, Backgrounds, Voice Clips etc (basically any "content" except file transfers).
A MSNObject is always in the following format. In the below example you can see the basic fields that will always have to be present. You may add your own properties, too (the client just ignores them). Later clients can also add fields for dynamic content (Dynamic Display Pictures like Meegos) for stamping (a method to verify a digital signature of an object), or fields for things like playback length for signature sounds.
<msnobj Creator="buddy@hotmail.com" Size="24539" Type="3" Location="TFR2C.tmp" Friendly="AAA=" SHA1D="trC8SlFx2sWQxZMIBAWSEnXc8oQ=" SHA1C="U32o6bosZzluJq82eAtMpx5dIEI="/>
The official client stores most of the object descriptors in the so called content store.
Explanation of basic fields
Creator
This field indicates the person who made (and is sending) the object. It is typically the address of a buddy.
Size
The total size of the data the object represents, in bytes.
Type
The Type field indicates what sort of file the object describes. Currently the following fields are known:
- 1: Avatar (Unknown, but already present since Messenger 6.0)
- 2: Custom Emoticons
- 3: User Tile (Static display pictures only)
- 4: Shared File (Unknown, but already present since Messenger 6.0)
- 5: Backgrounds (Static backgrounds only)
- 6: History (Unknown)
- 7: Deluxe Display Pictures (Dynamic display pictures)
- 8: Wink
- 9: Map File (A map file contains a list of items in the store)
- 10: Dynamic Backgrounds (Animated backgrounds)
- 11: Voice Clip
- 12: Plug-In State (Saved state of Add-ins)
- 13: Roaming Objects (For example your roaming display picture)
- 14: Signature Sound (Signature sounds introduced in Messenger 9.0)
- 15: Currently unknown. Possibly related to the photo share feature
- 16: Scene
- 17: Web cam Dynamic Display Picture
Note! The value 14 was used for Location information in some BETA clients, but was later removed because of privacy reasons. In the Messenger 9.0 client it was re-used for signature sounds.
Location
The Location field contains the filename under which the file will be, or has been, stored.
Friendly
This field contains the name of the picture in Unicode (UTF-16 Little Endian) format. The string is then encoded with Base64. For most types of descriptors this field is a null character, or AAA= when encoded.
SHA1D
The SHA1D field contains a SHA1 hash of the images data encoded in Base64. It is also known as the Data Hash or the SHA1 Data Field.
SHA1C
This field contains all previous fields hashed with SHA1, and then encoded in Base64. This field is better known as the Checksum, or SHA1 Checksum Field. The string that must be hashed to get the resulting SHA1C value looks similar to:
Creatorbuddy1@hotmail.comSize24539Type3LocationTFR2C.tmpFriendlyAAA=SHA1DtrC8SlFx2sWQxZMIBAWSEnXc8oQ=
It is suspected, but not verified, that the order in which the fields are hashed must be the same as the order of the fields in the XML format.
Sources
- ZoRoNaX' Windows Live Space
- [Protocols/MSNP/MSNC/MSN_Object]
- http://siebe.bot2k3.net/docs/?url=home.html