Files
AnyPS5/docs/dev/debt/libSceUserService.md
T
Dean f47e079ec6 Merge pull request #11505 from milescoviello/docs/userservice-get-event-call-sites
docs(libSceUserService): note how six titles handle sceUserServiceGetEvent
2026-10-29 12:05:12 +13:00

5.1 KiB

libSceUserService technical debt

Unknown function info

  • sceUserServiceGetNpAccountId (libSceUserService) - the account id for a user with no linked PSN account is assumed to be 0 with success; libSceNpManager's sceNpGetAccountIdA answers the same question with SCE_NP_ERROR_SIGNED_OUT
  • sceUserServiceInitialize and sceUserServiceInitialize2 (libSceUserService) - event delivery has no background service thread, so the confirmed priority and Initialize2 CPU affinity mask do not affect host scheduling.
  • sceUserServiceGetUserColor (libSceUserService) - the profile colour corresponds to user index (0: blue, 1: red, 2: green, 3: pink); colours 1, 2 and 3 are assumed, not measured
  • sceUserServiceGetUserName (libSceUserService) - 0x80960105, which a PS5 (firmware 13.60) returns for a user id it does not know, has no known name; it is USER_SERVICE_ERROR_UNKNOWN_USER here. On the console a registered user who is not logged in still gets their name; here up to 4 users ("Player", "Player2", "Player3", "Player4") are supported; user names "Player2", "Player3" and "Player4" are assumed, not measured
  • sceUserServiceGetEvent (libSceUserService) - login and logout events queued dynamically on controller hotplug have no source and are assumed, not measured. Six titles disassembled for this entry drain the queue until the call returns nonzero. PPSA01494 01.100.002 (at 0x374C0C6), PPSA30839 01.003.000 (0x4DF3F0), PPSA31162 02.000.001 (0x550ED0) and PPSA34502 01.010.000 (0x30035C, 0x300433) act only on event_type 0 and 1, reading user_id at offset 4 for both, and skip other types. PPSA18194 01.004.003 (0x16D44A3) tells NOT_INITIALIZED (0x80960002) and NO_EVENT (0x80960007) apart and logs any other error. PPSA21564 01.007.000 copies each 8-byte event into a list at one site (0x2AFCA8) and discards them at the other (0x2B6CF3)
  • sceUserServiceGetAgeLevel (libSceUserService) - on a PS5 (firmware 13.60) the value is the age set in the user's parental restriction (0, 7, 12 and 15 were measured) and 0xFFFFFFFF without one; a user who is not logged in returns 0x80960009 with or without an output. Parental restrictions are not modelled, so the initial user is always reported as unrestricted. PPSA12544 (Unity) only stores the value for its user profile. The one call in PPSA12544 (0x16a80a0), made only when bit 0x4 of its flags is set, writes the value to a field of its own object (offset 0x5170) and ends its chain of getters on any nonzero result; what it does with the value afterwards was not read.
  • sceUserServiceGetAccessibilityChatTranscription, PressAndHoldDelay, TriggerEffect, Vibration, ZoomEnabled, ZoomFollowFocus (libSceUserService) - report 0, 0, 1, 1, 0 and 1, what a PS5 (firmware 13.60) reports for a user whose accessibility settings are all at their defaults; the console reports the user's own settings (a changed vibration intensity read 3), which are not modelled. What each number means is unknown. A user who is not logged in returns 0x80960009 with or without an output. One title (PPSA04354) disassembled for this entry calls all six in a row (first at 0xea0efa) with its user ID, only when a flag bit (0x10) is set; a result other than 0 from any of them ends the block and is returned, and only when all six return 0 does it store the six values in its object.
  • sceUserServiceGetKeyboardType, sceUserServiceGetJapaneseInputType, sceUserServiceGetTraditionalChineseInputType (libSceUserService) - AnyPS5 stores no per-user keyboard setting, so the initial user reports the keyboard type of the configured system language (ANYPS5_LANGUAGE, English US by default) and 0 for the two input variants, and any other user id returns USER_SERVICE_ERROR_UNKNOWN_USER. The language-to-keyboard-type table is the repository owner's (languages 0 to 29); a valid language outside it, such as Ukrainian (30), reports 20 (US English). A value that is not a console language number is rejected by sceSystemServiceParamGetInt with an error naming ANYPS5_LANGUAGE; the call throws it and leaves the output untouched. The input variant is 0 because the owner's table gives 0 for Japanese and Traditional Chinese, the only languages needing one. sceConvertKeycodeGetImeKeyboardType consumes these values.
  • sceUserServiceGetPlatformPrivacyWs1 (libSceUserService) - the platform privacy setting for an offline user without a linked PSN account is assumed to be 0 (not permitted) with success; actual console privacy querying is not modelled. Return of 0x80960009 (USER_SERVICE_ERROR_NOT_LOGGED_IN) with or without an output for a user who is not logged in is borrowed from sceUserServiceGetAgeLevel and is not measured for this call.