Internet Browser
Internet Browser is a web browser preloaded on the Wii U. It is based on NetFront Browser NX v2.1, which uses the WebKit rendering engine.
Known User Agent Strings
| Region | Release Date | UA String |
|---|---|---|
| US | Nov 18, 2012 | Mozilla/5.0 (Nintendo WiiU) AppleWebKit/534.52 (KHTML, like Gecko) NX/2.1.0.8.21 NintendoBrowser/1.0.0.7494.US |
| EU | Nov 30, 2012 | TODO |
| AU | Nov 30, 2012 | TODO |
| JP | Dec 8, 2012 | TODO |
Multimedia Support
Internet Browser supports HTML5 audio and video. The only video format supported is H.264 either in an MPEG-4 container or in an MPEG-2 transport stream with a M3U8 index according to the HTTP Live Streaming specification. The only audio format supported is AAC in an MPEG-4 container.
The browser can display BMP, PNG, GIF, JPEG, and SVG images, but Image Preview mode only supports JPEG images.
Other HTML5 features supported include canvas, web storage, web messaging, server-sent events, device orientation, and WOFF.
External plugins, such as Flash and Java, are not supported.
Controls
Under normal circumstances, Internet Browser uses the following controls:
| Left Stick | Scroll/Pan |
| Click Left Stick | Hide/show bottom toolbar |
| Right Stick | Zoom |
| Click Right Stick | Toggle zoom in/out on center of screen |
| + button | Zoom in |
| - button | Zoom out |
| L button | Back to previous page |
| R button | Forward to next page |
| ZL button | Switch to previous tab |
| ZR button | Switch to next tab |
| Hold ZL+ZR | Tilt scrolling |
| D-pad | Select links / form fields |
| A button | Send the "Enter" key (keyCode 13) |
| B button | Back to previous page |
| Hold B button | Close current tab |
| Y button | View bookmarks |
| X button | Toggle curtain mode |
| Home button | Quit browser |
| Tap screen | Click page elements |
| Double-tap screen | Zoom in/out on point |
| Touch drag | Scroll/Pan |
Some of these functions can be disabled by markup on a web page.
Wii U Scripting Functionality
In addition to W3C standard touch screen functionality, Internet Browser exposes many Wii U input and output functions to Javascript through the wiiu object.
wiiu.gamepad
The wiiu.gamepad object allows Javascript functions to read the current state of the primary GamePad.
Reading values
In order to read any values from the Wii Remote, input must first be enabled by setting wiiu.remote.isEnabled = 1.
Once enabled, the function wiiu.gamepad.update() will populate all of the properties on the wiiu.gamepad object with the current information about the sticks, accelerometers, gyroscopes, buttons, and touch screen. It is safe to invoke this function in a timer for real-time updates.
After a successful update, wiiu.gamepad.isDataValid will be set to 1. If no update has happened yet, or if the GamePad is not connected, it will be set to 0.
Touch Screen
The wiiu.gamepad.tpTouch variable indicates whether or not there is currently an active touch on the screen. If this variable is 1, the following variables will be set:
| Variable | Value |
|---|---|
| wiiu.gamepad.tpX | X position in screen coordinates |
| wiiu.gamepad.tpY | Y position in screen coordinates |
| wiiu.gamepad.contentX | X position in page coordinates |
| wiiu.gamepad.contentX | Y position in page coordinates |
TODO: Determine meaning of tpValidity. It has a value of 3 when there is no touch and a value of 0 when there is a touch.
Analog Sticks
The following variables store the current state of the left and right analog sticks. Each value ranges from -1.0 to +1.0.
| Variable | Value |
|---|---|
| wiiu.gamepad.lStickX | Left stick X deflection |
| wiiu.gamepad.lStickY | Left stick Y deflection |
| wiiu.gamepad.rStickX | Right stick X deflection |
| wiiu.gamepad.rStickY | Right stick Y deflection |
Buttons
The variable wiiu.gamepad.hold is a bitmask indicating all buttons currently being depressed on the GamePad, including the click states of the analog sticks. Almost all buttons are represented by in this bitmask although the browser's default behaviors may cause some values to be unusable.
| Button | Decimal | Hex |
|---|---|---|
| Left Stick Left | 1073741824 | 0x40000000 |
| Left Stick Right | 536870912 | 0x20000000 |
| Left Stick Up | 268435456 | 0x10000000 |
| Left Stick Down | 134217728 | 0x08000000 |
| Right Stick Left | 67108864 | 0x04000000 |
| Right Stick Right | 33554432 | 0x02000000 |
| Right Stick Up | 16777216 | 0x01000000 |
| Right Stick Down | 8388608 | 0x00800000 |
| Left Stick Click | 262144 | 0x00040000 |
| Right Stick Click | 131072 | 0x00020000 |
| TV | 65536 | 0x00010000 |
| A | 32768 | 0x00008000 |
| B | 16384 | 0x00004000 |
| X | 8192 | 0x00002000 |
| Y | 4096 | 0x00001000 |
| D-Pad Left | 2048 | 0x00000800 |
| D-Pad Right | 1024 | 0x00000400 |
| D-Pad Up | 512 | 0x00000200 |
| D-Pad Down | 256 | 0x00000100 |
| LR | 128 | 0x00000080 |
| ZR | 64 | 0x00000040 |
| L | 32 | 0x00000020 |
| R | 16 | 0x00000010 |
| + | 8 | 0x00000008 |
| - | 4 | 0x00000004 |
The Power button does not appear in the hold variable in the browser. Presumably the Home button would be 0x01 or 0x02 but this cannot be tested as pressing the Home button closes the browser without updating the screen.
Accelerometer
The variables wiiu.gamepad.accX, wiiu.gamepad.accY, and wiiu.gamepad.accZ are a vector showing the current acceleration forces on the GamePad, measured in Gs. When held level and motionless, the force of gravity will cause these variables to contain the vector (0.0, -1.0, 0.0).
Gyroscope
The variables wiiu.gamepad.gyroX, wiiu.gamepad.gyroY, and wiiu.gamepad.gyroZ contain the current readings of the GamePad gyroscopes.
TODO: Determine range and geometric interpretation of these variables.
Angle
The variables wiiu.gamepad.angleX, wiiu.gamepad.angleY, and wiiu.gamepad.angleZ contain the current angle of the GamePad.
TODO: Determine range and geometric interpretation of these variables.
Direction Tracking
There are nine variables that tie into the GamePad's direction tracking, organized into three triplets:
- wiiu.gamepad.dirXx, wiiu.gamepad.dirXy, wiiu.gamepad.dirXz
- wiiu.gamepad.dirYx, wiiu.gamepad.dirYy, wiiu.gamepad.dirYz
- wiiu.gamepad.dirZx, wiiu.gamepad.dirZy, wiiu.gamepad.dirZz
TODO: Determine range and geometric interpretation of these variables. They appear to be rotation-related. Are these triplets transposed? (i.e. are they associated as (dirXx, dirYx, dirZx) instead of (dirXx, dirXy, dirXz)?)
wiiu.remote
The wiiu.remote object allows Javascript functions to read the current state of the primary Wii Remote and its Motion Plus accessory.
TODO: Determine if it's possible to read the accessories and the second through fourth Wii Remotes like the Wii's Internet Channel could.
TODO: Figure out what contentX, contentY, and isDataValid are.
Reading values
In order to read any values from the Wii Remote, input must first be enabled by setting wiiu.remote.isEnabled = 1.
Once enabled, the function wiiu.remote.update() will populate all of the properties on the wiiu.remote object with the current information (about what?). It is safe to invoke this function in a timer for real-time updates.
Buttons
The variable wiiu.remote.held is a bitmask indicating all buttons currently being depressed on the Wii Remote.
TODO: Record what values in the bitmask correspond to which buttons on the GamePad.
Accelerometer
The variables wiiu.remote.accX, wiiu.remote.accY, and wiiu.remote.accZ are a vector showing the current acceleration forces on the Wii Remote, measured in Gs. When held level and motionless, the force of gravity will cause these variables to contain the vector (0.0, -1.0, 0.0).
D-Pad
TODO: Document.
Motion Plus
TODO: Document.
wiiu.videoplayer
The wiiu.videoplayer object exposes the property viewMode and the function end().
TODO: Figure out what this is and how to use it.
wiiu.imageview
The wiiu.videoplayer object exposes the property viewMode and the functions end() and getErrorCode().
TODO: Figure out what this is and how to use it.