This topic describes the standard application screen resolutions, and how to implement your application to fit Samsung device screens.
Screen API
SystemInfo API
AVPlay API
The standard application screen resolution depends on the Samsung device model group.
When the application screen resolution is larger than the standard resolution, it is automatically resized to fit the screen. For example, an application that is created for a 1920x1080 px screen fills a Samsung UHD screen, and is resized to fit the smaller Samsung FHD screen.
Note To have high-quality graphics on all device screen sizes, always design your application for a 1920x1080 px screen.
To have high-quality graphics on all device screen sizes, always design your application for a 1920x1080 px screen.
If the aspect ratio of the application is not 16:9, the application screen is scaled by reducing the horizontal dimension to 1920 px. This can cause whitespace or scroll bars to appear around your application.
Note To be published on Samsung devices, your application screen resolution must have a 16:9 aspect ratio.
To be published on Samsung devices, your application screen resolution must have a 16:9 aspect ratio.
If your application does not follow the standard resolutions, you must define a viewport resolution to fit the application to a device screen. Define the viewport resolution using the meta viewport element in the "index.html" file header.
viewport
For example, if your application resolution is 1600x900 px, set the viewport width to 1600 px. This makes the device treat its screen width as 1600 px.
<meta name='viewport' content='width=1600, user-scalable=no'>
Note Modifying the viewport width can cause graphics to become distorted, and it is not guaranteed that your application layout displays properly.
Modifying the viewport width can cause graphics to become distorted, and it is not guaranteed that your application layout displays properly.
You can retrieve the screen resolution of a Samsung device in 2 ways:
Using the Web standard Screen API:
console.log(screen.height); console.log(screen.width);
Using the Tizen SystemInfo API:
tizen.systeminfo.getPropertyValue('DISPLAY', function(result) { console.log(result.resolutionWidth); console.log(result.resolutionHeight); });
Note The standard application resolution depends on the Samsung device model group, but multimedia elements always have the 1920x1080 px resolution, as defined by the AVPlay API. When you scale the application screen size up or down, multimedia elements are not scaled because they use an independent coordinate system within their HTML element. Use the same absolute coordinates for all Samsung device applications.
The standard application resolution depends on the Samsung device model group, but multimedia elements always have the 1920x1080 px resolution, as defined by the AVPlay API.
When you scale the application screen size up or down, multimedia elements are not scaled because they use an independent coordinate system within their HTML element. Use the same absolute coordinates for all Samsung device applications.