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.
- Establish a friend relationship between System A and System B.
- Use Mii Maker to send System B's Mii to System A.
- Launch Mii Maker on System B and alter the appearance of their Personal Mii.
- Confirm on System A's friend list that the appearance of System B's Mii has been altered.
- 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