Difference between revisions of "Profile Selector"

From Nintendo Switch Brew
Jump to navigation Jump to search
Line 147: Line 147:
 
|-
 
|-
 
| 2 || Create
 
| 2 || Create
 +
|}
 +
 +
== UserSelectionPurpose ==
 +
This is "nn::account::UserSelectionPurpose".
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value || Description
 +
|-
 +
| 0 || General
 +
|-
 +
| 1 || GameCardRegistration
 +
|-
 +
| 2 || EShopLaunch
 +
|-
 +
| 3 || EShopItemShow
 +
|-
 +
| 4 || PicturePost
 +
|-
 +
| 5 || NintendoAccountLinkage
 +
|-
 +
| 6 || SettingsUpdate
 +
|-
 +
| 7 || SaveDataDeletion
 +
|-
 +
| 8 || UserMigration
 
|}
 
|}
  

Revision as of 04:38, 3 December 2019

This is the applet presented when launching a game that allows the user to select a user.

See AM_services#Library_Applets. The profile selector expects a two IStorage inputs and a single IStorage output.

Library Applet Versions

System Version Value
[1.0.0+] 0x1
[2.0.0+] 0x10000
[6.0.0+] 0x20000

UiSettings

This is "nn::account::UiSettings".

Offset Size Description
0x0 0x4 #UiMode
0x4 0x4
0x8 0x80 u128 invalidUidList[8]. This is copied from #UserSelectionSettings.
0x88 0x8 ApplicationId with ShowUserSelectorForLauncher.
0x90 0x1 u8 isNetworkServiceAccountRequired. This is copied from #UserSelectionSettings.
0x91 0x1 u8 isSkipEnabled. This is copied from #UserSelectionSettings.
0x92 0x1 Set to 0x1 by ShowUserSelectorForSystem/ShowUserSelectorForLauncher.
0x93 0x1 u8 isPermitted. ShowUserSelector* sets this to the output bool from IsUserRegistrationRequestPermitted.
0x94 0x1 u8 showSkipButton. This is copied from #UserSelectionSettings.
0x95 0x1 u8 additionalSelect. This is copied from #UserSelectionSettings.
0x96 0x1 [2.0.0+] This is copied from #UserSelectionSettingsForSystemService+0x4. ShowUserSelectorForLauncher/ShowUserSelector sets this to value 1.
0x97 0x1 [6.0.0+] Set to #UserSelectionSettings isUnqualifiedUserSelectable ^ 1.
0x98 0x4 [2.0.0+] This is copied from the 4-bytes at #UserSelectionSettingsForSystemService+0x0.
0x9C 0x4

This has size 0xA0 (0x98 with [1.0.0]) and seems to only affect the UI display. Typical value is all zero with byte 0x96 equal to 0x01. Setting the first byte to 1 will make the applet display in order to create a new user. "starter" sets the first byte to 5 in order to display initial user setup.

UiMode

This is "nn::account::UiMode".

Value Description
0 UserSelector
1 UserCreator
2 EnsureNetworkServiceAccountAvailable
3 UserIconEditor
4 UserNicknameEditor
5 UserCreatorForStarter
6 NintendoAccountAuthorizationRequestContext
7 IntroduceExternalNetworkServiceAccount
8 [6.0.0+] IntroduceExternalNetworkServiceAccountForRegistration
9 [6.0.0+] NintendoAccountNnidLinker
10 [6.0.0+] LicenseRequirementsForNetworkService
11 [7.0.0+] LicenseRequirementsForNetworkServiceWithUserContextImpl
12 [7.0.0+] UserCreatorForImmediateNaLoginTest

UserSelectionSettings

This is "nn::account::UserSelectionSettings ".

Offset Size Description
0x0 0x80 u128 invalidUidList[8]
0x80 0x1 u8 isSkipEnabled
0x81 0x1 u8 isNetworkServiceAccountRequired
0x82 0x1 u8 showSkipButton
0x83 0x1 u8 additionalSelect
0x84 0x1 [6.0.0+] u8 isUnqualifiedUserSelectable

UserSelectionSettingsForSystemService

This is "nn::account::UserSelectionSettingsForSystemService". This was added as an additional input param with sdknso [2.0.0+].

Offset Size Description
0x0 0x4 #UserSelectionPurpose
0x4 0x1
0x5 0x3 u8 padding[3]

UiReturnArg

This is "nn::account::UiReturnArg".

Offset Size Description
0x0 0x8 Result (0 = Success, 2 = Failure)
0x8 0x10 UUID of selected user

NintendoAccountStartupDialogType

This is "nn::account::NintendoAccountStartupDialogType".

Value Description
0 LoginAndCreate
1 Login
2 Create

UserSelectionPurpose

This is "nn::account::UserSelectionPurpose".

Value Description
0 General
1 GameCardRegistration
2 EShopLaunch
3 EShopItemShow
4 PicturePost
5 NintendoAccountLinkage
6 SettingsUpdate
7 SaveDataDeletion
8 UserMigration

Usage

User-processes should push a common arguments struct and the typical UserSelectionConfig struct as well. After pushing in the data and calling start, user-processes should wait upon the PopOutDataEvent and then pop a single IStorage to obtain the result structure described above.