Profile Selector - Revision history

Yellows8: /* UiMode */

2021-09-15T17:48:15Z

UiMode

← Older revision		Revision as of 21:48, 15 September 2021
Line 87:		Line 87:
	\|-		\|-
	\| 12 \|\| [7.0.0+] UserCreatorForImmediateNaLoginTest		\| 12 \|\| [7.0.0+] UserCreatorForImmediateNaLoginTest
			\|-
			\| 13 \|\| [13.0.0+] UserQualificationPromoter
	\|}		\|}

Yellows8: /* Usage */

2019-12-19T01:37:25Z

Usage

← Older revision		Revision as of 04:37, 19 December 2019
Line 181:		Line 181:

	== Usage ==		== Usage ==
	User-processes should push a common arguments struct and [[#UiSettings]]. Official sw can optionally push an additional storage from [[Applet_Manager_services#CreateTransferMemoryStorage\|CreateTransferMemoryStorage]] with flag=0 using an input buffer when that input buffer is not NULL, however sdknso itself doesn't use this besides a wrapper func which sdknso itself doesn't call. After launching the applet and waiting for it to finish, on success the output storage [[#UiReturnArg]] should be popped.		User-processes should push a common arguments struct and [[#UiSettings]]. Official sw can optionally push an additional storage from [[Applet_Manager_services#CreateTransferMemoryStorage\|CreateTransferMemoryStorage]] with flag=0 using an input buffer when that input buffer is not NULL, however sdknso itself doesn't use this besides a wrapper func which sdknso itself doesn't call (the applet itself ignores this storage, at least with [9.1.0+]). After launching the applet and waiting for it to finish, on success the output storage [[#UiReturnArg]] should be popped.

	[[Category:Library Applets]]		[[Category:Library Applets]]

Yellows8 at 18:03, 3 December 2019

2019-12-03T17:03:27Z

← Older revision		Revision as of 20:03, 3 December 2019
Line 1:		Line 1:
	This is the applet presented when launching a game that allows the user to select a user.		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 [[AM_services#IStorage\|IStorage]] inputs and a single [[AM_services#IStorage\|IStorage]] output~~.		See [[AM_services#Library_Applets]].

	== Library Applet Versions ==		== Library Applet Versions ==
Line 127:		Line 127:

	== UiReturnArg ==		== UiReturnArg ==
	This is "nn::account::UiReturnArg".		This is "nn::account::UiReturnArg". This is the struct for the output storage.

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
Line 133:		Line 133:
	! Offset \|\| Size \|\| Description		! Offset \|\| Size \|\| Description
	\|-		\|-
	\| 0x0 \|\| 0x8 \|\| Result		\| 0x0 \|\| 0x8 \|\| Result. Returned directly as the Result when launching is successful.
	\|-		\|-
	\| 0x8 \|\| 0x10 \|\| Uid of selected user.		\| 0x8 \|\| 0x10 \|\| Uid of selected user, only used with [[#UiMode\|UserSelector]] when no error is thrown (see above Result).
	\|}		\|}

Line 153:		Line 153:

	== UserSelectionPurpose ==		== UserSelectionPurpose ==
	This is "nn::account::UserSelectionPurpose".		This is "nn::account::UserSelectionPurpose". This controls the UI message text to display with [[#UiMode\|UserSelector]]. Invalid values are handled as value 0.

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
	! Value \|\| Description		! Value \|\| Description \|\| UI message text
	\|-		\|-
	\| 0 \|\| General		\| 0 \|\| General \|\| "Select a user."
	\|-		\|-
	\| 1 \|\| GameCardRegistration		\| 1 \|\| [2.0.0+] GameCardRegistration \|\| "Who will receive the points?"
	\|-		\|-
	\| 2 \|\| EShopLaunch		\| 2 \|\| [2.0.0+] EShopLaunch \|\| "Who is using Nintendo eShop?"
	\|-		\|-
	\| 3 \|\| EShopItemShow		\| 3 \|\| [2.0.0+] EShopItemShow \|\| "Who is making this purchase?"
	\|-		\|-
	\| 4 \|\| PicturePost		\| 4 \|\| [2.0.0+] PicturePost \|\| "Who is posting?"
	\|-		\|-
	\| 5 \|\| NintendoAccountLinkage		\| 5 \|\| [2.0.0+] NintendoAccountLinkage \|\| "Select a user to link to a Nintendo Account."
	\|-		\|-
	\| 6 \|\| SettingsUpdate		\| 6 \|\| [2.0.0+] SettingsUpdate \|\| "Change settings for which user?"
	\|-		\|-
	\| 7 \|\| SaveDataDeletion		\| 7 \|\| [2.0.0+] SaveDataDeletion \|\| "Format data for which user?"
	\|-		\|-
	\| 8 \|\| UserMigration		\| 8 \|\| [4.0.0+] UserMigration \|\| "Which user will be transferred to another console?"
	\|-		\|-
	\| 9 \|\| SaveDataTransfer(?)		\| 9 \|\| [8.0.0+] SaveDataTransfer(?) \|\| "Send save data for which user?"
	\|}		\|}

	== Usage ==		== 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~~.		User-processes should push a common arguments struct and [[#UiSettings]]. Official sw can optionally push an additional storage from [[Applet_Manager_services#CreateTransferMemoryStorage\|CreateTransferMemoryStorage]] with flag=0 using an input buffer when that input buffer is not NULL, however sdknso itself doesn't use this besides a wrapper func which sdknso itself doesn't call. After launching the applet and waiting for it to finish, on success the output storage [[#UiReturnArg]] should be popped.

	[[Category:Library Applets]]		[[Category:Library Applets]]

Yellows8: /* UserSelectionSettings */

2019-12-03T05:03:03Z

UserSelectionSettings

← Older revision		Revision as of 08:03, 3 December 2019
Line 108:		Line 108:
	\| 0x84 \|\| 0x1 \|\| [6.0.0+] u8 isUnqualifiedUserSelectable		\| 0x84 \|\| 0x1 \|\| [6.0.0+] u8 isUnqualifiedUserSelectable
	\|}		\|}

			ShowUserSelector* calls ShowUserSelectorCommon for launching the applet, which does the following:
			* When isSkipEnabled is set, the first user in invalidUidList must not be set, and additionalSelect must be 0 (asserting otherwise). When enabled [[Account_services#TrySelectUserWithoutInteraction\|TrySelectUserWithoutInteraction]] will be used to select the user (with isNetworkServiceAccountRequired), in this case the applet will only be launched if that cmd doesn't return an user.

	== UserSelectionSettingsForSystemService ==		== UserSelectionSettingsForSystemService ==

Yellows8 at 05:57, 3 December 2019

2019-12-03T04:57:41Z

← Older revision		Revision as of 07:57, 3 December 2019
Line 24:		Line 24:
	\| 0x0 \|\| 0x4 \|\| [[#UiMode]]		\| 0x0 \|\| 0x4 \|\| [[#UiMode]]
	\|-		\|-
	\| 0x4 \|\| 0x4 \|\|		\| 0x4 \|\| 0x4 \|\| Padding.
	\|-		\|-
	\| 0x8 \|\| 0x80 \|\| u128 invalidUidList[8]. This is copied from [[#UserSelectionSettings]].		\| 0x8 \|\| 0x80 \|\| u128 invalidUidList[8]. This is copied from [[#UserSelectionSettings]].
Line 36:		Line 36:
	\| 0x92 \|\| 0x1 \|\| Set to 0x1 by ShowUserSelectorForSystem/ShowUserSelectorForLauncher.		\| 0x92 \|\| 0x1 \|\| Set to 0x1 by ShowUserSelectorForSystem/ShowUserSelectorForLauncher.
	\|-		\|-
	\| 0x93 \|\| 0x1 \|\| u8 isPermitted. ShowUserSelector* sets this to the output bool from [[Account_services#IsUserRegistrationRequestPermitted\|IsUserRegistrationRequestPermitted]].		\| 0x93 \|\| 0x1 \|\| u8 isPermitted. ShowUserSelector* sets this to the output bool from [[Account_services#IsUserRegistrationRequestPermitted\|IsUserRegistrationRequestPermitted]]. With [[#UiMode\|UserSelector]] this enables the option to create a new user. When not set, a dialog will be displayed when the user attempts to create an user.
	\|-		\|-
	\| 0x94 \|\| 0x1 \|\| u8 showSkipButton. This is copied from [[#UserSelectionSettings]].		\| 0x94 \|\| 0x1 \|\| u8 showSkipButton. This is copied from [[#UserSelectionSettings]].
Line 100:		Line 100:
	\| 0x80 \|\| 0x1 \|\| u8 isSkipEnabled		\| 0x80 \|\| 0x1 \|\| u8 isSkipEnabled
	\|-		\|-
	\| 0x81 \|\| 0x1 \|\| u8 isNetworkServiceAccountRequired		\| 0x81 \|\| 0x1 \|\| u8 isNetworkServiceAccountRequired. Whether the user needs to be linked to a Nintendo account.
	\|-		\|-
	\| 0x82 \|\| 0x1 \|\| u8 showSkipButton		\| 0x82 \|\| 0x1 \|\| u8 showSkipButton. Enables the option to skip user selection with a button.
	\|-		\|-
	\| 0x83 \|\| 0x1 \|\| u8 additionalSelect		\| 0x83 \|\| 0x1 \|\| u8 additionalSelect
Line 118:		Line 118:
	\| 0x0 \|\| 0x4 \|\| [[#UserSelectionPurpose]]		\| 0x0 \|\| 0x4 \|\| [[#UserSelectionPurpose]]
	\|-		\|-
	\| 0x4 \|\| 0x1 \|\|		\| 0x4 \|\| 0x1 \|\| Enables the user-creation button when set. Whether user-creation when pressing the button is actually allowed is controlled by [[#UiSettings]] isPermitted.
	\|-		\|-
	\| 0x5 \|\| 0x3 \|\| u8 padding[3]		\| 0x5 \|\| 0x3 \|\| u8 padding[3]
Line 130:		Line 130:
	! Offset \|\| Size \|\| Description		! Offset \|\| Size \|\| Description
	\|-		\|-
	\| 0x0 \|\| 0x8 \|\| Result ~~(0 = Success, 2 = Failure)~~		\| 0x0 \|\| 0x8 \|\| Result
	\|-		\|-
	\| 0x8 \|\| 0x10 \|\| ~~UUID~~ of selected user		\| 0x8 \|\| 0x10 \|\| Uid of selected user.
	\|}		\|}

SciresM: /* UserSelectionPurpose */

2019-12-03T03:42:42Z

UserSelectionPurpose

← Older revision		Revision as of 06:42, 3 December 2019
Line 173:		Line 173:
	\|-		\|-
	\| 8 \|\| UserMigration		\| 8 \|\| UserMigration
			\|-
			\| 9 \|\| SaveDataTransfer(?)
	\|}		\|}

SciresM: /* NintendoAccountStartupDialogType */

2019-12-03T03:38:43Z

NintendoAccountStartupDialogType

@@ Line 147: / Line 147: @@
 |-
 | 2 || Create
 |}

SciresM: /* UserSelectionSettingsForSystemService */

2019-12-03T03:37:05Z

UserSelectionSettingsForSystemService

← Older revision		Revision as of 06:37, 3 December 2019
Line 116:		Line 116:
	! Offset \|\| Size \|\| Description		! Offset \|\| Size \|\| Description
	\|-		\|-
	\| 0x0 \|\| 0x4 \|\|		\| 0x0 \|\| 0x4 \|\| [[#UserSelectionPurpose]]
	\|-		\|-
	\| 0x4 \|\| 0x1 \|\|		\| 0x4 \|\| 0x1 \|\|

SciresM: /* NintendoAccountStartupDialogType */

2019-12-03T03:27:17Z

NintendoAccountStartupDialogType

← Older revision		Revision as of 06:27, 3 December 2019
Line 142:		Line 142:
	! Value \|\| Description		! Value \|\| Description
	\|-		\|-
	\| 0 \|\|		\| 0 \|\| LoginAndCreate
	\|-		\|-
	\| 1 \|\|		\| 1 \|\| Login
	\|-		\|-
	\| 2 \|\|		\| 2 \|\| Create
	\|}		\|}

Yellows8: /* UiSettings */

2019-12-03T01:38:50Z

UiSettings

← Older revision		Revision as of 04:38, 3 December 2019
Line 34:		Line 34:
	\| 0x91 \|\| 0x1 \|\| u8 isSkipEnabled. This is copied from [[#UserSelectionSettings]].		\| 0x91 \|\| 0x1 \|\| u8 isSkipEnabled. This is copied from [[#UserSelectionSettings]].
	\|-		\|-
	\| 0x92 \|\| 0x1 \|\| Set to 0x1 by ShowUserSelectorForLauncher.		\| 0x92 \|\| 0x1 \|\| Set to 0x1 by ShowUserSelectorForSystem/ShowUserSelectorForLauncher.
	\|-		\|-
	\| 0x93 \|\| 0x1 \|\| u8 isPermitted. ShowUserSelector* sets this to the output bool from [[Account_services#IsUserRegistrationRequestPermitted\|IsUserRegistrationRequestPermitted]].		\| 0x93 \|\| 0x1 \|\| u8 isPermitted. ShowUserSelector* sets this to the output bool from [[Account_services#IsUserRegistrationRequestPermitted\|IsUserRegistrationRequestPermitted]].