Nintendo Switch Brew

Changes

Internet Browser (view source)

Revision as of 18:22, 22 March 2022

21,256 bytes added ,  18:22, 22 March 2022
→‎Heap
Line 22: Line 22:  
| [[4.0.0]]
 
| [[4.0.0]]
 
| Mozilla/5.0 (Nintendo Switch; <appletname>) AppleWebKit/601.6 (KHTML, like Gecko) NF/4.0.0.7.9 NintendoBrowser/5.1.0.15785
 
| Mozilla/5.0 (Nintendo Switch; <appletname>) AppleWebKit/601.6 (KHTML, like Gecko) NF/4.0.0.7.9 NintendoBrowser/5.1.0.15785
 +
|-
 +
| [[5.0.0]]
 +
| Mozilla/5.0 (Nintendo Switch; <appletname>) AppleWebKit/601.6 (KHTML, like Gecko) NF/4.0.0.8.9 NintendoBrowser/5.1.0.16739
 +
|-
 +
| [[5.1.0]]
 +
| Mozilla/5.0 (Nintendo Switch; <appletname>) AppleWebKit/601.6 (KHTML, like Gecko) NF/4.0.0.9.3 NintendoBrowser/5.1.0.16958
 +
|-
 +
| [[6.0.0]]
 +
| Mozilla/5.0 (Nintendo Switch; <appletname>) AppleWebKit/601.6 (KHTML, like Gecko) NF/4.0.0.10.13 NintendoBrowser/5.1.0.17805
 +
|-
 +
| [[6.1.0]]
 +
| Mozilla/5.0 (Nintendo Switch; <appletname>) AppleWebKit/601.6 (KHTML, like Gecko) NF/4.0.0.10.14 NintendoBrowser/5.1.0.17806
 +
|-
 +
| [[10.0.0]]
 +
| Mozilla/5.0 (Nintendo Switch; <appletname>) AppleWebKit/606.4 (KHTML, like Gecko) NF/6.0.1.15.4 NintendoBrowser/5.1.0.20389
 
|}
 
|}
   Line 57: Line 72:  
|-
 
|-
 
| LoginApplet
 
| LoginApplet
−
| Nintendo Account linking
+
| Nintendo Account linking, and for linking Facebook and Twitter to suggest friends
 
| Just displays an error-code.
 
| Just displays an error-code.
 
| Yes
 
| Yes
Line 71: Line 86:  
|-
 
|-
 
| LobbyApplet
 
| LobbyApplet
−
| Related to online-multiplayer lobbies
+
| "Nintendo Switch Online Lounge"
 
| Just displays an error-code.
 
| Just displays an error-code.
 
| Yes
 
| Yes
 +
| 0100000000001010
 +
|
 +
|-
 +
| NsoApplet
 +
| Nintendo Switch Online menu
 +
|
 +
|
 
| 0100000000001010
 
| 0100000000001010
 
|  
 
