8 Mii Characters

8.1 Applications That Use Mii Characters

Ensure that applications that use Mii characters can proceed without any problems even if there are no Mii characters in the front-end database.

If your application requires use of one or more Mii characters, it must handle the situation with one of the following methods when there are no Mii characters in the front end database.

  • The application displays a message immediately after application startup directing the user to create a Mii character using Mii Maker, and then suspends application progress until the user has created a Mii character.
  • The application starts using a default Mii character, a random Mii character, or a substitute image provided by the application.
    In this case, Nintendo recommends displaying a message such as the following: "There are no Mii characters available, so a substitute Mii will be used instead. You can create a new Mii in Mii Maker," or "There are no Mii characters available. You can create a new Mii in Mii Maker."

 

Mii Characters

Front-end database

Mii Maker

8.2 Prohibition of Altering Mii-Related Data

It is prohibited to alter the following data related to Mii characters.

  • CFLStoreData
  • The Mii face model work buffer
  • Work Buffer for the Intermediate Database
  • Packet Buffer
  • CFLNetInformation Buffer
  • CFLAdditionalInfo
  • Other CFL Structures

 

Mii Characters

CFL

Prohibition of Altering

CFLStoreData

Face Model

Intermediate Database

Packet Buffer

CFLNetInformation

CFLAdditionalInfo

8.3 Using Additional Information From Mii Characters

If your application uses additional information that pertains to a Mii character, ensure that the application can proceed without any problems even if a Mii character is used that has none of the following information configured.

Information Member of CFLAdditionalInfo
Creator Name creator
Month of birth birthMonth
Day of birth birthDay

 

 

Mii Characters

Additional Information

CFLAdditionalInfo

8.4 Handling Corruption in Mii Character Database

If the CFL_InitRes function is called when the Mii database is corrupted, the function will automatically initialize the database and return CFL_RESULT_FORMATTED to the application. If this happens, Nintendo strongly recommends informing the user that the database has been initialized by displaying the following or a similar message: "Mii Maker save data was formatted due to data corruption."

If the Mii database has been initialized, then there will not be any Mii characters in the database. You must therefore comply with section 8.1 Applications That Use Mii Characters.

 

Mii Characters

Mii character database

CFL_InitRes function

CFL_RESULT_FORMATTED

 

8.5 Obtaining CFLStoreData from Non-CFL Libraries

When passing the CFLStoreData of a Mii obtained with the friends library to any of the following functions, you must always specify CFL_DATASOURCE_STOREDATA_ALWAYS for the source argument of the function.

  • CFL_InitCharModel function
  • CFL_MakeIcon function
  • CFL_SetToNetPacket function
  • CFL_GetAdditionalInfo function

If you specify CFL_DATASOURCE_STOREDATA instead of CFL_DATASOURCE_STOREDATA_ALWAYS in the source argument, this could cause the Mii character used in the application to look different from the Mii character in the friend list.

It is also possible for a friend’s Mii to be updated compared to what is in the friend list or deleted from the friend list in the HOME Menu even while the application is running. When an application gets a friend’s Mii character, it is acceptable to handle it as a friend’s Mii character even when the friend has been deleted from the friend list while the application is running.

Furthermore, when using the friends library, it is possible to detect updates to a friend’s Mii character in real time. If such an update is detected, we recommend that the friend's Mii information being used by the application be updated as quickly as possible.

You can check whether the source argument is set correctly or not by preparing one system on which to run the application (System A) and one more system (System B), and then following the steps below.

  1. Establish a friend relationship between System A and System B.
  2. Use Mii Maker to send System B's Mii to System A.
  3. Launch Mii Maker on System B and alter the appearance of their Personal Mii.
  4. Confirm on System A's friend list that the appearance of System B's Mii has been altered.
  5. Progress through the application on System A, and confirm in a scene where a friend's Mii character is used that the appearance of System B's Mii is identical to that of their Mii in the friend list.

 

Mii Characters

Friends

CFLStoreData

CFL_DATASOURCE_STOREDATA_ALWAYS

CFL_DATASOURCE_STOREDATA

CFL_InitCharModel function

CFL_MakeIcon function

CFL_SetToNetPacket function

CFL_GetAdditionalInfo function

friends library

Friend List

8.6 Nicknames of Friends' Mii Characters Obtained from Non-CFL Libraries

The nn::friends::CTR::GetFriendScreenName function provided in the friends library enables applications to obtain nickname of a friend’s Mii character without using CFL. The nickname of a friend's Mii character obtained with this function is basically the same as a nickname retrieved via CFL. However, if the creator of the friend's Mii is registered to the blocked-user list, then the CFL library will substitute “Mii” for the Mii nickname, whereas the friends library will not. Nintendo recommends getting nicknames of friends' Mii characters from CFLStoreData via the CFL library so the settings in the blocked-user list can also be applied.

In addition, nickname substitutions are performed in order to handle differences in Mii font regions and CTR system regions. These are carried out when true is specified for the replaceForeignCharacters argument of the nn::friends::CTR::GetFriendScreenName function.

 

friends library

Mii Characters

Friends

Nicknames

nn::friends::CTR::GetFriendScreenName function

Blocked-User List

CFLStoreData

 

 


CONFIDENTIAL