<body onload="prettyPrint()" style="overflow: auto;">
-<div id="navigation">
+<div id="toc-navigation">
<div id="profile">
<p><img alt="Mobile Web" src="../images/mw_icon.png"/> <img alt="Wearable Web" src="../images/ww_icon.png"/> <img alt="Mobile native" src="../images/mn_icon.png"/></p>
</div>
<td>The application can read the user's location information.</td>
</tr>
<tr>
+ <td class="key">http://tizen.org/privilege/nfc.admin</td>
+ <td>public</td>
+ <td>Managing NFC general settings</td>
+ <td>The application can change NFC settings, such as turning NFC on or off.</td>
+</tr>
+<tr>
+ <td class="key">http://tizen.org/privilege/nfc.cardemulation</td>
+ <td>public</td>
+ <td>Using NFC card emulation mode</td>
+ <td>The application can access smart card details, such as credit card details, and allow users to make payments via NFC.</td>
+</tr>
+<tr>
+ <td class="key">http://tizen.org/privilege/nfc.common</td>
+ <td>public</td>
+ <td>Using NFC common features</td>
+ <td>The application can use NFC common features.</td>
+</tr>
+<tr>
+ <td class="key">http://tizen.org/privilege/nfc.p2p</td>
+ <td>public</td>
+ <td>Pushing NFC messages</td>
+ <td>The application can push NFC messages to other devices.</td>
+</tr>
+<tr>
+ <td class="key">http://tizen.org/privilege/nfc.tag</td>
+ <td>public</td>
+ <td>Reading/writing to NFC tags</td>
+ <td>The application can read and write NFC tag information.</td>
+</tr>
+<tr>
<td class="key">http://tizen.org/privilege/notification</td>
<td>public</td>
<td>Providing notifications</td>
<td>The application can control power-related settings, such as dimming the screen.</td>
</tr>
<tr>
+ <td class="key">http://tizen.org/privilege/push</td>
+ <td>public</td>
+ <td>Receiving push notifications</td>
+ <td>The application can receive notifications from the Internet.</td>
+</tr>
+<tr>
+ <td class="key">http://tizen.org/privilege/secureelement</td>
+ <td>public</td>
+ <td>Accessing secure elements</td>
+ <td>The application can access secure smart card chips, such as UICC/SIM, embedded secure elements, and secure SD cards.</td>
+</tr>
+<tr>
<td class="key">http://tizen.org/privilege/setting</td>
<td>public</td>
<td>Accessing user settings</td>
<p>Multimedia features include managing the device sound volume and media keys.</p>
<p>The main multimedia features are:</p>
<ul>
- <li><a href="sound_w.htm">Sound</a> <p>Enables you to control the volume level of several sound types.</p></li>
+ <li><a href="sound_w.htm">Sound</a> <p>Enables you to control the volume level of several sound types and get information about the current sound mode and the state of the current sound devices.</p></li>
<li><a href="media_key_w.htm">Media Key</a> <p>Enables you to handle media keys in your application.</p></li>
</ul>
<div id="container"><div id="contents"><div class="content">
<h1>Sound</h1>
- <p>Tizen enables you to control the volume level of several sound types. The available sound types include, for example, system, notifications, alarms, and media.</p>
+ <p>Tizen enables you to control the volume level of several sound types and get information about the current sound mode and the state of the current sound devices. The available sound types include, for example, system, notifications, alarms, and media.</p>
<table class="note">
<tbody>
<ul>
<li>Setting the volume level<p>You can <a href="../../../../../org.tizen.tutorials/html/web/tizen/multimedia/sound_tutorial_w.htm#manage">set the volume level of a specific sound type</a> with the <span style="font-family: Courier New,Courier,monospace">setVolume()</span> method.</p> </li>
<li>Getting the sound mode<p>You can <a href="../../../../../org.tizen.tutorials/html/web/tizen/multimedia/sound_tutorial_w.htm#manage">retrieve the current sound mode</a> with the <span style="font-family: Courier New,Courier,monospace">getSoundMode()</span> method.</p> </li>
- <li>Monitoring changes<p>You can <a href="../../../../../org.tizen.tutorials/html/web/tizen/multimedia/sound_tutorial_w.htm#monitor">monitor changes in the volume level and sound mode</a> by registering appropriate listeners.</p> </li>
+ <li>Getting a list of the current sound devices in a specified state<p>You can <a href="../../../../../org.tizen.tutorials/html/web/tizen/multimedia/sound_tutorial_w.htm#manage_sound_device">retrieve a list of the current sound devices which are in a specified state</a> by using the <span style="font-family: Courier New,Courier,monospace">getConnectedDeviceList()</span> or <span style="font-family: Courier New,Courier,monospace">getActivatedDeviceList()</span> methods.</p></li>
+ <li>Monitoring changes in the volume level and sound mode<p>You can <a href="../../../../../org.tizen.tutorials/html/web/tizen/multimedia/sound_tutorial_w.htm#monitor">monitor changes in the volume level and sound mode</a> by registering appropriate listeners.</p> </li>
+ <li>Monitoring changes in the sound device state<p>You can <a href="../../../../../org.tizen.tutorials/html/web/tizen/multimedia/sound_tutorial_w.htm#monitor_sound_device">monitor changes in the state of sound devices</a> with the <span style="font-family: Courier New,Courier,monospace">addDeviceStateChangeListener()</span> method.</p></li>
</ul>
<script type="text/javascript" src="../../../scripts/jquery.zclip.min.js"></script>
<p>The multimedia tutorials demonstrate how to use the following features in creating Tizen Web applications:</p>
<ul>
<li><a href="media_key_tutorial_w.htm">Media Key: Controlling Multimedia Playback</a> <p>Demonstrates how you can control multimedia playback.</p></li>
- <li><a href="sound_tutorial_w.htm">Sound: Controlling the Sound Volume Level</a> <p>Demonstrates how you can manage the device volume levels.</p></li>
+ <li><a href="sound_tutorial_w.htm">Sound: Controlling the Sound Volume Level and the Sound Devices</a> <p>Demonstrates how you can manage the device volume levels and the sound devices.</p></li>
</ul>
<script type="text/javascript" src="../../../scripts/core.js" charset="utf-8"></script>
<script type="text/javascript" src="../../../scripts/search.js" charset="utf-8"></script>
- <title>Sound: Controlling the Sound Volume Level</title>
+ <title>Sound: Controlling the Sound Volume Level and the Sound Devices</title>
</head>
<body onload="prettyPrint()" style="overflow: auto;">
<div id="toc_border"><div id="toc">
<p class="toc-title">Content</p>
<ul class="toc">
- <li><a href="#manage">Managing Sound and Volume</a></li>
- <li><a href="#monitor">Monitoring Sound and Volume Changes</a></li>
+ <li><a href="#manage">Managing Sound Mode and Volume</a></li>
+ <li><a href="#monitor">Monitoring Sound Mode and Volume Changes</a></li>
+ <li><a href="#manage_sound_device">Managing Sound Devices</a></li>
+ <li><a href="#monitor_sound_device">Monitoring the Sound Device State</a></li>
</ul>
<p class="toc-title">Related Info</p>
<ul class="toc">
<li><a href="../../../../../org.tizen.guides/html/web/tizen/multimedia/sound_w.htm">Sound Guide</a></li>
<li><a href="../../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/sound.html">Sound API for Mobile Web</a></li>
- <li><a href="../../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/sound.html">Sound API for Wearable Web</a></li>
+ <li><a href="../../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/sound.html">Sound API for Wearable Web</a></li>
</ul>
</div></div>
</div>
<div id="container"><div id="contents"><div class="content">
-<h1>Sound: Controlling the Sound Volume Level</h1>
-<div class="cont"><div class="static-cont">
+<h1>Sound: Controlling the Sound Volume Level and the Sound Devices</h1>
-<p>This tutorial demonstrates how you can manage the device volume levels.</p>
+
+<p>This tutorial demonstrates how you can manage the device volume levels and sound devices.</p>
<table class="note">
<tbody>
<h2>Warm-up</h2>
<p>Become familiar with the Sound API basics by learning about:</p>
<ul>
- <li><a class="opensection" href="#manage">Managing Sound and Volume</a> <p>Get the current sound mode and set the volume level.</p> </li>
- <li><a class="opensection" href="#monitor">Monitoring Sound and Volume Changes</a> <p>Track changes in the sound mode and volume level.</p> </li>
+ <li><a href="#manage">Managing Sound Mode and Volume</a> <p>Get the current sound mode and set the volume level.</p> </li>
+ <li><a href="#monitor">Monitoring Sound Mode and Volume Changes</a> <p>Track changes in the sound mode and volume level.</p> </li>
+ <li><a href="#manage_sound_device">Managing Sound Devices</a> <p>Get a list of the current sound devices which are in a specified state.</p> </li>
+ <li><a href="#monitor_sound_device">Monitoring the Sound Device State</a> <p>Track changes in the state of sound devices.</p> </li>
</ul>
- <div class="devicespecs-util mt5 clfix">
- <ul class="dutil">
- <li><a href="#" class="showA">Show All</a></li>
- <li class="none"><a href="#" class="hideA">Hide All</a></li>
- </ul>
- </div>
-
- <ul class="devicespecifications">
-
- <li>
- <div class="devicespec-tit">
- <h2 id="manage" name="manage" class="items-tit-h2">Managing Sound and Volume</h2>
- <span class="fr"><a href="#" class="bt-arr"><em>Hide</em></a></span>
- </div>
- <div class="devicespec-con">
+ <h2 id="manage" name="manage">Managing Sound Mode and Volume</h2>
<p>Managing sound modes and volume levels is a basic multimedia management skill:</p>
<ol>
</li>
</ol>
- </div>
- </li>
-
- <li>
- <div class="devicespec-tit">
- <h2 id="monitor" name="monitor" class="items-tit-h2">Monitoring Sound and Volume Changes</h2>
- <span class="fr"><a href="#" class="bt-arr"><em>Hide</em></a></span>
- </div>
- <div class="devicespec-con">
+
+ <h2 id="monitor" name="monitor">Monitoring Sound Mode and Volume Changes</h2>
<p>Managing sound and volume changes is a basic multimedia management skill:</p>
<ol>
tizen.sound.setSoundModeChangeListener(onsuccessCB);
</pre>
+</li>
+</ol>
+
+<h2 id="manage_sound_device" name="manage_sound_device">Managing Sound Devices</h2>
+
+<p>Learning how to list connected and activated sound devices allows you to manage sound devices more effectively:</p>
+<ol>
+<li>Get a list of the current sound devices in a connected state using the <span style="font-family: Courier New,Courier,monospace">getConnectedDeviceList()</span> method:
+<pre class="prettyprint">
+var infoArr = tizen.sound.getConnectedDeviceList();
+
+for (var i = 0; i < infoArr.length; i++)
+{
+ console.log(infoArr[i].device);
+}
+</pre>
+</li>
+<li>Get a list of the current sound devices in an activated state using the <span style="font-family: Courier New,Courier,monospace">getActivatedDeviceList()</span> method:
+<pre class="prettyprint">
+var infoArr = tizen.sound.getActivatedDeviceList();
+
+for (var i = 0; i < infoArr.length; i++)
+{
+ console.log(infoArr[i].device);
+}
+</pre>
</li>
</ol>
- </div>
- </li>
- </ul>
+<h2 id="monitor_sound_device" name="monitor_sound_device">Monitoring the Sound Device State</h2>
-</div></div>
+<p>Learning how to monitor changes in the sound device state makes it easier for you to manage the sound devices:</p>
+<ol>
+<li>Add a sound device state change listener to track changes in the sound device state:
+
+<pre class="prettyprint">
+function onchangedCB(info)
+{
+ if (info.isConnected)
+ {
+ console.log(info.device + " is connected");
+ }
+ else
+ {
+ console.log(info.device + " is not connected");
+ }
+
+ if (info.isActivated)
+ {
+ console.log(info.device + " is activated");
+ }
+ else
+ {
+ console.log(info.device + " is not activated");
+ }
+}
+
+var listenerId = tizen.sound.addDeviceStateChangeListener(onChangedCB);
+</pre>
+</li>
+<li>When no longer needed, use the listener ID to remove the sound device state change listener:
+<pre class="prettyprint">
+tizen.sound.removeDeviceStateChangeListener(listenerId);
+</pre>
+</li>
+</ol>
<script type="text/javascript" src="../../../scripts/jquery.zclip.min.js"></script>
<script type="text/javascript" src="../../../scripts/showhide.js"></script>
</tr><tr><td><a href="tizen/sound.html" data-origin="tizen" data-domain="media" data-category="core" data-status="S" data-version="">
Sound</a></td>
- <td>This API provides a way to control sound volume level.</td>
+ <td>This API provides a way to control the volume level for several sound types and to check whether a specified sound device type is connected. </td>
<td>2.3</td>
<td>Mandatory</td>
<td>Yes</td>
<td>Mandatory</td>
<td>Yes</td>
+ </tr></tbody></table><h4 id="Communication">Communication</h4>
+ <table class="api-list"><thead><tr><th>API</th><th>Description</th><th>Version (Since)</th><th>Wearable</th><th>Supported on<br>Wearable Emulator</th></tr>
+ </thead><tbody><tr><td><a href="tizen/nfc.html" data-origin="tizen" data-domain="networking" data-category="core" data-status="D" data-version="">
+ NFC</a></td>
+ <td>This API allows access to NFC device(s).</td>
+ <td>2.3.1</td>
+
+ <td>Optional</td>
+ <td>Yes</td>
+ </tr><tr><td><a href="tizen/push.html" data-origin="tizen" data-domain="push" data-category="core" data-status="D" data-version="">
+ Push</a></td>
+ <td>This API provides the functionality for receiving push notifications. </td>
+ <td>2.3.1</td>
+
+ <td>Optional</td>
+ <td>Yes</td>
+ </tr><tr><td><a href="tizen/se.html" data-origin="tizen" data-domain="push" data-category="core" data-status="D" data-version="">
+ Secure Element</a></td>
+ <td>This API provides interfaces and methods for access to Secure Elements. </td>
+ <td>2.3.1</td>
+
+ <td>Optional</td>
+ <td>No</td>
</tr></tbody></table><h4 id="Contents">Content</h4>
<table class="api-list"><thead><tr><th>API</th><th>Description</th><th>Version (Since)</th><th>Wearable</th><th>Supported on<br>Wearable Emulator</th></tr>
</thead><tbody><tr><td><a href="tizen/content.html" data-origin="tizen" data-domain="content" data-category="core" data-status="D" data-version="">
<td>Optional</td>
<td>Yes</td>
+ </tr><tr><td><a href="tizen/exif.html" data-origin="tizen" data-domain="content" data-category="core" data-status="D" data-version="">
+ Exif</a></td>
+ <td>This API provides interfaces and methods for manipulating Exif data from JPEG file.</td>
+ <td>2.3.1</td>
+
+ <td>Mandatory</td>
+ <td>Yes</td>
</tr></tbody></table><h4 id="I/O">Input/Output</h4>
<table class="api-list"><thead><tr><th>API</th><th>Description</th><th>Version (Since)</th><th>Wearable</th><th>Supported on<br>Wearable Emulator</th></tr>
- </thead><tbody><tr><td><a href="tizen/filesystem.html" data-origin="tizen" data-domain="filesystem" data-category="core" data-status="D" data-version="">
+ </thead><tbody><tr><td><a href="tizen/archive.html" data-origin="tizen" data-domain="filesystem" data-category="core" data-status="D" data-version="">
+ Archive</a></td>
+ <td>This API provides interfaces and methods to create an archive file as well as various other kinds of manipulation(e.g. extract files, add a file to an archive file).</td>
+ <td>2.3.1</td>
+
+ <td>Mandatory</td>
+ <td>Yes</td>
+ </tr><tr><td><a href="tizen/filesystem.html" data-origin="tizen" data-domain="filesystem" data-category="core" data-status="D" data-version="">
Filesystem</a></td>
<td>This API provides access to the file system of a device. This API might be obsolete in the future when W3C File APIs are extended to access system-sensitive files by Web applications. </td>
<td>1.0</td>
<td>No</td>
</tr><tr><td><a href="tizen/sound.html" data-origin="tizen" data-domain="media" data-category="core" data-status="S" data-version="">
Sound</a></td>
- <td>This API provides a way to control sound volume level.</td>
+ <td>This API provides a way to control the volume level for several sound types and to check whether a specified sound device type is connected. </td>
<td>2.3</td>
<td>Mandatory</td>
<li><a href="device_api/wearable/tizen/package.html">Package</a></li>
</ul>
</li>
+ <li><a href="device_api/wearable/index.html#Communication">Communication</a>
+ <ul>
+ <li><a href="device_api/wearable/tizen/nfc.html">NFC</a></li>
+ <li><a href="device_api/wearable/tizen/push.html">Push</a></li>
+ <li><a href="device_api/wearable/tizen/se.html">Secure Element</a></li>
+ </ul>
+ </li>
<li><a href="device_api/wearable/index.html#Contents">Content</a>
<ul>
<li><a href="device_api/wearable/tizen/content.html">Content</a></li>
<li><a href="device_api/wearable/tizen/download.html">Download</a></li>
+ <li><a href="device_api/wearable/tizen/exif.html">Exif</a></li>
</ul>
</li>
<li><a href="device_api/wearable/index.html#I/O">Input/Output</a>
<ul>
+ <li><a href="device_api/wearable/tizen/archive.html">Archive</a></li>
<li><a href="device_api/wearable/tizen/filesystem.html">Filesystem</a></li>
<li><a href="device_api/wearable/tizen/messageport.html">Message Port</a></li>
</ul>
<topic label="Tizen Web Device API Reference" href="html/device_api/device_api_cover.html">
<topic label="Mobile Web" href="html/device_api/mobile/index.html">
<topic href="html/device_api/mobile/tizen/tizen.html" label="Tizen"></topic>
-
+
<topic href="html/device_api/mobile/index.html#Application" label="Application">
<topic href="html/device_api/mobile/tizen/alarm.html" label="Alarm" ></topic>
<topic href="html/device_api/mobile/tizen/application.html" label="Application" ></topic>
</topic>
<topic href="html/device_api/mobile/index.html#I/O" label="Input/Output">
- <topic href="html/device_api/mobile/tizen/archive.html" label="Archive" ></topic>
+ <topic href="html/device_api/mobile/tizen/archive.html" label="Archive" ></topic>
<topic href="html/device_api/mobile/tizen/filesystem.html" label="Filesystem" ></topic>
<topic href="html/device_api/mobile/tizen/messageport.html" label="Message Port" ></topic>
</topic>
<topic href="html/device_api/mobile/index.html#User Interface" label="User Interface">
<topic href="html/device_api/mobile/tizen/badge.html" label="Badge" ></topic>
<topic href="html/device_api/mobile/tizen/notification.html" label="Notification" ></topic>
- </topic>
- </topic>
+ </topic>
+ </topic>
<topic label="Wearable Web" href="html/device_api/wearable/index.html">
<topic href="html/device_api/wearable/tizen/tizen.html" label="Tizen"></topic>
-
+
<topic href="html/device_api/wearable/index.html#Application" label="Application">
<topic href="html/device_api/wearable/tizen/alarm.html" label="Alarm" ></topic>
<topic href="html/device_api/wearable/tizen/application.html" label="Application" ></topic>
<topic href="html/device_api/wearable/tizen/package.html" label="Package" ></topic>
</topic>
+ <topic href="html/device_api/wearable/index.html#Communication" label="Communication">
+ <topic href="html/device_api/wearable/tizen/nfc.html" label="NFC" ></topic>
+ <topic href="html/device_api/wearable/tizen/push.html" label="Push" ></topic>
+ <topic href="html/device_api/wearable/tizen/se.html" label="Secure Element" ></topic>
+ </topic>
+
<topic href="html/device_api/wearable/index.html#Contents" label="Content">
<topic href="html/device_api/wearable/tizen/content.html" label="Content" ></topic>
<topic href="html/device_api/wearable/tizen/download.html" label="Download" ></topic>
+ <topic href="html/device_api/wearable/tizen/exif.html" label="Exif" ></topic>
</topic>
<topic href="html/device_api/wearable/index.html#I/O" label="Input/Output">
+ <topic href="html/device_api/wearable/tizen/archive.html" label="Archive" ></topic>
<topic href="html/device_api/wearable/tizen/filesystem.html" label="Filesystem" ></topic>
<topic href="html/device_api/wearable/tizen/messageport.html" label="Message Port" ></topic>
</topic>
<topic href="html/device_api/wearable/index.html#User Interface" label="User Interface">
<topic href="html/device_api/wearable/tizen/badge.html" label="Badge" ></topic>
- </topic>
+ </topic>
</topic>
</topic>
<topic label="Tizen Web UI Framework Reference" href="html/ui_fw_api/ui_fw_api_cover.html">
<topic href="html/ui_fw_api/mobile/ns_widget_mobile_Datetimepicker.htm" label="Date-time Picker"></topic>
<topic href="html/ui_fw_api/mobile/ns_widget_mobile_Drawer.htm" label="Drawer"></topic>
<topic href="html/ui_fw_api/mobile/ns_widget_mobile_FastScroll.htm" label="Fast Scroll"></topic>
- <topic href="html/ui_fw_api/mobile/ns_widget_mobile_Fliptoggle.htm" label="Flip Toggle Switch"></topic>
+ <topic href="html/ui_fw_api/mobile/ns_widget_mobile_Fliptoggle.htm" label="Flip Toggle Switch"></topic>
<topic href="html/ui_fw_api/mobile/ns_widget_mobile_Gallery.htm" label="Gallery"></topic>
<topic href="html/ui_fw_api/mobile/ns_widget_mobile_ListDivider.htm" label="List Divider"></topic>
<topic href="html/ui_fw_api/mobile/ns_widget_mobile_Listview.htm" label="List View"></topic>
<topic href="html/ui_fw_api/mobile/util/util.htm" label="Utilities">
<topic href="html/ui_fw_api/mobile/util/ns_util_DOM.htm" label="DOM Utility"></topic>
- <topic href="html/ui_fw_api/mobile/util/ns_util_selectors.htm" label="Selectors Utility"></topic>
+ <topic href="html/ui_fw_api/mobile/util/ns_util_selectors.htm" label="Selectors Utility"></topic>
</topic>
</topic>
-
+
<topic label="Wearable Web" href="html/ui_fw_api/wearable/index.htm">
<topic href="html/ui_fw_api/wearable/page/app_page_layout.htm" label="Application Page Layout">
<topic href="html/ui_fw_api/wearable/page/multi_page.htm" label="Multi-page Layout"></topic>
</topic>
<topic href="html/ui_fw_api/wearable/helper/helper.htm" label="Helper">
<topic href="html/ui_fw_api/wearable/helper/helper_listmarqueestyle.htm" label="ListMarqueeStyle">
- </topic>
+ </topic>
</topic>
<topic href="html/ui_fw_api/wearable/circular_support/circular_support.htm" label="Support for Round UI">
<topic href="html/ui_fw_api/wearable/circular_support/components/snaplist.htm" label="How to support List"></topic>
</topic>
</topic>
</topic>
-
+
<topic label="W3C/HTML5 and Supplementaries API Reference" href="html/w3c_api/w3c_api_cover.html">
<topic label="Mobile Web" href="html/w3c_api/w3c_api_m.html">
<topic href="html/w3c_api/w3c_api_m.html#dom" label="DOM, Forms and Styles">
</topic>
</topic>
-
+
<topic label="Wearable Web" href="html/w3c_api/w3c_api_w.html">
<topic href="html/w3c_api/w3c_api_w.html#dom" label="DOM, Forms and Styles">
<topic href="http://www.w3.org/TR/2014/CR-html5-20140429/forms.html#forms" label="HTML5 Forms (Partial)">
</topic>
</topic>
</topic>
-</topic>
+</topic>
<topic label="Native Application" href="../org.tizen.native.mobile.apireference/index.html">
- <link toc="../org.tizen.native.mobile.apireference/toc.xml" />
-</topic>
-
+ <topic label="Mobile Native" href="../org.tizen.native.mobile.apireference/modules.html">
+ <link toc="../org.tizen.native.mobile.apireference/toc.xml" />
+ </topic>
+ <topic label="Wearable Native" href="../org.tizen.native.wearable.apireference/modules.html">
+ <link toc="../org.tizen.native.wearable.apireference/toc.xml" />
+ </topic>
+</topic>
+
</toc>
projects / sdk / online-doc.git / commitdiff