1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META http-equiv="Content-Style-Type" content="text/css"> 6<TITLE>NWC24 Message Board API Introduction</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8<LINK rel="stylesheet" type="text/css" href="../nwc24.css"> 9</HEAD> 10<BODY> 11<H1>NWC24 API and Wii Message Board</H1> 12 13<H2>Introduction</H2> 14<P> 15 The Wii implements a standard application called the Wii Message Board as a feature of the Wii Menu. This mechanism enables the exchange of messages between family members or with a friend's Wii and has been implemented using the WiiConnect24 feature.<BR> In addition, messages sent from an application can be posted to the Wii Message Board.<BR> This method is described below.<BR> 16</P> 17 18<H2>How to Post a Message to the Wii Message Board Using NWC24</H2> 19<P> 20 There are two major patterns for posting a message to the Wii Message Board, using the NWC24 library. 21</P> 22<P> 23 <UL> 24<LI>Post to the user's own Wii console Wii Message Board locally 25 <P> 26 Use the NWC24 library to create and send a message that has only the user's own Wii number specified in the <B>To:</B> address field.<BR>Specify <A HREF="../Types/NWC24MsgType.html"><CODE>NWC24_MSGTYPE_WII_MENU</CODE></A> as the message type.<BR>This feature can be used even if the user has not enabled WiiConnect24. 27 </P> 28<LI>Send a message to a Wii friend, and post it to the friend's console Wii Message Board 29 <P> 30 Using the NWC24 library to create and send a message to the Wii friend(s). This is possible only when WiiConnect24 message sending and receiving is enabled. Specify <A HREF="../Types/NWC24MsgType.html"><CODE>NWC24_MSGTYPE_WII_MENU</CODE></A> or <A HREF="../Types/NWC24MsgType.html"><CODE>NWC24_MSGTYPE_WII_MENU_SHARED</CODE></A> as the message type. (These two differ only in whether or not the contents can be read when the application receives the message.) 31 </P> 32 </UL> 33</P> 34 35<H2>Format of the Message</H2> 36<P> 37 Messages must satisfy the following conditions to be displayed on the Wii Message Board:<BR> 38<DL> 39<DT>Body</DT> 40<DD> 41<UL> 42<LI>Specify the text to be displayed as the body text. 43<LI>Use UTF-16BE as the character encoding. Use LF (0x000A) in UTF-16 encoding as the linefeed code. 44<LI>The maximum number of characters that can be displayed is 3000. All codes are treated as UTF-16, so a half-width character and a full-width character are each counted as one character. 45<LI>Specify 8-bit (<A HREF="../Types/NWC24Encoding.html"><CODE>NWC24_ENC_8BIT</CODE></A>) as the encoding type specified by <A HREF="../Message/NWC24SetMsgText.html"><CODE>NWC24SetMsgText()</CODE></A> when pasting the message to the user's own Wii console, or use base64 (<A HREF="../Types/NWC24Encoding.html"><CODE>NWC24_ENC_BASE64</CODE></A>) when sending it to another Wii. 46</UL> 47</DD> 48<BR> 49<DT>Subject</DT> 50<DD> 51<UL> 52<LI>The content of the <B>Subject</B> field is not reflected in the display on the Wii Message Board, so leave this field blank.<BR>(However, messages received from an external e-mail address will have the content of the <B>Subject</B> field added to the beginning of the text.) 53</UL> 54</DD> 55<BR> 56<DT>Attached file</DT> 57<DD> 58<UL> 59<LI>You can specify the background image of the message displayed on the Wii Message Board as letterform data by attaching binary data in the <A HREF="../Types/NWC24MIMEType.html"><CODE>NWC24_APP_WII_MSGBOARD</CODE></A> format to the message. (For details, see the <A HREF="../Letterform/Letterform.html">Letterform Template</A> explanation.) 60<LI>The default stationery is used if no stationery data is attached. 61</UL> 62</DD> 63</DL> 64 65<H2>When the Message is Processed by the Wii Message Board</H2> 66<P> 67 The Wii Message Board is implemented as part of the Wii Menu. When the Wii Menu starts, the message box is searched, and messages with the message type <CODE>MENU</CODE> are selected and registered to the Wii Message Board database. Internal or external messages that are received while the application is running are displayed on the Wii Message Board when returning to the Wii Menu subsequently. 68</P> 69 70<H2>Cautions when Posting Messages from an Application to the Wii Message Board</H2> 71 72<DL> 73<DT>Using AltName (a substitute nickname)</DT> 74<DD> 75<P> 76 The specifications call for the sender's player nickname (defined in the console friend roster) to be displayed in the <B>From:</B> field in the message displayed on the Wii Message Board. Thus, even if a message is sent from an application (particularly when sent locally to the user's own Wii console), the user's own address may show up in the <B>From:</B> field when the message is displayed. 77</P> 78 79<P> 80 To prevent this situation, a mechanism to set a different name (the game name or the name of a character in the game) is provided. Use the <A HREF="NWC24SetMsgAltName.html"><CODE>NWC24SetMsgAltName()</CODE></A> function to define a name in the same format as that used for the nicknames in the friend roster on the Wii. This name will be displayed on the Wii Message Board with a higher priority than the other names set on the friend roster. The other names specified here (the alternate nicknames) must fully satisfy the following conditions: 81<P> 82 83<UL> 84<LI> Character code is UTF-16BE format 85<LI> Maximum of 35 characters 86<LI> String includes 0x0000 as the termination character (this is counted in the total number of characters). 87<LI> Up to one linefeed, using the UTF-16BE LF code (0x000A). (This is also counted in the total number of characters.) 88<LI> A maximum of 17 characters that can be displayed on a single line. (If no linefeed is used, the string will be wrapped automatically at 17 characters, and it may not display properly, depending on the character width.) 89</UL> 90</DD> 91 92<BR> 93 94<DT>Configuring the reply-disable flag</DT> 95<DD> 96<P> 97Messages that are sent from the application and are automatically posted to the Wii Message Board must have the reply feature turned off to prevent the user from creating a reply message. Use <A HREF="NWC24SetMsgMBNoReply.html"><CODE>NWC24SetMsgMBNoReply()</CODE></A> in this case. This disables displaying of Reply button during message display on the Wii Message Board. 98</P> 99</DD> 100</DL> 101 102<H2>Cautions when Sending Game Data for an Application when Posting to the Wii Message Board with a Message Indicating that the Data has been Sent</H2> 103<P> 104 This situation sends two messages: one to the Wii Message Board and another between applications. The message sent to the Wii Message Board consists of the text (and the stationery data). The messages between applications are sent with the application data attached (no body text). 105</P> 106 107<H2>Detailed Control Features on the Wii Message Board</H2> 108<P> 109 With the <A HREF="NWC24SetMsgMBRegDate.html"><CODE>NWC24SetMsgMBRegDate()</CODE></A> function, you can specify to what date location (whether future or past) a message is registered in the Wii Message Board calendar. This function only specifies the registration location; it does not necessarily mean that the message will be hidden until a certain date. 110</P> 111 112<P> 113 You can use the <A HREF="NWC24SetMsgMBDelay.html"><CODE>NWC24SetMsgMBDelay()</CODE></A> function to specify (in units of hours) how long to wait after sending the message before actually displaying the message to users on the Wii Message Board. (However, there are a number of restrictions to this.)<BR> 114</P> 115 116<H2>Revision History</H2> 117<P> 1182007/07/18 Updated text.<BR>2007/04/03 Added link to the explanation of Letterform Template and made other small revisions.<BR>2007/01/22 Established limit for the number of characters for Wii Message Board and made other small revisions. <BR>2006/11/17 Made some small revisions. <BR>2006/10/06 Initial version. 119</P> 120 121<hr><p>CONFIDENTIAL</p></body> 122</HTML>