This specification defines interfaces and methods that provide web applications with access to various properties of a system.
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:
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)
NETWORK
NET_PROXY_NETWORK (Since: 3.0)
PERIPHERAL (Since: 2.1)
SIM
STORAGE
VIDEOSOURCE (Since: 2.3)
WIFI_NETWORK
ADS (Since: 3.0)
PANEL(Since: 5.5)
SOURCE_INFO(Since: 5.5)
SERVICE_COUNTRY(Since: 5.5)
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.
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.
There will be a tizen.systeminfo object that allows accessing the functionality of the SystemInfo API.
Attributes
readonlySystemInfo systeminfo
Object representing a system info module.
Since: 1.0
2.2. SystemInfo
This entry interface queries the information of a system.
[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);
};
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.");
getAvailableMemory
Gets the amount of memory that is not in use (in bytes).
long long getAvailableMemory();
Since: 2.3Return 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.");
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");
}
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 OEM's and vendors.
Parameters:
key: The device capability key for the device or additional custom device capability key specifies by OEM's
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.
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.
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.
**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.
When called, it immediately returns and then asynchronously starts a watch process defined by the following steps:
Register the successCallback to receive system events that the status of the requested properties may have changed.
When a system event is successfully received, invoke the associated successCallback with an object containing the property values.
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});
addPropertyValueArrayChangeListener
Adds a listener to allow tracking of changes in one or more values of a system property.
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.
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.
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
SystemInfoDeviceCapability object.
Deprecated. Deprecated since 2.3. Instead, use getCapability() to query device capabilities.
Indicates whether the device supports NFC reserved push.
Since: 2.1
readonlyunsigned short multiTouchCount
The number of point in Multi-point touch.
Since: 2.0
readonlyboolean inputKeyboard
Indicates whether the device supports the built-in keyboard.
Since: 2.0
readonlyboolean inputKeyboardLayout
Indicates whether the device supports the built-in keyboard layout.
Since: 2.1
readonlyboolean wifi
Indicates whether the device supports Wi-Fi.
Since: 2.0
readonlyboolean wifiDirect
Indicates whether the device supports Wi-Fi Direct.
Since: 2.0
readonlyboolean opengles
Indicates whether the device supports OpenGL-ES.
Since: 2.1
readonlyDOMString openglestextureFormat
The device 3DC texture format for OpenGL-ES.
One example of possible output is as follows: "3dc/atc/etc/ptc/pvrtc/utc"
Since: 2.1
readonlyboolean openglesVersion1_1
Indicates whether the device supports OpenGL-ES version 1.1.
Since: 2.0
readonlyboolean openglesVersion2_0
Indicates whether the device supports OpenGL-ES version 2.0.
Since: 2.0
readonlyboolean fmRadio
Indicates whether the device supports FM radio.
Since: 2.0
readonlyDOMString platformVersion
The 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.
readonlyDOMString webApiVersion
The 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.
readonlyDOMString nativeApiVersion
The 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
Exceptions:
WebAPIException
with error type SecurityError, if this attribute is not allowed.
readonlyDOMString platformName
The name of the platform.
Since: 2.0
readonlyboolean camera
Indicates whether the device supports camera.
Since: 2.1
readonlyboolean cameraFront
Indicates whether the device supports front camera.
Since: 2.0
readonlyboolean cameraFrontFlash
Indicates whether the device supports flash on the front camera.
Since: 2.0
readonlyboolean cameraBack
Indicates whether the device supports back-side camera.
Since: 2.0
readonlyboolean cameraBackFlash
Indicates whether the device supports flash on the back-side camera.
Since: 2.0
readonlyboolean location
Indicates whether the device supports GPS or not.
Since: 2.0
readonlyboolean locationGps
Indicates whether the device supports GPS based location feature.
Since: 2.0
readonlyboolean locationWps
Indicates whether the device supports WPS based location feature.
Since: 2.0
readonlyboolean microphone
Indicates whether the device supports microphone.
Since: 2.0
readonlyboolean usbHost
Indicates whether the device supports USB host.
Since: 2.0
readonlyboolean usbAccessory
Indicates whether the device supports USB accessory.
Since: 2.0
readonlyboolean screenOutputRca
Indicates whether the device supports RCA output.
Since: 2.0
readonlyboolean screenOutputHdmi
Indicates whether the device supports HDMI output.
Since: 2.0
readonlyDOMString platformCoreCpuArch
The device CPU architecture.
The possible values for this attribute are: armv6, armv7, x86.
Since: 2.0
readonlyDOMString platformCoreFpuArch
The device FPU architecture.
The possible values for this attribute are: vfpv3, sse2, sse3 and ssse3.
Since: 2.0
readonlyboolean sipVoip
Indicates whether the device supports VOIP.
Since: 2.0
readonlyDOMString duid
Indicates 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.
readonlyboolean speechRecognition
Indicates whether the device supports speech recognition.
Since: 2.0
readonlyboolean speechSynthesis
Indicates whether the device supports speech synthesis.
Since: 2.1
readonlyboolean accelerometer
Indicates whether the device supports Accelerometer sensor.
Since: 2.0
readonlyboolean accelerometerWakeup
Indicates whether the device supports accelerometer wake-up feature.
Since: 2.1
readonlyboolean barometer
Indicates whether the device supports barometer.
Since: 2.0
readonlyboolean barometerWakeup
Indicates whether the device supports barometer wake-up feature.
Since: 2.1
readonlyboolean gyroscope
Indicates whether the device supports gyroscope.
Since: 2.0
readonlyboolean gyroscopeWakeup
Indicates whether the device supports gyroscope wake-up feature.
Since: 2.1
readonlyboolean magnetometer
Indicates whether the device supports magnetometer.
Since: 2.0
readonlyboolean magnetometerWakeup
Indicates whether the device supports magnetometer wake-up feature.
Since: 2.1
readonlyboolean photometer
Indicates whether the device supports photometer.
Since: 2.1
readonlyboolean photometerWakeup
Indicates whether the device supports photometer wake-up feature.
Since: 2.1
readonlyboolean proximity
Indicates whether the device supports proximity.
Since: 2.0
readonlyboolean proximityWakeup
Indicates whether the device supports proximity wake-up feature.
Since: 2.1
readonlyboolean tiltmeter
Indicates whether the device supports tiltmeter.
Since: 2.1
readonlyboolean tiltmeterWakeup
Indicates whether the device supports tiltmeter wake-up feature.
Since: 2.1
readonlyboolean dataEncryption
Indicates whether the device supports data encryption.
Since: 2.1
readonlyboolean graphicsAcceleration
Indicates whether the device supports hardware acceleration for 2D/3D graphics.
Since: 2.1
readonlyboolean push
Indicates whether the device supports push service.
Since: 2.1
readonlyboolean telephony
Indicates whether the device supports the telephony feature.
Since: 2.1
readonlyboolean telephonyMms
Indicates whether the device supports the MMS feature.
Since: 2.1
readonlyboolean telephonySms
Indicates whether the device supports the SMS feature.
Since: 2.1
readonlyboolean screenSizeNormal
Indicates whether the device supports the screen normal size.
Since: 2.1
readonlyboolean screenSize480_800
Indicates whether the device supports the 480 * 800 screen size.
Since: 2.1
readonlyboolean screenSize720_1280
Indicates whether the device supports the 720 * 1280 screen size.
Since: 2.1
readonlyboolean autoRotation
Indicates whether the device supports auto rotation.
Since: 2.1
readonlyboolean shellAppWidget
Indicates whether the device supports shell app widget (dynamic box).
Since: 2.1
readonlyboolean visionImageRecognition
Indicates whether the device supports vision image recognition.
Since: 2.1
readonlyboolean visionQrcodeGeneration
Indicates whether the device supports vision QR code generation.
Since: 2.1
readonlyboolean visionQrcodeRecognition
Indicates whether the device supports vision QR code recognition.
Since: 2.1
readonlyboolean visionFaceRecognition
Indicates whether the device supports vision face recognition.
Since: 2.1
readonlyboolean secureElement
Indicates whether the device supports secure element.
Since: 2.1
readonlyboolean nativeOspCompatible
Indicates whether the device supports native OSP API.
Since: 2.1
readonlySystemInfoProfile profile
Represents the profile of the current device.
Since: 2.2
2.4. SystemInfoOptions
An object containing the various options for fetching the properties requested.
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 **
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.
Change listener registered on BATTERY property is triggered on level and isCharging properties change.
Attributes
readonlydouble level
An 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
readonlyboolean isCharging
Indicates whether the battery source is currently charging.
Since: 1.0
readonlylong timeToDischarge [nullable]
Estimated time to discharge, in minutes.
This parameter is mutually exclusive with parameter timeToFullCharge. An attribute timeToDischarge becomes null when device is plugged.
This attribute may equal to -1 indicating there is no enough collected data, which means that the device is still learning device's power usage characteristics and cannot predict the time yet. This process may take up to few days.
Since: 4.0
readonlylong timeToFullCharge [nullable]
Estimated time to finish charging battery, in minutes.
This parameter is mutually exclusive with parameter timeToDischarge. An attribute timeToFullCharge becomes null when device is unplugged.
This attribute may equal to -1 indicating there is no enough collected data, which means that the device is still learning device's power usage characteristics and cannot predict the time yet. This process may take up to few days.
Since: 4.0
2.9. SystemInfoCpu
This property reflects the state of the CPUs available to this system.
The array of storage units connected to this device.
Since: 1.0
2.11. SystemInfoStorageUnit
This property exposes a single storage device connected to this system.
[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;
};
Attributes
readonlyDOMString type
The 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
readonlyunsigned long long capacity
The total amount of space available on the user's storage (excluding system-reserved), in bytes.
Since: 1.0
readonlyunsigned long long availableCapacity
The amount of space currently available on the user's storage, in bytes.
Since: 1.0
readonlyboolean isRemovable
An 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
readonlyboolean isRemoveable
True 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
This property reflects the information of the Display.
[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
readonlyunsigned long resolutionWidth
The 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
readonlyunsigned long resolutionHeight
The 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
readonlyunsigned long dotsPerInchWidth
Resolution of this device, along its width, in dots per inch.
Since: 1.0
readonlyunsigned long dotsPerInchHeight
Resolution of this device, along its height, in dots per inch.
Since: 1.0
readonlydouble physicalWidth
The display's physical width in millimeters.
Since: 1.0
readonlydouble physicalHeight
The display's physical height in millimeters.
Since: 1.0
readonlydouble brightness
The current brightness of a display ranging between 0 to 1.
Since: 1.0
2.13. SystemInfoPanel
This property reflects the resolution limits of the panel.
[NoInterfaceObject] interface SystemInfoPanel : SystemInfoProperty {
readonly attribute unsigned long panelWidth;
readonly attribute unsigned long panelHeight;
};
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
readonlyDOMString status
Represents the status (ON or OFF) of the Wi-Fi interface.
Since: 1.0
readonlyDOMString ssid
Represents the SSID of the Wi-Fi network.
Since: 1.0
readonlyDOMString ipAddress
Represents the IPv4 address of the Wi-Fi network.
Since: 1.0
readonlyDOMString ipv6Address
Represents the IPv6 address of the Wi-Fi network.
Since: 2.0
readonlyDOMString macAddress
Represents the MAC address of the Wi-Fi interface.
It is written in MM:MM:MM:SS:SS:SS format.
Since: 2.3
readonlydouble signalStrength
This connection's signal strength, as a normalized value between 0 (no signal detected) and 1 (the level is at its maximum value).
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
readonlyDOMString cable
Represents the cable status (ATTACHED or DETACHED) of the Ethernet interface.
Since: 2.4
readonlyDOMString status
Represents the status (DEACTIVATED, DISCONNECTED or CONNECTED) of the Ethernet interface.
Since: 2.4
readonlyDOMString ipAddress
Represents the IPv4 address of the Ethernet network.
Since: 2.4
readonlyDOMString ipv6Address
Represents the IPv6 address of the Ethernet network.
Since: 2.4
readonlyDOMString macAddress
Represents the MAC address of the Ethernet interface.
It is written in MM:MM:MM:SS:SS:SS format.
Since: 2.4
readonlySystemInfoNetworkIpMode ipMode
Represents this connection's IP configuration type.
Since: 2.4
readonlyDOMString subnetMask
Represents the subnet mask of this connection.
It is written in 255.255.255.255 format.
Since: 2.4
readonlyDOMString gateway
Represents the gateway of this connection.
It is written in 255.255.255.255 format.
Since: 2.4
readonlyDOMString dns
Represents the DNS address of this connection.
It is written in 255.255.255.255 format.
Since: 2.4
2.20. SystemInfoCellularNetwork
This property reflects the information of the Cellular network in this system.
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
readonlyDOMString status
Represents the status (ON or OFF) of the cellular network.
Since: 1.0
readonlyDOMString apn
Represents an Access Point Name of the cellular network.
Since: 1.0
readonlyDOMString ipAddress
Represents the IPv4 address of the cellular network.
Since: 1.0
readonlyDOMString ipv6Address
Represents the IPv6 address of the cellular network.
Since: 2.0
readonlyunsigned short mcc
Represents Mobile Country Code (MCC) of the cellular network.
Since: 1.0
readonlyunsigned short mnc
Represents 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
readonlyunsigned short cellId
Represents Cell ID.
Since: 1.0
readonlyunsigned short lac
Represents Location Area Code.
Since: 1.0
readonlyboolean isRoaming
Indicates whether the connection is set up while the device is roaming.
Since: 1.0
readonlyboolean isFlightMode
Indicates whether the device is in flight mode.
Since: 2.1
readonlyDOMString imei
Represents 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.
readonlySystemInfoNetworkIpMode ipMode
Represents this connection's IP configuration type.
Since: 2.4
readonlyDOMString subnetMask
Represents the subnet mask of this connection.
It is written in 255.255.255.255 format.
Since: 2.4
readonlyDOMString gateway
Represents the gateway of this connection.
It is written in 255.255.255.255 format.
Since: 2.4
readonlyDOMString dns
Represents the DNS address of this connection.
It is written in 255.255.255.255 format.
Since: 2.4
2.21. SystemInfoNetProxyNetwork
This property reflects the information of the net_proxy network in this system.
with error type SecurityError, if this attribute is not allowed.
readonlyDOMString operatorName
Represents 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.
readonlyDOMString msisdn
Represents the SIM card subscriber number.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/telephony
Warning: The partner level privilege, http://tizen.org/privilege/systemmanager, has been deprecated. From Tizen 2.4, the public level privilege, http://tizen.org/privilege/telephony, is required.
Exceptions:
WebAPIException
with error type SecurityError, if this attribute is not allowed.
readonlyDOMString iccid
Represents 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.
readonlyunsigned short mcc
Represents 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.
readonlyunsigned short mnc
Represents 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.
readonlyDOMString msin
Represents the Mobile Subscription Identification Number (MSIN) of SIM provider.
Since: 2.0
Privilege level: public
Privilege: http://tizen.org/privilege/telephony
Warning: The partner level privilege, http://tizen.org/privilege/systemmanager, has been deprecated. From Tizen 2.4, the public level privilege, http://tizen.org/privilege/telephony, is required.
Exceptions:
WebAPIException
with error type SecurityError, if this attribute is not allowed.
readonlyDOMString spn
Represents 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.
2.23. SystemInfoPeripheral
This property reflects the peripheral information of the current device.
If there are 2 HDMI inputs on a device, Two SystemInfoVideoSourceInfo objects must be retreived through SystemInfoVideoSource {type=HDMI, number=1}, {type=HDMI, number=2}
Attributes
readonlySystemInfoVideoSourceType type
Represents the type of the video input source.
Since: 2.3
readonlylong number
Represents the input number of the input source.
If the source is "HDMI 2", the number is 2.
Since: 2.3
readonlyboolean signal [nullable]
Represents if there is a signal provided on the source.
The signal attribute can be null. The null value means that information about signal could not be retrieved at the time of returning this object. If the value is true, it means that there is signal provided. The value set to false means, that there is no signal. By default getPropertyValue functions does not support this member, and will return object with signal value set to null, it is supported only by TVWindow module. To get data about signal use tizen.tvwindow.getSource() or tizen.tvwindow.setSource().
Since: 5.5
2.26. SystemInfoVideoSource
This property reflects the video sources the device has.
To guarantee the running of the application (e.g. track the battery usage) on a device which has a battery, declare the following feature requirements in the config file:
http://tizen.org/feature/battery
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:
http://tizen.org/feature/camera.back.flash
To guarantee the running of the application on a device which supports Ethernet network feature, declare the following feature requirements in the config file:
http://tizen.org/feature/network.ethernet
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:
http://tizen.org/feature/network.net_proxy
To guarantee the running of the application on a device which supports telephony feature, declare the following feature requirements in the config file:
http://tizen.org/feature/network.telephony
To guarantee the running of the application on a device which supports Wi-Fi, declare the following feature requirements in the config file:
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.