System Information
Tizen enables you to access the device's system properties (both hardware and capability). You can obtain various device and system details, such as the current battery level, amount of available storage, and state of the cellular network connection.
The System Information API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices. All mandatory APIs are supported on the Tizen Emulators.
The main features of the System Information API include:
- Total memory check
You can get the total amount of system memory using the getTotalMemory() method of the SystemInfo interface (in mobile and wearable applications).
- Available memory check
You can get the available amount of system memory using the getAvailableMemory() method of the SystemInfo interface.
- Property count check
You can get the number of system property information using the getCount() method of the SystemInfo interface.
- Device capability retrieval
You can get a device capability using the getCapability() method of the SystemInfo interface.
- Property state checks
You can retrieve the current state of a specific device property by using the getPropertyValue() method.
The property state can determine whether your application has enough resources to complete a particular task or service successfully. For example, if you are creating a file, you need to check the storage property to know whether a writable storage is available on the device.
For example, you can check the device orientation. The device orientation defines the angle between the direction of what is considered to be the "top" side of the device and the physical upward direction. The device orientation is not directly related to the screen orientation. For example, when the Auto rotate screen option is disabled or the Web application has the screen-orientation option set to "landscape" or "portrait", the screen is not rotated and the window.screen.orientation property does not change; however, the SystemInfo device orientation changes.
When a device is in its natural position, it is considered to be in the PORTRAIT_PRIMARY orientation (in mobile and wearable applications) (if the screen height is greater than its width) or the LANDSCAPE_PRIMARY orientation (otherwise). When the device is rotated 90 degrees clockwise (rotated right), the orientation changes from LANDSCAPE_PRIMARY to PORTRAIT_PRIMARY, from PORTRAIT_PRIMARY to LANDSCAPE_SECONDARY, from LANDSCAPE_SECONDARY to PORTRAIT_SECONDARY, and from PORTRAIT_SECONDARY back to LANDSCAPE_PRIMARY.
Table: Device orientations LANDSCAPE_PRIMARY PORTRAIT_PRIMARY LANDSCAPE_SECONDARY PORTRAIT_SECONDARY 
- Property state updates
You can receive state updates when a change occurs in a specific property.
The addPropertyValueChangeListener() method registers an event listener for a specific property, and returns the subscription identifier for the listener. You can use the SystemInfoPropertySuccessCallback interface (in mobile and wearable applications) to define the event handler for receiving the change notification.
The system properties are defines as subtypes of the SystemInfoProperty interface (in mobile and wearable applications). The following table lists the available subtypes, and the related SystemInfoPropertyId type (in mobile and wearable applications) values.
| Property | PropertyID | Description | ||
|---|---|---|---|---|
| SystemInfoBattery (in mobile and wearable applications) | BATTERY | Provides information about the battery level and charging status. With this property, you can, for example, determine whether the application can be launched or whether the user needs to be warned about the level of power available for the device. | ||
| SystemInfoCpu (in mobile and wearable applications) | CPU | Provides information about the CPU load, allowing you to determine the efficiency of an application. | ||
| SystemInfoStorage (in mobile and wearable applications) | STORAGE | Provides information about the currently connected data storage devices and their details, such as available capacity. With this property, you can, for example, allow the user to select which available storage they want to use, and determine whether the storage in question has enough free space for the actions the user wants to perform. | ||
| SystemInfoDisplay (in mobile and wearable applications) | DISPLAY | Provides information about the device display, allowing you, for example, to determine the resolution of the device to layout your application optimally on runtime. | ||
| SystemInfoNetwork (in mobile and wearable applications) | NETWORK | Provides information about the data network. With this property, you can, for example, determine whether the network type provides adequate connection speeds for the actions the user wants to perform. | ||
| SystemInfoWifiNetwork (in mobile and wearable applications) | WIFI_NETWORK | Provides information about the Wi-Fi network. With this property, you can, for example, determine whether a Wi-Fi network is available and what its signal strength or SSID is.
|
||
| SystemInfoCellularNetwork (in mobile and wearable applications) | CELLULAR_NETWORK | Provides information about the cellular network. With this property, you can, for example, retrieve the network details that allow your application to access the network. | ||
| SystemInfoSIM (in mobile and wearable applications) | SIM | Provides information about the device SIM card, such as the operator name and the mobile country code (MCC). | ||
| SystemInfoDeviceOrientation (in mobile and wearable applications) | DEVICE_ORIENTATION | Provides information about the current device display orientation allowing you, for example, to determine when the orientation changes to layout your application optimally on runtime. | ||
| SystemInfoBuild (in mobile and wearable applications) | BUILD | Provides information about the build, such as the model name and manufacturer. | ||
| SystemInfoLocale (in mobile and wearable applications) | LOCALE | Provides information about the locale, such as the currently set language. | ||
| SystemInfoPeripheral (in mobile and wearable applications) | PERIPHERAL | Provides information about the video output status. | ||
| SystemInfoMemory (in mobile and wearable applications) | MEMORY | Provides information about the memory state of the device. |
