Tizen

Tizen.System.Display, <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Led.md/">Tizen.System.Led, <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.IR.md/">Tizen.System.IR and <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Vibrator.md/">Tizen.System.Vibrator classes, the application has to request permission by adding the following privileges to the <code>tizen-manifest.xml<\/code> file:<\/p>\n<code class=\"language-XML\"><privileges>\n \n <privilege>http:\/\/tizen.org\/privilege\/display<\/privilege>\n \n <privilege>http:\/\/tizen.org\/privilege\/haptic<\/privilege>\n \n <privilege>http:\/\/tizen.org\/privilege\/use_ir<\/privilege>\n \n <privilege>http:\/\/tizen.org\/privilege\/led<\/privilege>\n<\/privileges>\n<\/code>\n<\/li>\n<li>\nTo use the methods and properties of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.md/">Tizen.System namespace classes, include the namespace in your application:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>using<\/span> <\/span>Tizen<\/span>.<\/span>System<\/span>;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ol>\n<h2 id=\"content-retrieve-battery-information\"><a href=https://samsungtizenos.com/"#content-retrieve-battery-information\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Retrieve battery information<\/h2>\n<a name=\"battery\"><\/a>\nTo retrieve battery information, follow the steps below:<\/p>\n<ul>\n<li>\nGet the battery charge percentage with the <code>Percent<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Battery.md/">Tizen.System.Battery class.<\/p>\nThe property contains the current battery charge percentage as an integer value from 0 to 100 that indicates the remaining battery charge as a percentage of the maximum level:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>int<\/span> <\/span>s_Percent<\/span>;<\/span><\/span>\ns_Percent <\/span>=<\/span> Battery.Percent;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet the current battery charging state with the <code>IsCharging<\/code> property.<\/p>\nThe property contains the device battery charging state as <code>TRUE<\/code> or <code>FALSE<\/code>:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>bool<\/span> <\/span>charging<\/span>;<\/span><\/span>\ncharging <\/span>=<\/span> Battery.IsCharging;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet the current battery level with the <code>Level<\/code> property.<\/p>\nThe property contains the device battery level as a value of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.BatteryLevelStatus.md/">Tizen.System.BatteryLevelStatus enumeration:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>BatteryLevelStatus<\/span> <\/span>status<\/span>;<\/span><\/span>\nstatus <\/span>=<\/span> Battery.Level;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet the current device's power source with the <code>PowerSource<\/code> property.<\/p>\nThe property contains the device power source type as a value of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.BatteryPowerSource.md/">Tizen.System.BatteryPowerSources enumeration:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>BatteryPowerSource<\/span> <\/span>PowerSourceType<\/span>;<\/span><\/span>\nPowerSourceType <\/span>=<\/span> Battery.PowerSource;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"display\"><\/a><\/p>\n<h2 id=\"content-control-the-display\"><a href=https://samsungtizenos.com/"#content-control-the-display\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Control the display<\/h2>\nTo retrieve and set display properties, follow these steps:<\/p>\n<ul>\n<li>\nGet the number of display devices with the <code>NumberOfDisplays<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Display.md/">Tizen.System.Display class:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>int<\/span> <\/span>num<\/span>;<\/span><\/span>\nnum <\/span>=<\/span> Display.NumberOfDisplays;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet the maximum possible brightness with the <code>MaxBrightness<\/code> property:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>Display<\/span> <\/span>dis<\/span> <\/span>=<\/span> Display.Displays[<\/span>0<\/span>];<\/span><\/span>\n<\/span>\nint<\/span> <\/span>maxBrightness<\/span> <\/span>=<\/span> dis.MaxBrightness;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet and set the display brightness with the <code>Brightness<\/code> property:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>Display<\/span> <\/span>dis<\/span> <\/span>=<\/span> Display.Displays[<\/span>0<\/span>];<\/span><\/span>\n<\/span>\nint<\/span> <\/span>curBrightness<\/span> <\/span>=<\/span> <\/span>0<\/span>;<\/span><\/span>\ncurBrightness <\/span>=<\/span> dis.Brightness;<\/span><\/span>\ndis.Brightness <\/span>=<\/span> <\/span>30<\/span>;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet and set the display state with the <code>State<\/code> property.<\/p>\nThe property contains the display state as a value of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.DisplayState.md/">Tizen.System.DisplayState enumeration:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>DisplayState<\/span> <\/span>state<\/span>;<\/span><\/span>\nstate <\/span>=<\/span> Display.State;<\/span><\/span>\nDisplay.State <\/span>=<\/span> DisplayState.Normal;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"haptic\"><\/a><\/p>\n<h2 id=\"content-control-haptic-devices\"><a href=https://samsungtizenos.com/"#content-control-haptic-devices\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Control haptic devices<\/h2>\nTo control haptic devices, follow these steps:<\/p>\n<ul>\n<li>\nGet the number of haptic devices with the <code>NumberOfVibrators<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Vibrator.md/">Tizen.System.Vibrator class:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>int<\/span> <\/span>num<\/span>;<\/span><\/span>\nnum <\/span>=<\/span> Vibrator.NumberOfVibrators;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nPlay and stop an effect on a given haptic device with the <code>Vibrate()<\/code> and <code>Stop()<\/code> methods.<\/p>\nThe device vibrates for a specified time with a constant intensity. The effect handle can be 0:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>Vibrator<\/span> <\/span>vib<\/span> <\/span>=<\/span> Vibrator.Vibrators[<\/span>0<\/span>];<\/span><\/span>\nvib.<\/span>Vibrate<\/span>(<\/span>3000<\/span>, <\/span>50<\/span>);<\/span><\/span>\n<\/span>\nvib.<\/span>Stop<\/span>();<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"ir\"><\/a><\/p>\n<h2 id=\"content-control-ir-devices\"><a href=https://samsungtizenos.com/"#content-control-ir-devices\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Control IR devices<\/h2>\nTo control an IR device, follow these steps:<\/p>\n<ul>\n<li>\nDetermine whether IR is available on the device using the <code>IsAvailable<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.IR.md/">Tizen.System.IR class:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>bool<\/span> <\/span>test<\/span>;<\/span><\/span>\ntest <\/span>=<\/span> IR.IsAvailable;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nTransmit an IR pattern with a specific carrier frequency using the <code>Transmit()<\/code> method:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>List<\/span><<\/span>int<\/span>> <\/span>pattern<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>List<\/span><<\/span>int<\/span>>();<\/span><\/span>\npattern.<\/span>Add<\/span>(<\/span>10<\/span>);<\/span><\/span>\npattern.<\/span>Add<\/span>(<\/span>50<\/span>);<\/span><\/span>\nIR.<\/span>Transmit<\/span>(<\/span>10<\/span>, pattern);<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"led\"><\/a><\/p>\n<h2 id=\"content-control-led-devices\"><a href=https://samsungtizenos.com/"#content-control-led-devices\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Control LED devices<\/h2>\nTo control LEDs on the device, follow the steps below:<\/p>\n<ul>\n<li>\nGet the maximum brightness value of a camera flash LED with the <code>MaxBrightness<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Led.md/">Tizen.System.Led class:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>int<\/span> <\/span>test<\/span>;<\/span><\/span>\ntest <\/span>=<\/span> Led.MaxBrightness;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet and set the current brightness value of a camera flash LED with the <code>Brightness<\/code> property:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>int<\/span> <\/span>test<\/span>;<\/span><\/span>\ntest <\/span>=<\/span> Led.Brightness;<\/span><\/span>\n<\/span>\nLed.Brightness <\/span>=<\/span> <\/span>45<\/span>;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nPlay and stop a custom effect on the service LED that is located on the front of the device with the <code>Play()<\/code> and <code>Stop()<\/code> methods:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>var<\/span> <\/span>t<\/span> <\/span>=<\/span> Task.<\/span>Run<\/span>(<\/span>async<\/span> <\/span>delegate<\/span><\/span>\n{<\/span><\/span>\n <\/span>await<\/span> Task.<\/span>Delay<\/span>(<\/span>1000<\/span>);<\/span><\/span>\n<\/span>\n <\/span>return<\/span> <\/span>0<\/span>;<\/span><\/span>\n});<\/span><\/span>\n<\/span>\nLed.<\/span>Play<\/span>(<\/span>500<\/span>, <\/span>200<\/span>, Color.<\/span>FromRgba<\/span>(<\/span>255<\/span>, <\/span>255<\/span>, <\/span>255<\/span>, <\/span>1<\/span>));<\/span><\/span>\nt.<\/span>Wait<\/span>();<\/span><\/span>\n<\/span>\nLed.<\/span>Stop<\/span>();<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"power\"><\/a><\/p>\n<h2 id=\"content-control-the-power-state\"><a href=https://samsungtizenos.com/"#content-control-the-power-state\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Control the power state<\/h2>\nTo lock and unlock the CPU state, follow the steps below:<\/p>\n<ul>\n<li>\nLock the power state with the <code>RequestLock()<\/code> method of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Power.md/">Tizen.System.Power class.<\/p>\nThe method locks the given PowerLock of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.PowerLock.md/">Tizen.System.PowerLock enumeration for a specified time. After the given time (in milliseconds), the lock is unlocked. If the process is destroyed, every lock is removed:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>Power.<\/span>RequestLock<\/span>(PowerLock.Cpu, <\/span>2000<\/span>);<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nUnlock the power state with the <code>ReleaseLock()<\/code> method:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>Power.<\/span>ReleaseLock<\/span>(PowerLock.Cpu);<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"changes\"><\/a><\/p>\n<h2 id=\"content-monitor-device-changes\"><a href=https://samsungtizenos.com/"#content-monitor-device-changes\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Monitor device changes<\/h2>\nTo monitor device changes, use event handlers registered to the following events:<\/p>\n<ul>\n<li><code>LevelChanged<\/code> and <code>PercentChanged<\/code> events in the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Battery.md/">Tizen.System.Battery class are called when the battery level and charge percentage change.<\/li>\n<li><code>ChargingStateChanged<\/code> event in the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Battery.md/">Tizen.System.Battery class is called when the charger is connected or disconnected.<\/li>\n<li><code>StateChanged<\/code> event in the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Display.md/">Tizen.System.Display class is called when the device display state changes.<\/li>\n<li><code>BrightnessChanged<\/code> event in the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Led.md/">Tizen.System.Led class is called when LED brightness changes.<\/li>\n<\/ul>\nTo manage device display status change events, follow these steps:<\/p>\n<ol>\n<li>\nDefine an event handler:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>public<\/span> <\/span>static<\/span> <\/span>void<\/span> <\/span>DisplayEventHandler<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>EventHandler<\/span><<\/span>DisplayStateChangedEventArgs<\/span>> <\/span>handler<\/span> <\/span>=<\/span> <\/span>null<\/span>;<\/span><\/span>\n handler <\/span>=<\/span> (<\/span>object<\/span> sender, DisplayStateChangedEventArgs args);<\/span><\/span>\n Log.<\/span>Debug<\/span>(LogTag, <\/span>string<\/span>.<\/span>Format<\/span>(<\/span>"Display State:: {0}"<\/span>, value));<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nRegister the event handler for the <code>StateChanged<\/code> event of the <code>Tizen.System.Display<\/code> class:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>Display.StateChanged <\/span>+=<\/span> handler;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nWhen no longer needed, deregister the event handler:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>Display.StateChanged <\/span>-=<\/span> handler;<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ol>\n<h2 id=\"content-related-information\"><a href=https://samsungtizenos.com/"#content-related-information\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Related information<\/h2>\n<ul>\n<li>Dependencies\n<ul>\n<li>Tizen 4.0 and Higher<\/li>\n<\/ul>\n<\/li>\n<li>API References\n<ul>\n<li><a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.System.Battery.md/">Tizen.System.Battery/n

Customize your cookie preferences

Necessary

Analytics