AD: Created page with "
This section tries to explain what the MSN Object is, what it is being used for and how to create your own MSN Object. The MSN Object was introduced in MSN Mes..."

2020-05-29T00:09:56Z

Created page with "<div id="text"> This section tries to explain what the MSN Object is, what it is being used for and how to create your own MSN Object. The MSN Object was introduced in MSN Mes..."

New page

<div id="text">
This section tries to explain what the MSN Object is, what it is being used for and how to create your own MSN Object. The MSN Object was introduced in MSN Messenger 6.0 and has since then been expanded to meet new features of newer client versions. The reason why it was introduced was to identify Backgrounds, Custom Emoticons, (Dynamic) Display Pictures and Winks (introduced in MSN Messenger 7.0).<br><br>
In this section we will use the data of the following example to discuss how it has to be made. As you can see the MSN Object is just a custom XML tag.

<div class="example">
<div class="title">Example 1</div>

<div class="body">
A typical MSN Object:
<div class="code">
<msnobj Creator="buddy1@hotmail.com" Size="24539" Type="3" Location="TFR2C.tmp" Friendly="AAA=" SHA1D="trC8SlFx2sWQxZMIBAWSEnXc8oQ=" SHA1C="U32o6bosZzluJq82eAtMpx5dIEI="/>
</div>
</div>
</div>

The MSN Object always consists of the following fields:<br>
<ul>
<li>
<div class="title">Creator</div>
<div class="content">
The Creator field contains the e-mail address of the person who uses (or sends) the file.
</div>
</li>

<li>
<div class="title">Size</div>
<div class="content">
The Size field contains the size of the file in bytes.
</div>
</li>

<li>
<div class="title">Type</div>
<div class="content">
The Type field indicates the type of the file. If the value of the field is <code>2</code> we are dealing with a Custom Emoticon, when it's <code>3</code> a Display Picture, <code>5</code> for a Background image, <code>7</code> for a Dynamic Display Picture and <code>8</code> for an Wink. The meaning of <code>1</code>, <code>4</code> and <code>6</code> is still unknown.
</div>
</li>

<li>
<div class="title">Location</div>
<div class="content">
The Location field contains the name of the file under which it is stored on the creators computer.
</div>
</li>

<li>
<div class="title">Friendly</div>
<div class="content">
The Friendly field can contain a friendly name for the file in Unicode format and is encoded with Base64. At the moment it is only being used with background images, Winks and display pictures which you can buy and download.
</div>
</li>

<li>
<div class="title">SHA1D</div>
<div class="content">
The SHA1D field contains the SHA-1 hash from the data of the file which is later encoded with Base64. This value can be used to check if the file sent has been received without errors and that it is the file you expected. This field can also be called the <b>SHA-1 Data</b> field.
</div>
</li>

<li>
<div class="title">SHA1C</div>
<div class="content">
The SHA1C field contains the SHA-1 hash of all the previous fields and is later encoded with Base64 as well. Though be aware that not everything is being used, only the names and values. You have to append the field value to the field name and the next pair to that one, demonstrated in the following example. This field can also be called the <b>SHA-1 Checksum</b> field.
</div>
</li>
</ul>

<div class="example">
<div class="title">Example 2</div>

<div class="body">
Input for the SHA-1 hash for the given MSN Object:
<div class="code">
Creatorbuddy1@hotmail.comSize24539Type3LocationTFR2C.tmpFriendlyAAA=SHA1DtrC8SlFx2sWQxZMIBAWSEnXc8oQ=
</div>
</div>
</div>

<div class="subtitle">Downloadable content</div>

As with MSN Messenger 7.0 not only were Winks added, but downloadable content as well. This allows you to buy backgrounds, (dynamic) display pictures or emoticons and then download it directly to your computer. However, if you have paid for it, your contact can't add the emoticon to his own list. This is the result of some minor adjustments of the MSN Object.<br><br>
Therefore, the following fields has been added:<br>

<ul>
<li>
<div class="title">contenttype</div>
<div class="content">
The contenttype field indicates what type of content the file is. If it's free to download the value is <code>D</code>, but if you need to pay for it, the value is <code>P</code>. If the value is <code>P</code>, it will prevent the official client from adding it to the other users list.
</div>
</li>

<li>
<div class="title">contentid</div>
<div class="content">
The contentid field contains the identifier of the item which the Content Partner gave it.
</div>
</li>

