Nintendo Wi -Fi Connection Revolution DWC Programming Manual Ver sion 1.3.2 The contents in this document are highly confidential and should be handled accordingly. 2006 -2007 N intendo RVL -06 -0199 -001 -H CONFIDENTIAL Released : July 23, 2007 Nintendo Wi -Fi Connection Revolution DWC Programming Manual Confidential These coded instructions, statements, and computer programs contain proprietary information of Nintendo of America Inc. and/or Nintendo Company Ltd. and are protected by Fede ral copyright law. They may not be disclosed to third parties or copied or duplicated in any form, in whole or in part, without the prior written consent of Nintendo. RVL -06 -0199 -001 -H 2 2006 -2007 N intendo Rele ased : July 23, 2007 CONFIDENTIAL Nintendo Wi -Fi Co nnection Revolution DWC Programming Manual Table of Contents 1 Introduction ................................ ................................ ................................ ................................ ................... 9 2 Revolution DWC User Management ................................ ................................ ................................ ........... 10 2.1 Managing Wi -Fi User Information ................................ ................................ ................................ ....... 10 2.1.1 User ID and Player ID ................................ ................................ ................................ ................. 10 2.1.2 Differences between User ID and Player ID ................................ ................................ ............... 10 2.1.3 Player Info rmation at the Game Level: Login ID ................................ ................................ ......... 11 2.1.4 Information for Nintendo Wi -Fi Connection Authentication Saved by Games ............................ 11 2.2 Frie nd Management Overview ................................ ................................ ................................ ............ 12 2.2.1 Constructing Friend Relationships ................................ ................................ .............................. 12 2.2.2 Constructing Friend Relationships with Friend Codes ................................ ................................ 13 2.2.3 Linking Wii Friends and Game Friends ................................ ................................ ....................... 13 3 Initializing and Shutting Down DWC ................................ ................................ ................................ ........... 15 3.1 Items to be Considered when Using DWC ................................ ................................ ......................... 15 3.2 Initialization ................................ ................................ ................................ ................................ ......... 15 3.3 Shutdown ................................ ................................ ................................ ................................ ............ 17 4 Creating User Data ................................ ................................ ................................ ................................ ..... 18 5 Connection Processes ................................ ................................ ................................ ................................ 20 5.1 Connecting to the Nintendo Wi -Fi Connection Server ................................ ................................ ........ 20 6 Creating Friend Rosters and Friend Information ................................ ................................ ........................ 23 6.1 Exchanging Friend Codes ................................ ................................ ................................ ................... 23 6.2 Synchronizing Friend Rosters ................................ ................................ ................................ ............. 24 6.3 Friend Information Types ................................ ................................ ................................ .................... 27 6.4 Getting Friend Status ................................ ................................ ................................ .......................... 29 6.5 Friend Codes Notification using WiiConnect24 ................................ ................................ .................. 30 7 Matchmaking ................................ ................................ ................................ ................................ ............... 34 7.1 Peer Matchmaking Without Friend Specification ................................ ................................ ................ 34 7.2 Peer Matchmaking With Friend Specification ................................ ................................ ..................... 35 7.3 Evalu ating Matchmaking Candidates ................................ ................................ ................................ .37 7.4 Server -Client Matchmaking ................................ ................................ ................................ ................. 38 7.5 Increasing Matchmaking Speed ................................ ................................ ................................ .......... 41 7.6 Key Names that Cannot be Used for Matchmaking Indicator Keys ................................ ................... 41 8 Sending and Receiving Data ................................ ................................ ................................ ...................... 42 8.1 Peer -to -Peer Data Sending and Receiving ................................ ................................ ......................... 42 8.2 Terminating a Connection ................................ ................................ ................................ ................... 45 2006 -2007 N intendo 3 RVL -06 -0199 -001 -H CONFIDENTIAL Released : July 23, 2007 Nintendo Wi -Fi Connection Revolution DWC Programming Manual 8.3 Targets for the Buffer Size Specifie d by DWC_InitFriendsMatch ................................ ....................... 45 8.4 Emulations of Packet Loss and Delays ................................ ................................ .............................. 46 8.5 Data Send and Receive Volumes (When Wireless Commun ications Are Used) ............................... 47 9 HTTP Communications ................................ ................................ ................................ .............................. 49 9.1 Preparing to Use the GHTTP Library ................................ ................................ ................................ 49 9.2 Uploading Data ................................ ................................ ................................ ................................ ... 49 9.3 Downloading Data ................................ ................................ ................................ .............................. 51 9.4 Closing the GHTTP Library ................................ ................................ ................................ ................ 53 10 Network Storage Support ................................ ................................ ................................ ......................... 54 11 General Ranking Library ................................ ................................ ................................ ........................... 58 11.1 Introduction ................................ ................................ ................................ ................................ ......... 58 11.2 Using the General Ranking Library ................................ ................................ ................................ .... 58 11.2.1 Process Flow ................................ ................................ ................................ .............................. 58 11.2.2 Initializing the General Ranking Library ................................ ................................ ...................... 59 11.2.3 Uploading Scores ................................ ................................ ................................ ........................ 60 11.2.4 Downloading Scores ................................ ................................ ................................ ................... 61 11.2.5 Closing the General Ranking Library ................................ ................................ .......................... 67 11.2.6 Terminating Processes and Error Processing ................................ ................................ ............ 68 11.2.7 Error Codes ................................ ................................ ................................ ................................ 68 11.2.8 Sample Code (Ranking) ................................ ................................ ................................ .............. 68 11.2.9 Dependency on DWC_GHTTP ................................ ................................ ................................ ... 68 11.2.10 Amount of Memory Used ................................ ................................ ................................ ........ 68 11.3 General Ranking Management Tool ................................ ................................ ................................ ... 68 11.3.1 Overview ................................ ................................ ................................ ................................ ..... 68 11.3.2 File Structure ................................ ................................ ................................ ............................... 69 11.3.3 Run Environment ...............................