SystemInfo API
This API also provides interfaces and methods that can retrieve statuses of hardware devices, get the value of selected properties, and subscribe to asynchronous notifications of changes for selected values.
Web applications can use this API to access the following system properties:
- ADS (Since: 3.0)
- BATTERY
- BUILD
- CAMERA_FLASH (Since: 2.4)
- CELLULAR_NETWORK
- CPU
- DEVICE_ORIENTATION
- DISPLAY
- ETHERNET_NETWORK (Since: 2.4)
- LOCALE (Since: 2.1)
- MEMORY (Since: 2.3)
- NET_PROXY_NETWORK (Since: 3.0)
- NETWORK
- PERIPHERAL (Since: 2.1)
- SIM
- STORAGE
- WIFI_NETWORK
Not all above properties may be available on every Tizen device. For instance, a device may not support the telephony feature. In that case, CELLULAR_NETWORK and SIM are not available.
To check the available SystemInfoPropertyId, getCapability() method can be used.
- BATTERY - tizen.systeminfo.getCapability("http://tizen.org/feature/battery")
- CAMERA_FLASH - tizen.systeminfo.getCapability("http://tizen.org/feature/camera.back.flash")
- CELLULAR_NETWORK - tizen.systeminfo.getCapability("http://tizen.org/feature/network.telephony")
- DISPLAY - tizen.systeminfo.getCapability("http://tizen.org/feature/screen")
- ETHERNET_NETWORK - tizen.systeminfo.getCapability("http://tizen.org/feature/network.ethernet")
- NET_PROXY_NETWORK - tizen.systeminfo.getCapability("http://tizen.org/feature/network.net_proxy")
- SIM - tizen.systeminfo.getCapability("http://tizen.org/feature/network.telephony")
- WIFI_NETWORK - tizen.systeminfo.getCapability("http://tizen.org/feature/network.wifi")
For more information on the System Information features, see System Information Guide.
Since: 1.0
Table of Contents
- 1. Type Definitions
- 1.1. SystemInfoPropertyId
- 1.2. SystemInfoNetworkType
- 1.3. SystemInfoDeviceOrientationStatus
- 1.4. SystemInfoSimState
- 1.5. SystemInfoProfile
- 1.6. SystemInfoLowMemoryStatus
- 2. Interfaces
- 2.1. SystemInfoObject
- 2.2. SystemInfo
- 2.3. SystemInfoDeviceCapability
- 2.4. SystemInfoOptions
- 2.5. SystemInfoPropertySuccessCallback
- 2.6. SystemInfoPropertyArraySuccessCallback
- 2.7. SystemInfoProperty
- 2.8. SystemInfoBattery
- 2.9. SystemInfoCpu
- 2.10. SystemInfoStorage
- 2.11. SystemInfoStorageUnit
- 2.12. SystemInfoDisplay
- 2.13. SystemInfoDeviceOrientation
- 2.14. SystemInfoBuild
- 2.15. SystemInfoLocale
- 2.16. SystemInfoNetwork
- 2.17. SystemInfoWifiNetwork
- 2.18. SystemInfoEthernetNetwork
- 2.19. SystemInfoCellularNetwork
- 2.20. SystemInfoNetProxyNetwork
- 2.21. SystemInfoSIM
- 2.22. SystemInfoPeripheral
- 2.23. SystemInfoMemory
- 2.24. SystemInfoCameraFlash
- 2.25. SystemInfoADS
- 3. Related Feature
- 4. Full WebIDL
Summary of Interfaces and Methods
1. Type Definitions
1.1. SystemInfoPropertyId
enum SystemInfoPropertyId { "BATTERY", "CPU", "STORAGE", "DISPLAY", "DEVICE_ORIENTATION", "BUILD", "LOCALE", "NETWORK", "WIFI_NETWORK", "ETHERNET_NETWORK", "CELLULAR_NETWORK", "NET_PROXY_NETWORK", "SIM", "PERIPHERAL", "MEMORY", "CAMERA_FLASH", "ADS" };
Since: 2.0
Remark: CAMERA_FLASH is supported since Tizen 2.4
Remark: ETHERNET_NETWORK is supported since Tizen 2.4
Remark: LOCALE and PERIPHERAL are supported since Tizen 2.1
Remark: MEMORY is supported since Tizen 2.3
Remark: NET_PROXY_NETWORK is supported since Tizen 3.0
Remark: ADS is supported since Tizen 3.0
1.2. SystemInfoNetworkType
enum SystemInfoNetworkType { "NONE", "2G", "2.5G", "3G", "4G", "WIFI", "ETHERNET", "NET_PROXY", "UNKNOWN" };
Since: 2.0
Remark: NET_PROXY is supported since Tizen 3.0
1.3. SystemInfoDeviceOrientationStatus
enum SystemInfoDeviceOrientationStatus { "PORTRAIT_PRIMARY", "PORTRAIT_SECONDARY", "LANDSCAPE_PRIMARY", "LANDSCAPE_SECONDARY" };
Since: 2.0
SystemInfo reports the orientation of the device depending on the type of the device and physical position of the device relative to vertical direction. A "phone type device" is a device for which the portrait position is the natural orientation. A "tab type device" is a device for which the landscape position is basic working orientation.
SystemInfoDeviceOrientationStatus | Phone type device | Tablet type device |
---|---|---|
PORTRAIT_PRIMARY | Natural position | Rotated 90 degrees right (clockwise) |
PORTRAIT_SECONDARY | Upside down, in other words rotated 180 degrees | Rotated 90 degrees left (anticlockwise) |
LANDSCAPE_PRIMARY | Rotated 90 degrees left (anticlockwise) | Natural position |
LANDSCAPE_SECONDARY | Rotated 90 degrees right (clockwise) | Upside down, in other words rotated 180 degrees |
1.4. SystemInfoSimState
enum SystemInfoSimState { "ABSENT", "INITIALIZING", "READY", "PIN_REQUIRED", "PUK_REQUIRED", "NETWORK_LOCKED", "SIM_LOCKED", "UNKNOWN" };
Since: 2.1
1.5. SystemInfoProfile
enum SystemInfoProfile { "MOBILE_FULL", "MOBILE_WEB", "MOBILE", "WEARABLE", "TV" };
Deprecated. MOBILE_FULL and MOBILE_WEB are deprecated since 2.3. Beginning with Tizen 2.3, MOBILE is returned instead.
Since: 2.2
Remark: MOBILE, WEARABLE and TV are supported since Tizen 2.3.
1.6. SystemInfoLowMemoryStatus
enum SystemInfoLowMemoryStatus { "NORMAL", "WARNING" };
Since: 2.3
- NORMAL - indicating the remaining memory is sufficient for an application to run
- WARNING - indicating the remaining memory is insufficient. Low memory warnings may happen differently according to the system
2. Interfaces
2.1. SystemInfoObject
[NoInterfaceObject] interface SystemInfoObject { readonly attribute SystemInfo systeminfo; };
Tizen implements SystemInfoObject;
Since: 1.0
There will be a tizen.systeminfo object that allows accessing the functionality of the System Information API.
Attributes
-
readonly
SystemInfo systeminfoObject representing a system info module.
Since: 1.0
2.2. SystemInfo
[NoInterfaceObject] interface SystemInfo { long long getTotalMemory() raises(WebAPIException); long long getAvailableMemory() raises(WebAPIException); SystemInfoDeviceCapability getCapabilities() raises(WebAPIException); any getCapability(DOMString key) raises(WebAPIException); long getCount(SystemInfoPropertyId property) raises(WebAPIException); void getPropertyValue(SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void getPropertyValueArray(SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); unsigned long addPropertyValueChangeListener(SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback) raises(WebAPIException); unsigned long addPropertyValueArrayChangeListener(SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback) raises(WebAPIException); void removePropertyValueChangeListener(unsigned long listenerId) raises(WebAPIException); };
Since: 1.0
This API offers methods for retrieving system information and for subscribing notifications of system information changes.
Methods
-
getTotalMemory
-
Gets the total amount of system memory (in bytes).
long long getTotalMemory();
Since: 2.3
Return value:
-
long long:
Total system memory.
Exceptions:
- WebAPIException
with error type UnknownError in any error case.
Code example:
/* To get total amount of system memory. */ console.log("The total memory size is " + tizen.systeminfo.getTotalMemory() + " bytes.");
- WebAPIException
-
getAvailableMemory
-
Gets the amount of memory that is not in use (in bytes).
long long getAvailableMemory();
Since: 2.3
Return value:
-
long long:
Not used memory in bytes.
Exceptions:
- WebAPIException
with error type UnknownError in any error case.
Code example:
/* To get total amount of system memory. */ console.log("The available memory size is " + tizen.systeminfo.getAvailableMemory() + " bytes.");
- WebAPIException
-
getCapabilities
-
Gets the capabilities of the device.
Deprecated. Deprecated since 2.3. Instead, use getCapability().
SystemInfoDeviceCapability getCapabilities();
Since: 2.0
The function must synchronously acquire the capabilities of the device.
Return value:
-
SystemInfoDeviceCapability:
Capabilities of the device.
Exceptions:
- WebAPIException
with error type UnknownError in any error case.
Code example:
var deviceCapabilities; deviceCapabilities = tizen.systeminfo.getCapabilities(); if (deviceCapabilities.bluetooth) { console.log("Bluetooth is supported"); }
- WebAPIException
-
getCapability
-
Gets a device capability related to a given key.
any getCapability(DOMString key);
Since: 2.3
See the available device capability keys. The additional keys for the custom device capability are specified by OEMs and vendors.
Parameters:
- key: The device capability key for the device or additional custom device capability key specified by OEM.
Return value:
-
any:
The value of the specified device capability.
Exceptions:
- WebAPIException
with error type UnknownError in any other error case.
Code example:
try { /* Checks if a device supports Bluetooth API. */ var bluetooth = tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth"); console.log(" Bluetooth = " + bluetooth); } catch (error) { console.log("Error name: " + error.name + ", message: " + error.message); }
-
getCount
-
Gets the number of system property information provided for a particular system property.
long getCount(SystemInfoPropertyId property);
Since: 2.3
That is the length of array retrieved by the getPropertyValueArray() method for the given property.
Parameters:
- property: The name of the system property.
Return value:
-
long:
The number of property values for the given property. If the property is not supported, 0 is returned.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
Code example:
var count = tizen.systeminfo.getCount("SIM"); if (count === 0) { console.log("There is no available SIM card."); } else { console.log("There is (are) " + count + " SIM card(s) available."); }
-
getPropertyValue
-
Gets the current value of a specified system property.
void getPropertyValue(SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
The function must asynchronously acquire the current value of the requested property. If it is successful, the successCallback must be invoked with an object containing the information provided by the property.
The ErrorCallback function can be launched with these error types:
- NotSupportedError - If the given property is not supported (since Tizen 2.3).
Remark: If the given property is not supported, NotSupportedError would be passed through a ErrorCallback() since Tizen 2.3.
Remark: If system provides more than one value for the system property, the primary (first) system property is returned through SystemInfoSuccessCallback.
Parameters:
-
property:
The name of the property to retrieve.
- Conditional privilege: For using CELLULAR_NETWORK value, privilege http://tizen.org/privilege/telephony (public level) is needed since Tizen 2.4.
- successCallback: Callback function called when the properties are successfully retrieved.
- errorCallback [optional] [nullable]: Callback function called when an error occurs while retrieving the properties.
Exceptions:
- WebAPIException
with error type SecurityError, this error is only thrown for CELLULAR_NETWORK property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.
with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
with error type UnknownError in any other error case.
Code example:
function onSuccessCallback(cpu) { console.log("The cpu load is " + cpu.load); } function onErrorCallback(error) { console.log("An error occurred " + error.message); } tizen.systeminfo.getPropertyValue("CPU", onSuccessCallback, onErrorCallback);
Code example:
function onSuccessCallback(cellular) { console.log("The status of the cellular network is " + cellular.status); } function onErrorCallback(error) { console.log("An error occurred " + error.message); /* If telephony_capability is false but getPropertyValue("CELLULAR_NETWORK, ...) is called, */ /* NotSupportedError is passed. */ } var telephony_capability = tizen.systeminfo.getCapability("http://tizen.org/feature/network.telephony"); if (telephony_capability === true) { /* onSuccessCallback will be invoked. */ tizen.systeminfo.getPropertyValue("CELLULAR_NETWORK", onSuccessCallback, onErrorCallback); } else { console.log( "Telephony feature is not supported. Cellular network related information cannot be retrieved."); }
-
getPropertyValueArray
-
Gets the current values of a specified system property.
void getPropertyValueArray(SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 2.3
It is recommended that you check if a device provides one or more than one value for a particular system property via getCount().
If one particular system property is provided on a device, it returns an array containing one SystemInfoProperty object through SystemInfoPropertyArraySuccessCallback method.
If more than one particular system property is provided, multiple SystemInfoProperty objects are returned.The ErrorCallback function can be launched with these error types:
- NotSupportedError - If the given property is not supported.
Remark: See getCount().
Parameters:
-
property:
The name of the property to retrieve.
- Conditional privilege: For using CELLULAR_NETWORK value, privilege http://tizen.org/privilege/telephony (public level) is needed since Tizen 2.4.
- successCallback: Callback function called when the properties are successfully retrieved.
- errorCallback [optional] [nullable]: Callback function called when an error occurs while retrieving the properties.
Exceptions:
- WebAPIException
with error type SecurityError, this error is only thrown for CELLULAR_NETWORK property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.
with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
Code example:
function successCB(property) { console.log("The SIM's current state is " + property.state); } function successArrayCB(properties) { console.log("The number of the returned system properties is " + properties.length); for (var i = 0; i < properties.length; i++) { console.log("[" + i + "] SIM's state is " + properties[i].state); } } var count = tizen.systeminfo.getCount("SIM"); if (count === 0) { console.log("This device does not provide SIM card."); } else if (count > 1) { tizen.systeminfo.getPropertyValueArray("SIM", successArrayCB); } else { tizen.systeminfo.getPropertyValue("SIM", successCB); }
-
addPropertyValueChangeListener
-
Adds a listener to allow tracking changes in one or more system properties.
unsigned long addPropertyValueChangeListener(SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback);
Since: 1.0
When called, it immediately returns and then asynchronously starts a watch process defined by the following steps:
1. Register the successCallback to receive system events that the status of the requested properties may have changed.
2. When a system event is successfully received, invoke the associated successCallback with an object containing the property values.
3. Repeat step 2 until removePropertyValueChangeListener function is called.
There are device properties which are never changed (e.g. "BUILD") and properties which are not changed on some devices (e.g. "DEVICE_ORIENTATION" in Tizen TV device). The addPropertyValueChangeListener() method accepts any identifier of these properties, but the listener added for them will not be invoked.
The errorCallback can be launched with any of these error types:
-
NotSupportedError - If the given property is not supported (since Tizen 2.3).
For example, monitoring CELLULAR_NETWORK changes is not supported on a device which does not support the telephony feature.
Remark: The errorCallback() is newly added as an optional parameter since Tizen 2.3.
Parameters:
-
property:
The name of the property to retrieve.
- Conditional privilege: For using CELLULAR_NETWORK value, privilege http://tizen.org/privilege/telephony (public level) is needed since Tizen 2.4.
- successCallback: Callback function called when the properties are successfully retrieved.
- options [optional] [nullable]: An object containing the various options for fetching the properties requested. See details.
- errorCallback [optional] [nullable]: Callback function called when an error occurs.
Return value:
-
unsigned long:
An identifier used to clear the watch subscription.
Exceptions:
- WebAPIException
with error type InvalidValuesError, if any of the input parameters contains an invalid value (e.g. the invalid value for options).
with error type SecurityError, this error is only thrown for CELLULAR_NETWORK property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.
with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
with error type UnknownError in any other error case.
Code example:
function onSuccessCallback(cpu) { console.log("The cpu load: " + cpu.load); } tizen.systeminfo.addPropertyValueChangeListener("CPU", onSuccessCallback, {lowThreshold: 0.2});
-
NotSupportedError - If the given property is not supported (since Tizen 2.3).
-
addPropertyValueArrayChangeListener
-
Adds a listener to allow tracking of changes in one or more values of a system property.
unsigned long addPropertyValueArrayChangeListener(SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback);
Since: 2.3
The ErrorCallback function can be launched with these error types:
-
NotSupportedError - If the given property is not supported (since Tizen 2.3).
For example, monitoring CELLULAR_NETWORK changes is not supported on a device which does not support the telephony feature.
There are device properties which never change (for example "BUILD") and properties which do not change on the current platform (for example "DEVICE_ORIENTATION" for some platforms). The addPropertyValueChangeListener() method accepts any identifier of these properties, but the listener added for them will not be invoked.
Parameters:
-
property:
The name of the property to retrieve.
- Conditional privilege: For using CELLULAR_NETWORK value, privilege http://tizen.org/privilege/telephony (public level) is needed since Tizen 2.4.
- successCallback: Callback function called when the properties are successfully retrieved.
- options [optional] [nullable]: An object containing the various options for fetching the properties requested.
- errorCallback [optional] [nullable]: Callback function called when an error occurs.
Return value:
-
unsigned long:
An identifier used to clear the watch subscription.
Exceptions:
- WebAPIException
with error type InvalidValuesError, if any of the input parameters contains an invalid value (e.g. the invalid value for options).
with error type SecurityError, this error is only thrown for CELLULAR_NETWORK property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.
with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
with error type UnknownError in any other error case.
-
NotSupportedError - If the given property is not supported (since Tizen 2.3).
-
removePropertyValueChangeListener
-
Unsubscribes notifications for property changes.
void removePropertyValueChangeListener(unsigned long listenerId);
Since: 1.0
If a valid listenerId argument is passed that corresponds to an existing subscription, then the watch process must immediately terminate and no further callback is invoked.
Parameters:
- listenerId: An identifier of the subscription returned by the addPropertyValueChangeListener() or addPropertyValueArrayChangeListener() method.
Exceptions:
- WebAPIException
with error type InvalidValuesError, if any of the input parameters contains an invalid value.
with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
with error type UnknownError in any other error case.
Code example:
var id = null; function onSuccessCallback(cpu) { console.log("New value for CPU load is " + cpu.load); if (id != null) { /* After receiving the first notification, clear it. */ tizen.systeminfo.removePropertyValueChangeListener(id); } } id = tizen.systeminfo.addPropertyValueChangeListener("CPU", onSuccessCallback);
2.3. SystemInfoDeviceCapability
Deprecated. Deprecated since 2.3. Instead, use getCapability() to query device capabilities.
[NoInterfaceObject] interface SystemInfoDeviceCapability {
readonly attribute boolean bluetooth;
readonly attribute boolean nfc;
readonly attribute boolean nfcReservedPush;
readonly attribute unsigned short multiTouchCount;
readonly attribute boolean inputKeyboard;
readonly attribute boolean inputKeyboardLayout;
readonly attribute boolean wifi;
readonly attribute boolean wifiDirect;
readonly attribute boolean opengles;
readonly attribute DOMString openglestextureFormat;
readonly attribute boolean openglesVersion1_1;
readonly attribute boolean openglesVersion2_0;
readonly attribute boolean fmRadio;
readonly attribute DOMString platformVersion raises(WebAPIException);
readonly attribute DOMString webApiVersion raises(WebAPIException);
readonly attribute DOMString nativeApiVersion raises(WebAPIException);
readonly attribute DOMString platformName;
readonly attribute boolean camera;
readonly attribute boolean cameraFront;
readonly attribute boolean cameraFrontFlash;
readonly attribute boolean cameraBack;
readonly attribute boolean cameraBackFlash;
readonly attribute boolean location;
readonly attribute boolean locationGps;
readonly attribute boolean locationWps;
readonly attribute boolean microphone;
readonly attribute boolean usbHost;
readonly attribute boolean usbAccessory;
readonly attribute boolean screenOutputRca;
readonly attribute boolean screenOutputHdmi;
readonly attribute DOMString platformCoreCpuArch;
readonly attribute DOMString platformCoreFpuArch;
readonly attribute boolean sipVoip;
readonly attribute DOMString duid;
readonly attribute boolean speechRecognition;
readonly attribute boolean speechSynthesis;
readonly attribute boolean accelerometer;
readonly attribute boolean accelerometerWakeup;
readonly attribute boolean barometer;
readonly attribute boolean barometerWakeup;
readonly attribute boolean gyroscope;
readonly attribute boolean gyroscopeWakeup;
readonly attribute boolean magnetometer;
readonly attribute boolean magnetometerWakeup;
readonly attribute boolean photometer;
readonly attribute boolean photometerWakeup;
readonly attribute boolean proximity;
readonly attribute boolean proximityWakeup;
readonly attribute boolean tiltmeter;
readonly attribute boolean tiltmeterWakeup;
readonly attribute boolean dataEncryption;
readonly attribute boolean graphicsAcceleration;
readonly attribute boolean push;
readonly attribute boolean telephony;
readonly attribute boolean telephonyMms;
readonly attribute boolean telephonySms;
readonly attribute boolean screenSizeNormal;
readonly attribute boolean screenSize480_800;
readonly attribute boolean screenSize720_1280;
readonly attribute boolean autoRotation;
readonly attribute boolean shellAppWidget;
readonly attribute boolean visionImageRecognition;
readonly attribute boolean visionQrcodeGeneration;
readonly attribute boolean visionQrcodeRecognition;
readonly attribute boolean visionFaceRecognition;
readonly attribute boolean secureElement;
readonly attribute boolean nativeOspCompatible;
readonly attribute SystemInfoProfile profile;
};
Since: 2.0
Attributes
-
readonly
boolean bluetoothIndicates whether the device supports Bluetooth.
Since: 2.0
-
readonly
boolean nfcIndicates whether the device supports NFC.
Since: 2.0
-
readonly
boolean nfcReservedPushIndicates whether the device supports NFC reserved push.
Since: 2.1
-
readonly
unsigned short multiTouchCountThe number of point in Multi-point touch.
Since: 2.0
-
readonly
boolean inputKeyboardIndicates whether the device supports the built-in keyboard.
Since: 2.0
-
readonly
boolean inputKeyboardLayoutIndicates whether the device supports the built-in keyboard layout.
Since: 2.1
-
readonly
boolean wifiIndicates whether the device supports Wi-Fi.
Since: 2.0
-
readonly
boolean wifiDirectIndicates whether the device supports Wi-Fi Direct.
Since: 2.0
-
readonly
boolean openglesIndicates whether the device supports OpenGL-ES.
Since: 2.1
-
readonly
DOMString openglestextureFormatThe device 3DC texture format for OpenGL-ES.
One example of possible output is as follows: "3dc/atc/etc/ptc/pvrtc/utc"
Since: 2.1
-
readonly
boolean openglesVersion1_1Indicates whether the device supports OpenGL-ES version 1.1.
Since: 2.0
-
readonly
boolean openglesVersion2_0Indicates whether the device supports OpenGL-ES version 2.0.
Since: 2.0
-
readonly
boolean fmRadioIndicates whether the device supports FM radio.
Since: 2.0
-
readonly
DOMString platformVersionThe version of the platform in the [Major].[Minor].[Patch Version] format.
For example, 1.0.0 represents a platform version where the major version is 1 and the minor and build versions are 0. [Patch Version] is optional. The Tizen platform strictly follows this versioning system and this format must be preserved. Manufacturers may add more parts (dot followed by number or text) after the preserved format. If a version is not versioned as [Major].[Minor].[Patch Version], the unused digits must be taken as 0. So for example, version 2.3 is 2.3.0 and manufacturers must add parts after 2.3.0 such as 2.3.0.1.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
DOMString webApiVersionThe version of the Web API in the [Major].[Minor].[Patch Version] format.
For example, 1.0.0 represents a Web API version where the major version is 1 and the minor and build versions are 0. [Patch Version] is optional. The Tizen platform strictly follows this versioning system and this format must be preserved. Manufacturers may add more parts (dot followed by number or text) after the preserved format. If a version is not versioned as [Major].[Minor].[Patch Version], the unused digits must be taken as 0. So for example, version 2.3 is 2.3.0 and manufacturers must add parts after 2.3.0 such as 2.3.0.1.
Since: 2.1
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
DOMString nativeApiVersionThe version of the Native API in the [Major].[Minor].[Patch Version] format.
For example, 1.0.0 represents a Native API version where the major version is 1 and the minor and build versions are 0. [Patch Version] is optional. The Tizen platform strictly follows this versioning system and this format must be preserved. Manufacturers may add more parts (dot followed by number or text) after the preserved format. If a version is not versioned as [Major].[Minor].[Patch Version], the unused digits must be taken as 0. So for example, version 2.3 is 2.3.0 and manufacturers must add parts after 2.3.0 such as 2.3.0.1.
Since: 2.1
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
DOMString platformNameThe name of the platform.
Since: 2.0
-
readonly
boolean cameraIndicates whether the device supports camera.
Since: 2.1
-
readonly
boolean cameraFrontIndicates whether the device supports front camera.
Since: 2.0
-
readonly
boolean cameraFrontFlashIndicates whether the device supports flash on the front camera.
Since: 2.0
-
readonly
boolean cameraBackIndicates whether the device supports back-side camera.
Since: 2.0
-
readonly
boolean cameraBackFlashIndicates whether the device supports flash on the back-side camera.
Since: 2.0
-
readonly
boolean locationIndicates whether the device supports GPS or not.
Since: 2.0
-
readonly
boolean locationGpsIndicates whether the device supports GPS based location feature.
Since: 2.0
-
readonly
boolean locationWpsIndicates whether the device supports WPS based location feature.
Since: 2.0
-
readonly
boolean microphoneIndicates whether the device supports microphone.
Since: 2.0
-
readonly
boolean usbHostIndicates whether the device supports USB host.
Since: 2.0
-
readonly
boolean usbAccessoryIndicates whether the device supports USB accessory.
Since: 2.0
-
readonly
boolean screenOutputRcaIndicates whether the device supports RCA output.
Since: 2.0
-
readonly
boolean screenOutputHdmiIndicates whether the device supports HDMI output.
Since: 2.0
-
readonly
DOMString platformCoreCpuArchThe device CPU architecture.
The possible values for this attribute are: armv6, armv7, x86.
Since: 2.0
-
readonly
DOMString platformCoreFpuArchThe device FPU architecture.
The possible values for this attribute are: vfpv3, sse2, sse3 and ssse3.
Since: 2.0
-
readonly
boolean sipVoipIndicates whether the device supports VOIP.
Since: 2.0
-
readonly
DOMString duidIndicates the Tizen ID, not device's unique ID since Tizen 2.3.
Since: 2.0
Remark: Tizen ID is a randomly generated value based on the model name.
It is recommended to use tizen.systeminfo.getCapability("http://tizen.org/system/tizenid") since Tizen 2.3 instead. -
readonly
boolean speechRecognitionIndicates whether the device supports speech recognition.
Since: 2.0
-
readonly
boolean speechSynthesisIndicates whether the device supports speech synthesis.
Since: 2.1
-
readonly
boolean accelerometerIndicates whether the device supports accelerometer.
Since: 2.0
-
readonly
boolean accelerometerWakeupIndicates whether the device supports accelerometer wake-up feature.
Since: 2.1
-
readonly
boolean barometerIndicates whether the device supports barometer.
Since: 2.0
-
readonly
boolean barometerWakeupIndicates whether the device supports barometer wake-up feature.
Since: 2.1
-
readonly
boolean gyroscopeIndicates whether the device supports gyroscope.
Since: 2.0
-
readonly
boolean gyroscopeWakeupIndicates whether the device supports gyroscope wake-up feature.
Since: 2.1
-
readonly
boolean magnetometerIndicates whether the device supports magnetometer.
Since: 2.0
-
readonly
boolean magnetometerWakeupIndicates whether the device supports magnetometer wake-up feature.
Since: 2.1
-
readonly
boolean photometerIndicates whether the device supports photometer.
Since: 2.1
-
readonly
boolean photometerWakeupIndicates whether the device supports photometer wake-up feature.
Since: 2.1
-
readonly
boolean proximityIndicates whether the device supports proximity.
Since: 2.0
-
readonly
boolean proximityWakeupIndicates whether the device supports proximity wake-up feature.
Since: 2.1
-
readonly
boolean tiltmeterIndicates whether the device supports tiltmeter.
Since: 2.1
-
readonly
boolean tiltmeterWakeupIndicates whether the device supports tiltmeter wake-up feature.
Since: 2.1
-
readonly
boolean dataEncryptionIndicates whether the device supports data encryption.
Since: 2.1
-
readonly
boolean graphicsAccelerationIndicates whether the device supports hardware acceleration for 2D/3D graphics.
Since: 2.1
-
readonly
boolean pushIndicates whether the device supports push service.
Since: 2.1
-
readonly
boolean telephonyIndicates whether the device supports the telephony feature.
Since: 2.1
-
readonly
boolean telephonyMmsIndicates whether the device supports the MMS feature.
Since: 2.1
-
readonly
boolean telephonySmsIndicates whether the device supports the SMS feature.
Since: 2.1
-
readonly
boolean screenSizeNormalIndicates whether the device supports the screen normal size.
Since: 2.1
-
readonly
boolean screenSize480_800Indicates whether the device supports the 480 * 800 screen size.
Since: 2.1
-
readonly
boolean screenSize720_1280Indicates whether the device supports the 720 * 1280 screen size.
Since: 2.1
-
readonly
boolean autoRotationIndicates whether the device supports auto rotation.
Since: 2.1
-
readonly
boolean shellAppWidgetIndicates whether the device supports shell app widget (dynamic box).
Since: 2.1
-
readonly
boolean visionImageRecognitionIndicates whether the device supports vision image recognition.
Since: 2.1
-
readonly
boolean visionQrcodeGenerationIndicates whether the device supports vision QR code generation.
Since: 2.1
-
readonly
boolean visionQrcodeRecognitionIndicates whether the device supports vision QR code recognition.
Since: 2.1
-
readonly
boolean visionFaceRecognitionIndicates whether the device supports vision face recognition.
Since: 2.1
-
readonly
boolean secureElementIndicates whether the device supports secure element.
Since: 2.1
-
readonly
boolean nativeOspCompatibleIndicates whether the device supports native OSP API.
Since: 2.1
-
readonly
SystemInfoProfile profileRepresents the profile of the current device.
Since: 2.2
2.4. SystemInfoOptions
dictionary SystemInfoOptions { unsigned long timeout; double highThreshold; double lowThreshold; };
Since: 1.0
The highThreshold and lowThreshold values are only applicable to the following SystemInfoPropertyId.
- SystemInfoBattery - level: from 0 to 1
- SystemInfoCpu - load: from 0 to 1
- SystemInfoDisplay - brightness: from 0 to 1
For other cases, it is ignored.
Dictionary members
- unsigned long timeout
-
The number of milliseconds beyond which the operation must be interrupted.
Since: 1.0
- double highThreshold
-
An attribute to indicate that the successCallback() method in the watch
operation will be triggered only if the device property is a number and its value is greater than or equal to this number. This attribute has no effect on the get() method.
Since: 1.0
- double lowThreshold
-
An attribute to indicate that the successCallback() method in the watch operation must be triggered only if the property is a number and its value is lower than or equal to this number.
If both highThreshold and lowThreshold parameters are specified, the successCallback() is triggered if and only if the property value is either lower than the value of lowThreshold or higher than the value of highThreshold. This attribute has no effect on the get method.
Since: 1.0
2.5. SystemInfoPropertySuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface SystemInfoPropertySuccessCallback { void onsuccess(SystemInfoProperty property); };
Since: 1.0
This callback interface specifies a success callback with SystemInfoProperty as input argument. It is used in asynchronous operations, such as getPropertyValue() or addPropertyValueChangeListener().
Methods
-
onsuccess
-
Function invoked when the asynchronous call completes successfully.
void onsuccess(SystemInfoProperty property);
Since: 1.0
Parameters:
- property: The property returned from a successful asynchronous operation.
2.6. SystemInfoPropertyArraySuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface SystemInfoPropertyArraySuccessCallback { void onsuccess(SystemInfoProperty[] properties); };
Since: 2.3
This callback interface specifies a success callback with SystemInfoProperty as input argument. It is used in asynchronous operations, such as getPropertyValueArray() or addPropertyValueArrayChangeListener().
Methods
-
onsuccess
-
Function invoked when the asynchronous call completes successfully.
void onsuccess(SystemInfoProperty[] properties);
Since: 2.3
Parameters:
- properties: The array of SystemInfoProperty objects returned from a successful asynchronous operation.
2.7. SystemInfoProperty
[NoInterfaceObject] interface SystemInfoProperty { };
Since: 1.0
2.8. SystemInfoBattery
[NoInterfaceObject] interface SystemInfoBattery : SystemInfoProperty { readonly attribute double level; readonly attribute boolean isCharging; };
Since: 1.0
Listener notice:
Change listener registered on BATTERY property is triggered on level and isCharging properties change.
Attributes
-
readonly
double levelAn attribute to specify the remaining level of an internal battery, scaled from 0 to 1:
- 0 indicates that the battery level is the lowest and the system is about to enter shutdown mode.
- 1 indicates that the system's charge is maximum.
Any threshold parameter used in a watch operation to monitor this property applies to this attribute.
Since: 1.0
-
readonly
boolean isChargingIndicates whether the battery source is currently charging.
Since: 1.0
2.9. SystemInfoCpu
[NoInterfaceObject] interface SystemInfoCpu : SystemInfoProperty { readonly attribute double load; };
Since: 1.0
Attributes
-
readonly
double loadAn attribute to indicate the current CPU load, as a number between 0.0 and 1.0, representing the minimum and maximum values allowed on this system.
Any threshold parameter used in a watch function to monitor this property applies to this attribute.
Since: 1.0
2.10. SystemInfoStorage
[NoInterfaceObject] interface SystemInfoStorage : SystemInfoProperty { readonly attribute SystemInfoStorageUnit[] units; };
Since: 1.0
Attributes
-
readonly
SystemInfoStorageUnit[]
unitsThe array of storage units connected to this device.
Since: 1.0
2.11. SystemInfoStorageUnit
[NoInterfaceObject] interface SystemInfoStorageUnit : SystemInfoProperty { readonly attribute DOMString type; readonly attribute unsigned long long capacity; readonly attribute unsigned long long availableCapacity; readonly attribute boolean isRemovable; readonly attribute boolean isRemoveable; };
Since: 1.0
Attributes
-
readonly
DOMString typeThe type of a storage device. The value is one of the constants defined for this type.
The supported storage unit types are:
- UNKNOWN
- INTERNAL
- USB_DEVICE
- USB_HOST
- MMC
Since: 1.0
-
readonly
unsigned long long capacityThe total amount of space available on the user's storage (excluding system-reserved), in bytes.
Since: 1.0
-
readonly
unsigned long long availableCapacityThe amount of space currently available on the user's storage, in bytes.
Since: 1.0
-
readonly
boolean isRemovableAn attribute to indicate whether a device can be removed or not.
The following values are supported:
- true - If this storage unit can be removed from the system (such as an sdcard unplugged)
- false - If this storage unit cannot be removed from the system
Since: 2.1
-
readonly
boolean isRemoveableTrue if this unit can be removed from the system (such as an sdcard unplugged), false otherwise.
Deprecated. Deprecated since 2.1. Instead, use isRemovable.
Since: 1.0
2.12. SystemInfoDisplay
[NoInterfaceObject] interface SystemInfoDisplay : SystemInfoProperty { readonly attribute unsigned long resolutionWidth; readonly attribute unsigned long resolutionHeight; readonly attribute unsigned long dotsPerInchWidth; readonly attribute unsigned long dotsPerInchHeight; readonly attribute double physicalWidth; readonly attribute double physicalHeight; readonly attribute double brightness; };
Since: 1.0
Listener notice:
Change listener registered on DISPLAY property is triggered on brightness property change.
Attributes
-
readonly
unsigned long resolutionWidthThe total number of addressable pixels in the horizontal direction of a rectangular entity (such as Camera, Display, Image, Video, ...) when held in its default orientation.
Since: 1.0
-
readonly
unsigned long resolutionHeightThe total number of addressable pixels in the vertical direction of a rectangular element (such as Camera, Display, Image, Video, ...) when held in its default orientation.
Since: 1.0
-
readonly
unsigned long dotsPerInchWidthResolution of this device, along its width, in dots per inch.
Since: 1.0
-
readonly
unsigned long dotsPerInchHeightResolution of this device, along its height, in dots per inch.
Since: 1.0
-
readonly
double physicalWidthThe display's physical width in millimeters.
Since: 1.0
-
readonly
double physicalHeightThe display's physical height in millimeters.
Since: 1.0
-
readonly
double brightnessThe current brightness of a display ranging between 0 to 1.
Since: 1.0
2.13. SystemInfoDeviceOrientation
[NoInterfaceObject] interface SystemInfoDeviceOrientation : SystemInfoProperty { readonly attribute SystemInfoDeviceOrientationStatus status; readonly attribute boolean isAutoRotation; };
Since: 2.0
Attributes
-
readonly
SystemInfoDeviceOrientationStatus statusRepresents the status of the current device orientation.
Since: 2.0
-
readonly
boolean isAutoRotationIndicates whether the device is in autorotation.
Since: 2.2
2.14. SystemInfoBuild
[NoInterfaceObject] interface SystemInfoBuild : SystemInfoProperty { readonly attribute DOMString model; readonly attribute DOMString manufacturer; readonly attribute DOMString buildVersion; };
Since: 2.0
Attributes
-
readonly
DOMString modelRepresents the model name of the current device.
Since: 2.0
-
readonly
DOMString manufacturerRepresents the manufacturer of the device.
Since: 2.1
-
readonly
DOMString buildVersionRepresents the build version information of the device.
Since: 2.2
2.15. SystemInfoLocale
[NoInterfaceObject] interface SystemInfoLocale : SystemInfoProperty { readonly attribute DOMString language; readonly attribute DOMString country; };
Since: 2.1
Attributes
-
readonly
DOMString languageIndicates the current language setting in the (LANGUAGE)_(REGION) syntax.
The language setting is in the ISO 639-2 format and the region setting is in the ISO 3166-1 alpha-2 format. The language setting is case-sensitive.
Since: 2.1
-
readonly
DOMString countryIndicates the current country setting in the (LANGUAGE)_(REGION) syntax.
The language setting is in the ISO 639-2 format and the region setting is in the ISO 3166-1 alpha-2 format. The country setting is case-sensitive.
Since: 2.1
2.16. SystemInfoNetwork
[NoInterfaceObject] interface SystemInfoNetwork : SystemInfoProperty { readonly attribute SystemInfoNetworkType networkType; };
Since: 2.0
Attributes
-
readonly
SystemInfoNetworkType networkTypeRepresents the network type of the current data network.
Since: 2.0
2.17. SystemInfoWifiNetwork
[NoInterfaceObject] interface SystemInfoWifiNetwork : SystemInfoProperty { readonly attribute DOMString status; readonly attribute DOMString ssid; readonly attribute DOMString ipAddress; readonly attribute DOMString ipv6Address; readonly attribute DOMString macAddress; readonly attribute double signalStrength; };
Since: 1.0
Listener notice:
Change listener registered on WIFI_NETWORK property is triggered on ipAddress and ipv6Address properties change (the network layer). Those changes could be not consistent with physical layer (status or signalStrength of physical adapter).
According to above constraints, in specific situation the listener could be triggered just before network adapter shutdown and the value of status returned by listener would be outdated.
Attributes
-
readonly
DOMString statusRepresents the status (ON or OFF) of the Wi-Fi interface.
Since: 1.0
-
readonly
DOMString ssidRepresents the SSID of the Wi-Fi network.
Since: 1.0
-
readonly
DOMString ipAddressRepresents the IPv4 address of the Wi-Fi network.
Since: 1.0
-
readonly
DOMString ipv6AddressRepresents the IPv6 address of the Wi-Fi network.
Since: 2.0
-
readonly
DOMString macAddressRepresents the MAC address of the Wi-Fi interface.
It is written in MM:MM:MM:SS:SS:SS format.
Since: 2.3
-
readonly
double signalStrengthThis connection's signal strength, as a normalized value between 0 (no signal detected) and 1 (the level is at its maximum value).
Since: 1.0
2.18. SystemInfoEthernetNetwork
[NoInterfaceObject] interface SystemInfoEthernetNetwork : SystemInfoProperty { readonly attribute DOMString cable; readonly attribute DOMString status; readonly attribute DOMString ipAddress; readonly attribute DOMString ipv6Address; readonly attribute DOMString macAddress; };
Since: 2.4
Listener notice:
Change listener registered on ETHERNET_NETWORK property is triggered on ipAddress and ipv6Address properties change (the network layer). Those changes could be not consistent with physical layer (status of physical adapter).
According to above constraints, in specific situation the listener could be triggered just before network adapter shutdown and the value of status returned by listener would be outdated.
Attributes
-
readonly
DOMString cableRepresents the cable status (ATTACHED or DETACHED) of the Ethernet interface.
Since: 2.4
-
readonly
DOMString statusRepresents the status (DEACTIVATED, DISCONNECTED or CONNECTED) of the Ethernet interface.
Since: 2.4
-
readonly
DOMString ipAddressRepresents the IPv4 address of the Ethernet network.
Since: 2.4
-
readonly
DOMString ipv6AddressRepresents the IPv6 address of the Ethernet network.
Since: 2.4
-
readonly
DOMString macAddressRepresents the MAC address of the Ethernet interface.
It is written in MM:MM:MM:SS:SS:SS format.
Since: 2.4
2.19. SystemInfoCellularNetwork
[NoInterfaceObject] interface SystemInfoCellularNetwork : SystemInfoProperty { readonly attribute DOMString status; readonly attribute DOMString apn; readonly attribute DOMString ipAddress; readonly attribute DOMString ipv6Address; readonly attribute unsigned short mcc; readonly attribute unsigned short mnc; readonly attribute unsigned short cellId; readonly attribute unsigned short lac; readonly attribute boolean isRoaming; readonly attribute boolean isFlightMode; readonly attribute DOMString imei raises(WebAPIException); };
Since: 1.0
Listener notice:
Change listener registered on CELLULAR_NETWORK property is triggered on ipAddress, ipv6Address (the network layer), cellId, lac and isFlightMode properties change. Those changes could be not consistent with physical layer (status of physical adapter).
According to above constraints, in specific situation the listener could be triggered just before network adapter shutdown and the value of status returned by listener would be outdated.
Attributes
-
readonly
DOMString statusRepresents the status (ON or OFF) of the cellular network.
Since: 1.0
-
readonly
DOMString apnRepresents an Access Point Name of the cellular network.
Since: 1.0
-
readonly
DOMString ipAddressRepresents the IPv4 address of the cellular network.
Since: 1.0
-
readonly
DOMString ipv6AddressRepresents the IPv6 address of the cellular network.
Since: 2.0
-
readonly
unsigned short mccRepresents Mobile Country Code (MCC) of the cellular network.
Since: 1.0
-
readonly
unsigned short mncRepresents Mobile Network Code (MNC) of the cellular network. MNC is used in combination with MCC (also known as a "MCC / MNC tuple") to uniquely identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UMTS public land mobile networks and some satellite mobile networks.
Since: 1.0
-
readonly
unsigned short cellIdRepresents Cell ID.
Since: 1.0
-
readonly
unsigned short lacRepresents Location Area Code.
Since: 1.0
-
readonly
boolean isRoamingIndicates whether the connection is set up while the device is roaming.
Since: 1.0
-
readonly
boolean isFlightModeIndicates whether the device is in flight mode.
Since: 2.1
-
readonly
DOMString imeiRepresents the International Mobile Equipment Identity (IMEI).
Since: 2.1
Privilege level: public
Privilege: http://tizen.org/privilege/telephony
Warning: http://tizen.org/privilege/systemmanager (partner level) has been deprecated since 2.3.1. Instead, use http://tizen.org/privilege/telephony.
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
2.20. SystemInfoNetProxyNetwork
[NoInterfaceObject] interface SystemInfoNetProxyNetwork : SystemInfoProperty { readonly attribute DOMString status; };
Since: 3.0
Attributes
-
readonly
DOMString statusRepresents the status (ON or OFF) of the net_proxy network.
Since: 3.0
2.21. SystemInfoSIM
[NoInterfaceObject] interface SystemInfoSIM : SystemInfoProperty { readonly attribute SystemInfoSimState state raises(WebAPIException); readonly attribute DOMString operatorName raises(WebAPIException); readonly attribute DOMString msisdn raises(WebAPIException); readonly attribute DOMString iccid raises(WebAPIException); readonly attribute unsigned short mcc raises(WebAPIException); readonly attribute unsigned short mnc raises(WebAPIException); readonly attribute DOMString msin raises(WebAPIException); readonly attribute DOMString spn raises(WebAPIException); };
Since: 2.0
Attributes
-
readonly
SystemInfoSimState stateRepresents the SIM card state.
Since: 2.1
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
DOMString operatorNameRepresents the Operator Name String (ONS) of Common PCN Handset Specification (CPHS) in SIM card.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
DOMString msisdnRepresents the SIM card subscriber number.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/telephony
Warning: http://tizen.org/privilege/systemmanager (partner level) has been deprecated since 2.3.1. Instead, use http://tizen.org/privilege/telephony.
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
DOMString iccidRepresents the Integrated Circuit Card ID.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
unsigned short mccRepresents the Mobile Country Code (MCC) of SIM provider.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
unsigned short mncRepresents the Mobile Network Code (MNC) of SIM provider.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
DOMString msinRepresents the Mobile Subscription Identification Number (MSIN) of SIM provider.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/telephony
Warning: http://tizen.org/privilege/systemmanager (partner level) has been deprecated since 2.3.1. Instead, use http://tizen.org/privilege/telephony.
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
-
readonly
DOMString spnRepresents the Service Provider Name (SPN) of SIM card.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/system
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
2.22. SystemInfoPeripheral
[NoInterfaceObject] interface SystemInfoPeripheral : SystemInfoProperty { readonly attribute boolean isVideoOutputOn; };
Since: 2.1
Attributes
-
readonly
boolean isVideoOutputOnRepresents the video out status.
Since: 2.1
2.23. SystemInfoMemory
[NoInterfaceObject] interface SystemInfoMemory : SystemInfoProperty { readonly attribute SystemInfoLowMemoryStatus status; };
Since: 2.3
Attributes
-
readonly
SystemInfoLowMemoryStatus statusRepresents the low memory state.
Since: 2.3
2.24. SystemInfoCameraFlash
[NoInterfaceObject] interface SystemInfoCameraFlash : SystemInfoProperty { readonly attribute double brightness raises(WebAPIException); readonly attribute DOMString camera; readonly attribute long levels raises(WebAPIException); void setBrightness(double brightness) raises(WebAPIException); };
Since: 2.4
Attributes
-
readonly
double brightnessBrightness level of the camera flash (0~1).
Since: 2.4
Privilege level: public
Privilege: http://tizen.org/privilege/led
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
Code example:
tizen.systeminfo.getPropertyValue("CAMERA_FLASH", function(flash) { console.log("Flash brightness is set to: " + (flash.brightness * 100).toFixed(0) + "%"); }, function(error) { console.log("Error, name: " + error.name + ", message: " + error.message); });
- WebAPIException
-
readonly
DOMString cameraSpecifies camera to which this flash belongs.
- BACK - back camera flash
- FRONT - front camera flash
- EXTERNAL - external camera flash
- OTHER - a flash attached to any other camera
The getPropertyValue() method retrieves the SystemInfoCameraFlash for BACK camera.
Since: 2.4
-
readonly
long levelsNumber of brightness levels supported by the flash (other than 0 brightness).
Since: 2.4
Privilege level: public
Privilege: http://tizen.org/privilege/led
Exceptions:
- WebAPIException
with error type SecurityError, if this attribute is not allowed.
- WebAPIException
Methods
-
setBrightness
-
Sets the brightness value of the flash that is located next to the camera.
void setBrightness(double brightness);
Since: 2.4
If the specified brightness value is not supported by the device, the brightness is rounded down to the nearest supported brightness value.
Privilege level: public
Privilege: http://tizen.org/privilege/led
Parameters:
- brightness: The brightness value of LED (0~1).
Exceptions:
- WebAPIException
with error type InvalidValuesError, if any of the input parameters contains an invalid value.
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if the method cannot be completed because of an unknown error.
Code example:
tizen.systeminfo.getPropertyValue("CAMERA_FLASH", function(flash) { try { flash.setBrightness(1); } catch (error) { console.log("Setting flash brightness failed: " + error.message); } }, function(error) { console.log("Error, name: " + error.name + ", message: " + error.message); });
2.25. SystemInfoADS
[NoInterfaceObject] interface SystemInfoADS : SystemInfoProperty { readonly attribute DOMString id; };
Since: 3.0
Attributes
-
readonly
DOMString idRepresents the unique id of advertisement service. It is used to distinguish each device.
Since: 3.0
3. Related Feature
To guarantee the running of the application on a device which has camera back flash and control it, declare the following feature requirements in the config file:
To guarantee the running of the application on a device which supports network proxy for internet connection, declare the following feature requirements in the config file:
To guarantee the running of the application on a device which supports telephony feature, declare the following feature requirements in the config file:
To guarantee the running of the application on a device which supports Wi-Fi, declare the following feature requirements in the config file:
4. Full WebIDL
module SystemInfo { enum SystemInfoPropertyId { "BATTERY", "CPU", "STORAGE", "DISPLAY", "DEVICE_ORIENTATION", "BUILD", "LOCALE", "NETWORK", "WIFI_NETWORK", "ETHERNET_NETWORK", "CELLULAR_NETWORK", "NET_PROXY_NETWORK", "SIM", "PERIPHERAL", "MEMORY", "CAMERA_FLASH", "ADS" }; enum SystemInfoNetworkType { "NONE", "2G", "2.5G", "3G", "4G", "WIFI", "ETHERNET", "NET_PROXY", "UNKNOWN" }; enum SystemInfoDeviceOrientationStatus { "PORTRAIT_PRIMARY", "PORTRAIT_SECONDARY", "LANDSCAPE_PRIMARY", "LANDSCAPE_SECONDARY" }; enum SystemInfoSimState { "ABSENT", "INITIALIZING", "READY", "PIN_REQUIRED", "PUK_REQUIRED", "NETWORK_LOCKED", "SIM_LOCKED", "UNKNOWN" }; enum SystemInfoProfile { "MOBILE", "WEARABLE", "TV" }; enum SystemInfoLowMemoryStatus { "NORMAL", "WARNING" }; dictionary SystemInfoOptions { unsigned long timeout; double highThreshold; double lowThreshold; }; Tizen implements SystemInfoObject; [NoInterfaceObject] interface SystemInfoObject { readonly attribute SystemInfo systeminfo; }; [NoInterfaceObject] interface SystemInfo { long long getTotalMemory() raises(WebAPIException); long long getAvailableMemory() raises(WebAPIException); any getCapability(DOMString key) raises(WebAPIException); long getCount(SystemInfoPropertyId property) raises(WebAPIException); void getPropertyValue(SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void getPropertyValueArray(SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); unsigned long addPropertyValueChangeListener(SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback) raises(WebAPIException); unsigned long addPropertyValueArrayChangeListener(SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback) raises(WebAPIException); void removePropertyValueChangeListener(unsigned long listenerId) raises(WebAPIException); }; [Callback=FunctionOnly, NoInterfaceObject] interface SystemInfoPropertySuccessCallback { void onsuccess(SystemInfoProperty property); }; [Callback=FunctionOnly, NoInterfaceObject] interface SystemInfoPropertyArraySuccessCallback { void onsuccess(SystemInfoProperty[] properties); }; [NoInterfaceObject] interface SystemInfoProperty { }; [NoInterfaceObject] interface SystemInfoBattery : SystemInfoProperty { readonly attribute double level; readonly attribute boolean isCharging; }; [NoInterfaceObject] interface SystemInfoCpu : SystemInfoProperty { readonly attribute double load; }; [NoInterfaceObject] interface SystemInfoStorage : SystemInfoProperty { readonly attribute SystemInfoStorageUnit[] units; }; [NoInterfaceObject] interface SystemInfoStorageUnit : SystemInfoProperty { readonly attribute DOMString type; readonly attribute unsigned long long capacity; readonly attribute unsigned long long availableCapacity; readonly attribute boolean isRemovable; }; [NoInterfaceObject] interface SystemInfoDisplay : SystemInfoProperty { readonly attribute unsigned long resolutionWidth; readonly attribute unsigned long resolutionHeight; readonly attribute unsigned long dotsPerInchWidth; readonly attribute unsigned long dotsPerInchHeight; readonly attribute double physicalWidth; readonly attribute double physicalHeight; readonly attribute double brightness; }; [NoInterfaceObject] interface SystemInfoDeviceOrientation : SystemInfoProperty { readonly attribute SystemInfoDeviceOrientationStatus status; readonly attribute boolean isAutoRotation; }; [NoInterfaceObject] interface SystemInfoBuild : SystemInfoProperty { readonly attribute DOMString model; readonly attribute DOMString manufacturer; readonly attribute DOMString buildVersion; }; [NoInterfaceObject] interface SystemInfoLocale : SystemInfoProperty { readonly attribute DOMString language; readonly attribute DOMString country; }; [NoInterfaceObject] interface SystemInfoNetwork : SystemInfoProperty { readonly attribute SystemInfoNetworkType networkType; }; [NoInterfaceObject] interface SystemInfoWifiNetwork : SystemInfoProperty { readonly attribute DOMString status; readonly attribute DOMString ssid; readonly attribute DOMString ipAddress; readonly attribute DOMString ipv6Address; readonly attribute DOMString macAddress; readonly attribute double signalStrength; }; [NoInterfaceObject] interface SystemInfoEthernetNetwork : SystemInfoProperty { readonly attribute DOMString cable; readonly attribute DOMString status; readonly attribute DOMString ipAddress; readonly attribute DOMString ipv6Address; readonly attribute DOMString macAddress; }; [NoInterfaceObject] interface SystemInfoCellularNetwork : SystemInfoProperty { readonly attribute DOMString status; readonly attribute DOMString apn; readonly attribute DOMString ipAddress; readonly attribute DOMString ipv6Address; readonly attribute unsigned short mcc; readonly attribute unsigned short mnc; readonly attribute unsigned short cellId; readonly attribute unsigned short lac; readonly attribute boolean isRoaming; readonly attribute boolean isFlightMode; readonly attribute DOMString imei raises(WebAPIException); }; [NoInterfaceObject] interface SystemInfoNetProxyNetwork : SystemInfoProperty { readonly attribute DOMString status; }; [NoInterfaceObject] interface SystemInfoSIM : SystemInfoProperty { readonly attribute SystemInfoSimState state raises(WebAPIException); readonly attribute DOMString operatorName raises(WebAPIException); readonly attribute DOMString msisdn raises(WebAPIException); readonly attribute DOMString iccid raises(WebAPIException); readonly attribute unsigned short mcc raises(WebAPIException); readonly attribute unsigned short mnc raises(WebAPIException); readonly attribute DOMString msin raises(WebAPIException); readonly attribute DOMString spn raises(WebAPIException); }; [NoInterfaceObject] interface SystemInfoPeripheral : SystemInfoProperty { readonly attribute boolean isVideoOutputOn; }; [NoInterfaceObject] interface SystemInfoMemory : SystemInfoProperty { readonly attribute SystemInfoLowMemoryStatus status; }; [NoInterfaceObject] interface SystemInfoCameraFlash : SystemInfoProperty { readonly attribute double brightness raises(WebAPIException); readonly attribute DOMString camera; readonly attribute long levels raises(WebAPIException); void setBrightness(double brightness) raises(WebAPIException); }; [NoInterfaceObject] interface SystemInfoADS : SystemInfoProperty { readonly attribute DOMString id; }; };