|  
Line 97: Line 119:  
WifiWebAuthApplet does not fully support playing videos. It will [[Error_codes|assert]] with normal videos. The assert triggers before it even starts MP4 parsing?(For example, selecting a video from a video-tag will assert even though it doesn't send any network request for it) However, in some cases with certain MP4s using vulns it will display an error dialog instead.
 
WifiWebAuthApplet does not fully support playing videos. It will [[Error_codes|assert]] with normal videos. The assert triggers before it even starts MP4 parsing?(For example, selecting a video from a video-tag will assert even though it doesn't send any network request for it) However, in some cases with certain MP4s using vulns it will display an error dialog instead.
   −
With v3.0 WifiWebAuthApplet video-playback was disabled, it now throws the following error when attempting to play a video: "Support Code: 2809-1212" "This feature is not available." On past system-versions it would just trigger a fatal-error(see above). Video-playback which already worked fine under whitelisted-applet, still works fine on v3.0.
+
With v3.0 WifiWebAuthApplet video-playback was disabled, it now throws the following error when attempting to play a video: "Support Code: 2809-1212" "This feature is not available." On past system-versions it would just trigger a fatal-error(see above). Video playback still works on the whitelisted applets following v3.0.0, which allows video playback through Facebook and embedded into Google Sites.
    
== Trusted RootCAs ==
 
== Trusted RootCAs ==
Line 108: Line 130:     
Prior to version [[3.0.0]], this applet was launched when attempting a system update from recovery mode if needed. This was changed to display a "This feature is not available." popup instead.
 
Prior to version [[3.0.0]], this applet was launched when attempting a system update from recovery mode if needed. This was changed to display a "This feature is not available." popup instead.
 +
 +
The conntest URL from [[#WebWifiPageArg]] is used to poll whether the connection is usable, with the SDK [[libcurl]].
    
==Whitelisted Applets==
 
==Whitelisted Applets==
Line 121: Line 145:  
  ^https://([0-9A-Za-z\-]+\.)*facebook\.com(/|$)
 
  ^https://([0-9A-Za-z\-]+\.)*facebook\.com(/|$)
 
  ^https://([0-9A-Za-z\-]+\.)*twitter\.com(/|$)</nowiki>
 
  ^https://([0-9A-Za-z\-]+\.)*twitter\.com(/|$)</nowiki>
 +
 +
[3.0.0+]: The "google\.(com" line now starts with "^https://" instead of "https?://", hence plain HTTP is no longer allowed. The following line was added right after the original google line: "---- ^https?://([0-9A-Za-z\-]+\.)*google(\.[A-Za-z]+)*/(search|translate)\?"
 +
 +
[4.0.0+]: Lines 2-4 ("...nintendo\.(co...", "nintendo-europe", and "nintendoservicecentre") now starts with "^https://" instead of "https?://". Hence, plain HTTP for these are no longer allowed.
    
===ShareApplet===
 
===ShareApplet===
−
The initial page loaded by this applet depends on a flag. <nowiki>non-val1: "https://web-lp1.share.srv.nintendo.net/" val1: "https://web-lp1.share.srv.nintendo.net/settings/"</nowiki>
+
The initial page loaded by this applet is controlled by the [[#ShareStartPage]] TLV.
   −
The server will return a HTTP 302 redirect to <nowiki>"https://nintendo.com/"</nowiki> when the specified User-Agent isn't the one for ShareApplet.
+
The "web-lp1.share.srv.nintendo.net" site will return a HTTP 302 redirect to <nowiki>"https://nintendo.com/"</nowiki> when the specified User-Agent isn't the one for ShareApplet.
    
===LobbyApplet===
 
===LobbyApplet===
 +
Support for Lobby was added with [2.0.0+]. This applet is for "Nintendo Switch Online Lounge"
 +
 
The initial page loaded by this applet is: <nowiki>"https://web-lp1.znc.srv.nintendo.net/lobby/"</nowiki>.
 
The initial page loaded by this applet is: <nowiki>"https://web-lp1.znc.srv.nintendo.net/lobby/"</nowiki>.
   Line 137: Line 167:  
   You can invite friends to the room via
 
   You can invite friends to the room via
 
   the Nintendo Switch Online Lounge app.
 
   the Nintendo Switch Online Lounge app.
 +
 +
=== NsoApplet ===
 +
[11.0.0+] This applet handles the new Nintendo Switch Online menu, which is launched from qlaunch.
 +
 +
The initial page loaded by this applet is: <nowiki>"https://%.nso.nintendo.net/</nowiki>{string from [[#TLVs|TLV]] 0x2}"
    
== ShopN ==
 
== ShopN ==
−
The initial page loaded by ShopN seems to be the following: <nowiki>"https://bugyo.hac.lp1.eshop.nintendo.net/ashigaru/"</nowiki>.
+
The initial page loaded by ShopN is: <nowiki>"https://bugyo.hac.lp1.eshop.nintendo.net/ashigaru/"</nowiki>.
−
This can be accessed via computer possesed the certificat ShopN.
+
This can be accessed via computer possesed the certificate ShopN.
    
The file at "data:/whitelist/WhitelistEc.txt", which doesn't exist in WifiWebAuthApplet, contains the following:
 
The file at "data:/whitelist/WhitelistEc.txt", which doesn't exist in WifiWebAuthApplet, contains the following:
Line 183: Line 218:     
== Heap ==
 
== Heap ==
 +
The size used for [[SVC|svcSetHeapSize]] by the web-applets is 0x15600000. Under ShopN, the largest size that can be passed to this without an error being returned, is 0x1B400000.
 +
 +
The size used by title 010000000000100A (on 10.0.0 at least) is 0x14200000.
 +
 +
The heap for the main-codebin (<code>malloc</code>/<code>operator new</code>) uses nn::lmem::*ExpHeap. [8.0.0+] <code>malloc</code>/<code>operator new</code> now checks the return-addr (addr located in a relevant NRO), with wkc_malloc_crashonfailure being called for the allocation if the check passes, otherwise a normal allocation is done (the code which runs for this will Abort if allocation fails).
 +
 +
<code>malloc</code> passes the input size directly to the called func. <code>operator new</code> when handling normal non-wkc allocations passes the following to the called func: <code>sxtw x1, {inw0}</code> (for wkc allocations the size is passed directly). [12.1.0+] The size is now passed directly (64bit) without using sxtw.
 +
 +
[11.0.0+] There's now optional code for using [[SVC|svcMapPhysicalMemoryUnsafe]] etc, however it's unknown what sets the flag for this. An Abort string used this is: "{path}/TransferredMemoryManager.cpp"
 +
 +
== Applet Launching ==
 +
The web-applets are launched using a storage containing the input arg data, on exit the output storage contains the "*ReturnValue" reply data.
 +
 +
Input/output storage size for TLV data is 0x2000-bytes.
 +
 +
=== Library Applet Versions ===
 +
{| class="wikitable" border="1"
 +
|-
 +
! System Version || Value
 +
|-
 +
| [1.0.0+] || 0x20000
 +
|-
 +
| [3.0.0+] || 0x30000
 +
|-
 +
| [5.0.0+] || 0x50000
 +
|-
 +
| [6.0.0+] || 0x60000
 +
|-
 +
| [8.0.0+] || 0x80000
 +
|}
 +
 +
The above only (?) applies to non-WebWifi. WebWifi uses version 0x0.
 +
 +
=== ShimKind ===
 +
This enum is "nn::web::common::ShimKind".
 +
 +
This indicates the type of web-applet.
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Value
 +
!  Name
 +
|-
 +
| 1
 +
| Shop
 +
|-
 +
| 2
 +
| Login
 +
|-
 +
| 3
 +
| Offline
 +
|-
 +
| 4
 +
| Share
 +
|-
 +
| 5
 +
| Web
 +
|-
 +
| 6
 +
| Wifi
 +
|-
 +
| 7
 +
| Lobby
 +
|-
 +
| 8
 +
| [[#NsoApplet|Lhub]]
 +
|}
 +
 +
=== WebSession ===
 +
With [5.0.0+] sdk-nso added <code>nn::web::Session::</code>. With [6.0.0+] this was removed, however it was reintroduced with [7.0.0+] as <code>nn::web::*WebSession</code> (for ShimKind Offline and Web).
 +
 +
This is for sending/receiving [[#SessionMessage]]s via applet Interactive storage.
 +
 +
During state init, max_messages is set to 0xA ([7.0.0+] 0x10), with message_count=0 and cur_size=0. [5.0.0-5.1.0] max_size is set to 0x5000. [7.0.0+] Two queues are used for message_count/cur_size: first one is for BrowserEngineContent (max_size 0x8000 is used), the second one is for non-BrowserEngineContent (max_size 0x1000 is used).
 +
 +
When sending messages, there has to be an available message slot available (<code>max_messages!=message_count</code>), and there has to be enough space available (<code>msghdr_contentsize+0x10 + cur_size <= max_size</code>). After pushing the storage, message_count is incremented and cur_size is increased by <code>msghdr_contentsize+0x10</code>.
 +
 +
When receiving messages, it will repeatedly pop Interactive output storage until no more are available. Non-Ack messages are Acked.
 +
* Ack: Verifies that message_count is not already 0, then decrements it. Then cur_size is decreased by the u32 loaded from msgcontent+0.
 +
* 0x0: Does some validation. Reads the message content into the user buffer, when contentsize is non-zero. The original contentsize is written to an user output param. The last byte in the user buffer (contentsize clamped to the user max-buf-size, -1) is set to 0 for NUL-termination.
 +
 +
Next info was tested in 9.0.0
 +
 +
In the js side (which is only available when enabled via the JsExtensionEnabled TLV), there is a method called <code>window.nx.sendMessage(arg)</code> that sends data to the native side, this method returns a boolean indicating if sending was successful and accepts a string as an argument. The string is encoded like a C null terminated string in the message content. For receive messages from native part, there is a dom event called <code>message</code> which is dispatched when a message arrives. The event can be listened using <code>window.nx.addEventListener("message", callback)</code> being callback a function which first parameter is like a dom event arg and contains a member called <code>data</code> which contains the string decoded from the arrived message.
 +
 +
If messages aren't acked by the native part, js side will not longer receive messages. Ack to web applet '''must''' have 4 bytes after the message content or the applet will Abort.
 +
 +
==== SessionMessage ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Offset
 +
!  Size
 +
!  Description
 +
|-
 +
| 0x0
 +
| 0x10
 +
| [[#SessionMessageHeader]]
 +
|-
 +
| 0x10
 +
| Size from header
 +
| Message content
 +
|-
 +
| After message content
 +
| 0x4 if message is ack, 0x0 otherwise
 +
| Padding
 +
|}
 +
 +
==== SessionMessageHeader ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Offset
 +
!  Size
 +
!  Description
 +
|-
 +
| 0x0
 +
| 0x4
 +
| Message Kind ([[#WebSessionSendMessageKind]] / [[#WebSessionReceiveMessageKind]])
 +
|-
 +
| 0x4
 +
| 0x4
 +
| Data size following the header.
 +
|-
 +
| 0x8
 +
| 0x8
 +
| Unused
 +
|}
 +
 +
==== WebSessionSendMessageKind ====
 +
This is "nn::web::detail::WebSessionSendMessageKind".
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
!  ID
 +
!  Content size
 +
!  Description
 +
|-
 +
| 0x0
 +
| Arbitrary
 +
| BrowserEngine Content, NUL-terminated string. Used to communicate with the applet via JsExtensions used by the Js being run by the applet on the current page.
 +
|-
 +
| 0x100
 +
| 0x0
 +
| SystemMessage Appear. Requests the applet to Appear, this is only needed with [[#WebSessionBootMode]] AllForegroundInitiallyHidden.
 +
|-
 +
| 0x1000
 +
| 0xC
 +
| Ack. Content: first u32 is the entire storage size of the message being acked, the rest is not used.
 +
|}
 +
 +
==== WebSessionReceiveMessageKind ====
 +
This is "nn::web::detail::WebSessionReceiveMessageKind".
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
!  ID
 +
!  Content size
 +
!  Description
 +
|-
 +
| 0x0
 +
| Arbitrary
 +
| BrowserEngine Content, see [[#WebSessionSendMessageKind]].
 +
|-
 +
| 0x1000
 +
| 0xC
 +
| Ack BrowserEngine
 +
|-
 +
| 0x1001
 +
| 0xC
 +
| Ack SystemMessage
 +
|}
 +
 +
=== WebWifiPageArg ===
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Offset
 +
!  Size
 +
!  Description
 +
|-
 +
| 0x0 || 0x4 || Official sw sets this to 0 with appletStorageWrite, separately from the rest of the config struct.
 +
|-
 +
| 0x4 || 0x100 || URL used for the connection-test requests.
 +
|-
 +
| 0x104 || 0x400 || Initial URL navigated to by the applet.
 +
|-
 +
| 0x504 || 0x10 || NIFM Network UUID. Can be value zero. Only used by the applet when conntest_url is set.
 +
|-
 +
| 0x514 || 0x4 || Input value for nifm cmd SetRequirementByRevision. Can be value zero. Only used by the applet when conntest_url is set.
 +
|}
 +
 +
This is the input struct for WifiWebAuthApplet. This is a total of 0x518-bytes.
 +
 +
When the conntest_url is empty, the applet will test the connection with nifm and throw an error on failure.
 +
 +
=== WebWifiReturnValue ===
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Offset
 +
!  Size
 +
!  Description
 +
|-
 +
| 0x0 || 0x4 || ?
 +
|-
 +
| 0x4 || 0x8 || Result
 +
|}
 +
 +
This is the output struct for WifiWebAuthApplet. This is a total of 0x8-bytes.
 +
 +
=== WebCommonReturnValue ===
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Offset
 +
!  Size
 +
!  Description
 +
|-
 +
| 0x0 || 0x4 || u32 exitReason
 +
|-
 +
| 0x4 || 0x4 || Padding
 +
|-
 +
| 0x8 || 0x1000 || lastUrl string
 +
|-
 +
| 0x1008 || 0x8 || lastUrlSize
 +
|}
 +
 +
This is the 0x1010-byte output storage used by all non-WebWifi applets - except for Share which returns a TLV storage on [3.0.0+], and Web on [8.0.0+].
 +
 +
=== WebArgHeader ===
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Offset
 +
!  Size
 +
!  Description
 +
|-
 +
| 0x0 || 0x2 || Total [[#WebArgTLV]] entries following this struct.
 +
|-
 +
| 0x2 || 0x2 || Padding
 +
|-
 +
| 0x4 || 0x4 || [[#ShimKind]]
 +
|}
   −
The size used for [[SVC|svcSetHeapSize]] by the web-applets is 0x15600000. Under ShopN, the largest size that can be passed to this without an error being returned, is 0x1B400000.
+
This is the header struct at offset 0 in the input web Arg storage for non-WebWifi. This is a total of 0x8-bytes. The total storage size used for input/output TLVs is 0x2000.
 +
 
 +
=== WebArgTLV ===
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Offset
 +
!  Size
 +
!  Description
 +
|-
 +
| 0x0 || 0x2 || Type of this arg.
 +
|-
 +
| 0x2 || 0x2 || Size of the arg data following this struct.
 +
|-
 +
| 0x4 || 0x4 || Padding
 +
|}
 +
 
 +
Web TLV used in the input web Arg storage, after [[#WebArgHeader]]. This is a total of 0x8-bytes.
 +
 
 +
=== WebBootFooterButtonEntry ===
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Offset
 +
!  Size
 +
!  Description
 +
|-
 +
| 0x0 || 0x4 || [[#FooterButtonId]]
 +
|-
 +
| 0x4 || 0x1 || u8 bool visible flag
 +
|-
 +
| 0x5 || 0x2 || ?
 +
|-
 +
| 0x7 || 0x1 || ?
 +
|}
 +
 
 +
=== TLVs ===
 +
All strings are NUL-terminated.
 +
 
 +
==== Input TLVs ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  System Version
 +
!  Applets
 +
!  Type
 +
!  Size
 +
!  Value
 +
!  Description
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x1
 +
| 0xC00
 +
| string
 +
| Initial URL
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x3
 +
| 0x400
 +
| string
 +
| CallbackUrl
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x4
 +
| 0x400
 +
| string
 +
| CallbackableUrl
 +
|-
 +
| [1.0.0+]
 +
| Offline
 +
| 0x5
 +
| 0x8
 +
| u64 titleID
 +
| ApplicationId, for DocumentKind_OfflineHtmlPage/DocumentKind_ApplicationLegalInformation. Should be zero for DocumentKind_OfflineHtmlPage since it's ignored.
 +
|-
 +
| [1.0.0+]
 +
| Offline
 +
| 0x6
 +
| 0xC00
 +
| string
 +
| DocumentPath
 +
|-
 +
| [1.0.0+]
 +
| Offline
 +
| 0x7
 +
| 0x4
 +
| u32 enum OfflineDocumentKind
 +
| [[#DocumentKind]]
 +
|-
 +
| [1.0.0+]
 +
| Offline
 +
| 0x8
 +
| 0x8
 +
| u64 titleID
 +
| SystemDataId, for DocumentKind_SystemDataPage.
 +
|-
 +
|
 +
| Share
 +
| 0x9
 +
| 0x4
 +
| u32 enum [[#ShareStartPage]]
 +
| ShareStartPage
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0xA
 +
| 0x1000
 +
| string
 +
| Whitelist. If not formatted properly, the applet will exit briefly after the applet is launched. Each line is a regex for each whitelisted URL.
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0xB
 +
| 0x1
 +
| u8 bool
 +
| News flag. When set the domain from the input URL is automatically whitelisted, in addition to any already loaded whitelist.
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0xE
 +
| 0x10
 +
| userID
 +
| userID, controls which user-specific savedata to mount.
 +
|-
 +
|
 +
| Share
 +
| 0xF
 +
| 0x20
 +
| [[Capture_services|AlbumEntry]]
 +
| AlbumEntry0
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x10
 +
| 0x1
 +
| u8 bool
 +
| ScreenShotEnabled. Controls whether screen-shot capture is allowed.
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x11
 +
| 0x1
 +
| u8 bool
 +
| EcClientCertEnabled
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x12
 +
| 0x1
 +
| u8
 +
| ?
 +
|-
 +
| [1.0.0+]
 +
| Offline
 +
| 0x13
 +
| 0x1
 +
| u8 bool
 +
| PlayReportEnabled
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x14
 +
| 0x1
 +
| u8
 +
| ?
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x15
 +
| 0x1
 +
| u8
 +
| ?
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x17
 +
| 0x4
 +
| u32 enum [[#BootDisplayKind]]
 +
| BootDisplayKind
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x18
 +
| 0x4
 +
| u32 enum [[#BackgroundKind]]
 +
| BackgroundKind
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x19
 +
| 0x1
 +
| u8 bool
 +
| FooterEnabled. Controls whether the UI footer is enabled.
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x1A
 +
| 0x1
 +
| u8 bool
 +
| PointerEnabled
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x1B
 +
| 0x4
 +
| u32 enum [[#LeftStickMode]]
 +
| LeftStickMode
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x1C
 +
| 0x4
 +
| s32
 +
| KeyRepeatFrame, first param
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x1D
 +
| 0x4
 +
| s32
 +
| KeyRepeatFrame, second param
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x1E
 +
| 0x1
 +
| u8 bool
 +
| Set after BootAsMediaPlayer with the value inverted.
 +
|-
 +
| [1.0.0+]
 +
|
 +
| 0x1F
 +
| 0x1
 +
| u8 bool
 +
| DisplayUrlKind (<code>value = (input_enumval==0x1)</code>)
 +
|-
 +
| [2.0.0+]
 +
|
 +
| 0x21
 +
| 0x1
 +
| u8 bool
 +
| BootAsMediaPlayer
 +
|-
 +
| [2.0.0+]
 +
|
 +
| 0x22
 +
| 0x1
 +
| u8 bool
 +
| ShopJumpEnabled
 +
|-
 +
| [2.0.0+]
 +
|
 +
| 0x23
 +
| 0x1
 +
| u8 bool
 +
| [6.0.0+] MediaAutoPlayEnabled ([2.0.0-5.1.0] MediaPlayerUserGestureRestrictionEnabled)
 +
|-
 +
| [2.0.0+]
 +
|
 +
| 0x24
 +
| 0x100
 +
| string
 +
| LobbyParameter
 +
|-
 +
| [3.0.0+]
 +
| Share
 +
| 0x26
 +
| 0x20
 +
| [[Capture_services|ApplicationAlbumEntry]]
 +
| ApplicationAlbumEntry
 +
|-
 +
| [3.0.0+]
 +
|
 +
| 0x27
 +
| 0x1
 +
| u8 bool
 +
| JsExtensionEnabled
 +
|-
 +
| [4.0.0+]
 +
| Share
 +
| 0x28
 +
| 0x100
 +
| string
 +
| AdditionalCommentText
 +
|-
 +
| [4.0.0+]
 +
|
 +
| 0x29
 +
| 0x1
 +
| u8 bool
 +
| TouchEnabledOnContents
 +
|-
 +
| [4.0.0+]
 +
|
 +
| 0x2A
 +
| 0x80
 +
| string
 +
| UserAgentAdditionalString. " " followed by this string are appended to the normal User-Agent string.
 +
|-
 +
| [4.0.0+]
 +
| Share
 +
| 0x2B
 +
| 0x10
 +
| u8 array
 +
| AdditionalMediaData0 (If the user-input size is less than 0x10, the remaining tmp data used for the TLV is cleared)
 +
|-
 +
| [4.0.0+]
 +
|
 +
| 0x2C
 +
| 0x1
 +
| u8 bool
 +
| MediaPlayerAutoCloseEnabled
 +
|-
 +
| [4.0.0+]
 +
|
 +
| 0x2D
 +
| 0x1
 +
| u8 bool
 +
| PageCacheEnabled
 +
|-
 +
| [4.0.0+]
 +
|
 +
| 0x2E
 +
| 0x1
 +
| u8 bool
 +
| WebAudioEnabled
 +
|-
 +
| [5.0.0+]
 +
|
 +
| 0x2F
 +
| 0x1
 +
| u8
 +
| ?
 +
|-
 +
| [5.0.0+]
 +
|
 +
| 0x31
 +
| 0x1
 +
| u8 bool
 +
| When set, indicates the whitelist for YouTubeVideo should be used (loaded from web-applet RomFS).
 +
|-
 +
| [5.0.0+]
 +
|
 +
| 0x32
 +
| 0x4
 +
| u32 enum *WebFooterFixedKind
 +
| FooterFixedKind
 +
|-
 +
| [5.0.0+]
 +
|
 +
| 0x33
 +
| 0x1
 +
| u8 bool
 +
| PageFadeEnabled
 +
|-
 +
| [5.0.0+]
 +
| Share
 +
| 0x34
 +
| 0x20
 +
| s8 data[32]
 +
| MediaCreatorApplicationRatingAge
 +
|-
 +
| [5.0.0+]
 +
|
 +
| 0x35
 +
| 0x1
 +
| u8 bool
 +
| BootLoadingIconEnabled
 +
|-
 +
| [5.0.0+]
 +
|
 +
| 0x36
 +
| 0x1
 +
| u8 bool
 +
| PageScrollIndicatorEnabled
 +
|-
 +
| [6.0.0+]
 +
|
 +
| 0x37
 +
| 0x1
 +
| u8 bool
 +
| MediaPlayerSpeedControlEnabled
 +
|-
 +
| [6.0.0+]
 +
| Share
 +
| 0x38
 +
| 0x20
 +
| [[Capture_services|AlbumEntry]]
 +
| AlbumEntry1
 +
|-
 +
| [6.0.0+]
 +
| Share
 +
| 0x39
 +
| 0x20
 +
| [[Capture_services|AlbumEntry]]
 +
| AlbumEntry2
 +
|-
 +
| [6.0.0+]
 +
| Share
 +
| 0x3A
 +
| 0x20
 +
| [[Capture_services|AlbumEntry]]
 +
| AlbumEntry3
 +
|-
 +
| [6.0.0+]
 +
| Share
 +
| 0x3B
 +
| 0x10
 +
| u8 array
 +
| AdditionalMediaData1
 +
|-
 +
| [6.0.0+]
 +
| Share
 +
| 0x3C
 +
| 0x10
 +
| u8 array
 +
| AdditionalMediaData2
 +
|-
 +
| [6.0.0+]
 +
| Share
 +
| 0x3D
 +
| 0x10
 +
| u8 array
 +
| AdditionalMediaData3
 +
|-
 +
| [6.0.0+]
 +
| BootFooterButton
 +
| 0x3E
 +
| 0x80
 +
| Array of [[#WebBootFooterButtonEntry]] with 0x10 entries.
 +
| BootFooterButton
 +
|-
 +
| [6.0.0+]
 +
|
 +
| 0x3F
 +
| 0x4
 +
| float
 +
| OverrideWebAudioVolume
 +
|-
 +
| [6.0.0+]
 +
|
 +
| 0x40
 +
| 0x4
 +
| float
 +
| OverrideMediaAudioVolume
 +
|-
 +
| [7.0.0+]
 +
|
 +
| 0x41
 +
| 0x4
 +
| u32 enum [[#WebSessionBootMode]]
 +
| BootMode
 +
|-
 +
| [7.0.0+]
 +
|
 +
| 0x42
 +
| 0x1
 +
| u8 bool
 +
| Enables using [[#WebSession]] when set.
 +
|-
 +
| [8.0.0+]
 +
| Offline
 +
| 0x43
 +
| 0x1
 +
| u8 bool
 +
| MediaPlayerUiEnabled
 +
|-
 +
| [11.0.0+]
 +
|
 +
| 0x44
 +
| 0x1
 +
| bool
 +
| TransferMemoryEnabled
 +
|}
 +
 
 +
Offline: title to load the content from is controlled by ApplicationId/SystemDataId. With DocumentKind_OfflineHtmlPage, it will ignore this and only load from the user-process title.
 +
 
 +
Offline DocumentPath: Initial document path in RomFS, without the leading '/'. For DocumentKind_OfflineHtmlPage, this is relative to "html-document/" in RomFS. For the other DocumentKind values, this is relative to "/" in RomFS. This path must contain ".htdocs/".
 +
 
 +
Share/Lobby: if a non-zero userID isn't set, the applet will launch the profile-selector applet to select an account.
 +
 
 +
Share: An error will be displayed if neither AlbumEntry or ApplicationAlbumEntry are set, with [[#ShareStartPage|ShareStartPage_Default]].
 +
 
 +
[6.0.0+] <code>AddAlbumEntryAndMediaData</code> was added:
 +
* Looks for AlbumEntry{N} TLVs, when a TLV is not found it is written, then the associated AdditionalMediaData{N} TLV is written the same way as AdditionalMediaData0. If all AlbumEntry{N} TLVs already exist, this returns without writing anything.
 +
 
 +
TransferMemoryEnabled: sdknso only exposes this for the Web applet. The sdknso func uses <code>nn::os::QueryMemoryInfo</code> at the start of the func, however the output is unused. The applet doesn't seem to parse this TLV.
 +
 
 +
==== Output TLVs ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  System Version
 +
!  Applets
 +
!  Type
 +
!  Size
 +
!  Value
 +
!  Description
 +
|-
 +
| [3.0.0+]
 +
| Share, Web
 +
| 0x1
 +
| 0x4
 +
| u32
 +
| ShareExitReason
 +
|-
 +
| [3.0.0+]
 +
| Share, Web
 +
| 0x2
 +
|
 +
| string
 +
| LastUrl
 +
|-
 +
| [3.0.0+]
 +
| Share, Web
 +
| 0x3
 +
| 0x8
 +
| u64
 +
| LastUrlSize
 +
|-
 +
| [3.0.0+]
 +
| Share
 +
| 0x4
 +
| 0x4
 +
| u32
 +
| SharePostResult
 +
|-
 +
| [3.0.0+]
 +
| Share
 +
| 0x5
 +
|
 +
| string
 +
| PostServiceName
 +
|-
 +
| [3.0.0+]
 +
| Share
 +
| 0x6
 +
| 0x8
 +
| u64
 +
| PostServiceNameSize
 +
|-
 +
| [3.0.0+]
 +
| Share
 +
| 0x7
 +
|
 +
| string
 +
| PostId
 +
|-
 +
| [3.0.0+]
 +
| Share
 +
| 0x8
 +
| 0x8
 +
| u64
 +
| PostIdSize
 +
|-
 +
| [8.0.0+]
 +
| Web
 +
| 0x9
 +
| 0x1
 +
| u8 bool
 +
| MediaPlayerAutoClosedByCompletion
 +
|}
 +
 
 +
These are used for Share-applet on [3.0.0+], and with Web on [8.0.0+]. Official user-processes doesn't check the TLV size for any of these.
 +
 
 +
==== DocumentKind ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Value
 +
!  Name
 +
!  Description
 +
|-
 +
| 0x1
 +
| DocumentKind_OfflineHtmlPage
 +
| Use the HtmlDocument NCA content from the application.
 +
|-
 +
| 0x2
 +
| DocumentKind_ApplicationLegalInformation
 +
| Use the LegalInformation NCA content from the application.
 +
|-
 +
| 0x3
 +
| DocumentKind_SystemDataPage
 +
| Use the Data NCA content from the specified title, see also: [[Title_list#System_Data_Archives]]
 +
|}
 +
 
 +
This controls the kind of content to mount with Offline-applet.
 +
 
 +
==== ShareStartPage ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Value
 +
!  Name
 +
!  URL
 +
|-
 +
| 0
 +
| ShareStartPage_Default
 +
| [[Network|"https://web-%.share.srv.nintendo.net/"]]
 +
|-
 +
| 1
 +
| ShareStartPage_Settings
 +
| [[Network|"https://web-%.share.srv.nintendo.net/settings/"]]
 +
|}
 +
 
 +
This enum controls the initial page for ShareApplet.
 +
 
 +
==== BootDisplayKind ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Value
 +
!  Name
 +
!  Description
 +
|-
 +
| 0
 +
| BootDisplayKind_White
 +
| Default white background.
 +
|-
 +
| 1
 +
|
 +
| Unknown. Used by Offline default Arg initialization for DocumentKind_ApplicationLegalInformation/DocumentKind_SystemDataPage.
 +
|-
 +
| 2
 +
| BootDisplayKind_Black
 +
| Black background.
 +
|-
 +
| 3
 +
|
 +
| Unknown. Used by Share default Arg initialization.
 +
|-
 +
| 4
 +
|
 +
| Unknown. Used by Lobby default default Arg initialization.
 +
|}
 +
 
 +
Kind values for BootDisplayKind. Controls the background color while displaying the loading screen during applet boot. Also controls the BackgroundKind when value is non-zero.
 +
 
 +
The applet converts this to internal values.
 +
* BootDisplayKind 0:
 +
** If launched by an Application:
 +
*** If [[#BackgroundKind]] is 2..1, return 3..2. When 0, run the below, otherwise assert.
 +
** return TLV value from BootAsMediaPlayer
 +
* BootDisplayKind 1..4: return 0..3.
 +
 
 +
==== BackgroundKind ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Value
 +
!  Name
 +
!  Description
 +
|-
 +
| 0
 +
|
 +
| Unknown. Used by Offline default Arg initialization for DocumentKind_ApplicationLegalInformation/DocumentKind_SystemDataPage.
 +
|-
 +
| 1
 +
|
 +
| Same as [[#BootDisplayKind]] value 3.
 +
|-
 +
| 2
 +
|
 +
| Same as [[#BootDisplayKind]] value 4. Used by Lobby default Arg initialization.
 +
|}
 +
 
 +
Kind values for BackgroundKind. Only used when [[#BootDisplayKind]] is 0.
 +
 
 +
==== LeftStickMode ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Value
 +
!  Name
 +
!  Description
 +
|-
 +
| 0
 +
| LeftStickMode_Pointer
 +
| The user can directly control the pointer via the left-stick.
 +
|-
 +
| 1
 +
| LeftStickMode_Cursor
 +
| The user can only select elements on the page via the left-stick.
 +
|}
 +
 
 +
Controls the initial mode, this can be toggled by the user via the pressing the left-stick button. If the Pointer flag is set to false, only LeftStickMode_Cursor will be used and mode toggle by the user is disabled (input value ignored).
 +
 
 +
==== FooterButtonId ====
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Value
 +
!  Name
 +
!  Description
 +
|-
 +
| 0
 +
| None
 +
| None, for empty [[#WebBootFooterButtonEntry]]. Invalid for use as an input Id.
 +
|-
 +
| 1
 +
|
 +
|
 +
|-
 +
| 2
 +
|
 +
|
 +
|-
 +
| 3
 +
|
 +
|
 +
|-
 +
| 4
 +
|
 +
|
 +
|-
 +
| 5
 +
|
 +
|
 +
|-
 +
| 6
 +
|
 +
|
 +
|-
 +
| 7
 +
|
 +
| Values starting with this are invalid.
 +
|-
 +
|}
 +
 
 +
==== WebSessionBootMode ====
 +
This is "nn::web::WebSessionBootMode".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Value
 +
!  Name
 +
!  Description
 +
|-
 +
| 0
 +
|
 +
| Normal/default (AllForeground)
 +
|-
 +
| 1
 +
|
 +
| AllForegroundInitiallyHidden
 +
|}
 +
 
 +
This controls which [[Applet_Manager_services|LibraryAppletMode]] the applet will be launched with, by the user-process. The TLV for this seems to be ignored by the applet.
 +
 
 +
==== LastUrl ====
 +
When the applet loads a page where the beginning of the URL matches the URL from CallbackUrl, the applet will exit and set LastUrl to that URL (exit doesn't occur when CallbackableUrl is set). With Offline-applet for CallbackUrl handling, it compares the domain with "localhost" instead of using the CallbackUrl TLV.
    
== Versions ==
 
== Versions ==
Line 262: Line 1,278:     
See [[3.0.1|here]] regarding "shareddata:/" buildinfo.
 
See [[3.0.1|here]] regarding "shareddata:/" buildinfo.
 +
 +
=== [[5.0.0]] ===
 +
Support for YouTubeVideo was added, and new [[#TLVs]] etc.
 +
 +
In RomFS "/whitelist/WhitelistYouTubePlayer.txt" was added for the YouTubeVideo whitelist, which contains the following: <nowiki>"^https://www\.youtube\.com/embed/"</nowiki>. This file has the same content on 7.0.x.
 +
 +
[[Category:Library Applets]]
Retrieved from "https://switchbrew.org/wiki/Special:MobileDiff/3326...11591"