<li>
<div class="title">partnerid</div>
<div class="content">
The partnerid field contains the name of the Content Partner. American Greetings/Blue Mountain for example, is identified by <code>AG</code>. This field applies only for <b>Custom Emoticons</b>. But if this field is not present in the Content XML file when it was downloaded, the value of this field is <code>-1</code>.
</div>
</li>

<li>
<div class="title">stamp</div>
<div class="content">
The stamp field contains the Base64 encoded signature of the file. It is a S/MIME signature of the Base64 encoded hash of the Content cabinet file and is signed by the MSN Content Authority. The stamp field is used in the Content XML file to make sure that the file isn't modified. Currently, it's only being included in the MSN Object for dynamic (Flash) contents like Winks and Dynamic Display Pictures.
</div>
</li>

</ul>

Note that all extra fields are <b>NEVER</b> part of the data which is used to create the <b>SHA-1 Checksum</b>. 

<div class="example">
<div class="title">Example 3</div>

<div class="body">
A typical MSN Object for a Wink (note that the stamp is truncated):
<div class="code">
<msnobj Creator="buddy1@hotmail.com" Size="124830" Type="8" Location="TFR1B9.dat" Friendly="AAA=" SHA1D="iO7E1HrpNXW+aUjtQQaYeNWNOlo=" SHA1C="FKm7FTcpo5IrvfLkK8j5jJ9+y2w=" contenttype="P" contentid="W3079287" stamp="MIIIngYJKoZIhvcNAQcCoIIIjzCCCIsCAQ..."/>
</div>
</div>
</div>

<div class="subtitle">Dynamic display pictures</div>

Dynamic display pictures in MSN Messenger 7.0 consists of two files, a so-called "downlevel" image and the flash file. The reason why downlevel image is being used is that if a client doesn't support a dynamic display picture, it still can view a display picture. But if the client does support it, it should use the value of the <code>avatarcontentid</code> field from the "downlevel" MSN Object to get the MSN Object for the Dynamic Display Picture.
<br><br>
The extra fields for the "downlevel" MSN Object are:

<ul>
<li>
<div class="title">avatarid</div>
<div class="content">
The avatarid field indicates what type of avatar is being referenced to. This field is currently only being seen with <code>{6AD16E96-BC60-401B-89E2-5BB545DD2BF0}</code> as value and is probably being used as a reference to the Shockwave Flash player. The Base64 encoded variant of this value is being sent as Context parameter if a client wants to receive the Shockwave Player XML object with the MSN Object for the dynamic display picture in it.
</div>
</li>

<li>
<div class="title">avatarcontentid</div>
<div class="content">
The avatarcontentid field contains the SHA-1 hash of the cabinet file which contains the content and is later encoded with Base64 as well.
</div>
</li>
</ul>

<div class="example">
<div class="title">Example 4</div>

<div class="body">
A typical "downlevel" MSN Object for a Dynamic Display Picture:
<div class="code">
<msnobj Creator="buddy1@hotmail.com" Size="7449" Type="3" Location="TFR15A.dat" Friendly="AAA=" SHA1D="Ean0sx1KfEzJNCInKi/pPd4QRRA=" SHA1C="sHQUW0XyGV2nl7EjindApWPHyHI=" avatarid="{6AD16E96-BC60-401B-89E2-5BB545DD2BF0}" avatarcontentid="m6T1/vaLR3dV1PflhuybYj4q9V8="/>
</div>
</div>
</div>

<div class="example">
<div class="title">Example 5</div>

<div class="body">
A typical MSN Object for a Dynamic Display Picture (note that the stamp is truncated):
<div class="code">
<msnobj Creator="buddy1@hotmail.com" Size="64903" Type="7" Location="TFR15A.dat" Friendly="AAA=" SHA1D="m6T1/vaLR3dV1PflhuybYj4q9V8=" SHA1C="jn8Vlq5B/u8HhRz6kP5POrq65Zs=" stamp="MIIIngYJKoZIhvcNAQcCoIIIjzCCCIsCAQ..."/>
</div>
</div>
</div>
</div>

[[Category:MSN]]
[[Category:Protocols/MSNP]]
[[Category:Work_In_Progress]]

Protocols/MSNP/MSNC/MSN Object - Revision history

AD: Created page with " This section tries to explain what the MSN Object is, what it is being used for and how to create your own MSN Object. The MSN Object was introduced in MSN Mes..."

AD: Created page with "
This section tries to explain what the MSN Object is, what it is being used for and how to create your own MSN Object. The MSN Object was introduced in MSN Mes..."