[Bluetooth] Added getServiceAllUuids() function.
authorTomasz Marciniak <t.marciniak@samsung.com>
Mon, 8 Feb 2016 14:28:39 +0000 (15:28 +0100)
committerTomasz Marciniak <t.marciniak@samsung.com>
Wed, 9 Mar 2016 11:18:59 +0000 (12:18 +0100)
Change-Id: I3ecdcfce61b0e5648ff295b495b79b38021cc370
Signed-off-by: Tomasz Marciniak <t.marciniak@samsung.com>
org.tizen.tutorials/html/web/tizen/network/bluetooth_tutorial_w.htm
org.tizen.web.apireference/html/device_api/mobile/tizen/bluetooth.html

index f8c30b2..e18ff9d 100644 (file)
@@ -558,6 +558,14 @@ for (i; i &lt; serviceUUIDs.length; i++)
 }</pre>
    </li>
 
+   <li><p>Retrieve all service UUIDs using the <span style="font-family: Courier New,Courier,monospace">getServiceAllUuids()</span> method of the <span style="font-family: Courier New,Courier,monospace">BluetoothLEDevice</span> interface.</p>
+<pre class="prettyprint">
+var services = remoteDevice.getServiceAllUuids();
+
+console.log(&quot;Services length &quot; + services.length);
+</pre>
+   </li>
+
   </ol>
 
        <h2 id="Characteristic_Value" name="Characteristic_Value">Accessing the Bluetooth GATT Characteristic Value</h2>
@@ -726,4 +734,4 @@ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga
 </script>
 
  </body>
-</html>
\ No newline at end of file
+</html>
index 4667b48..499dcc8 100644 (file)
@@ -245,6 +245,7 @@ For more information on the Bluetooth features, see <a href="../../../../../org.
 <td>void <a href="#BluetoothLEDevice::connect">connect</a> (optional <a href="tizen.html#SuccessCallback">SuccessCallback</a>? successCallback, optional <a href="tizen.html#ErrorCallback">ErrorCallback</a>? errorCallback)<br>
     void <a href="#BluetoothLEDevice::disconnect">disconnect</a> (optional <a href="tizen.html#SuccessCallback">SuccessCallback</a>? successCallback, optional <a href="tizen.html#ErrorCallback">ErrorCallback</a>? errorCallback)<br>
     <a href="#BluetoothGATTService">BluetoothGATTService</a> <a href="#BluetoothLEDevice::getService">getService</a> (<a href="#BluetoothUUID">BluetoothUUID</a> uuid)<br>
+    <a href="#BluetoothUUID">BluetoothUUID</a>[] <a href="#BluetoothLEDevice::getServiceAllUuids">getServiceAllUuids</a> ()<br>
     long <a href="#BluetoothLEDevice::addConnectStateChangeListener">addConnectStateChangeListener</a> (<a href="#BluetoothLEConnectChangeCallback">BluetoothLEConnectChangeCallback</a> listener)<br>
     void <a href="#BluetoothLEDevice::removeConnectStateChangeListener">removeConnectStateChangeListener</a> (long watchID)</td>
 </tr>
@@ -3899,7 +3900,7 @@ A <em>BluetoothLEDevice</em> object can be retrieved by using one of the followi
 <span class="attrName"><span class="readonly">                readonly
 </span><span class="type">BluetoothUUID[]
                       </span><span class="name">uuids</span><span class="optional"> [nullable]</span></span><div class="brief">
- The list of 128 bit service UUIDs available on this remote device.
+ The list of service UUIDs from scan result.
             </div>
 <p><span class="version">
             Since: </span>
@@ -4242,6 +4243,58 @@ Instead, use <em>http://tizen.org/privilege/bluetooth</em>.
  </pre>
 </div>
 </dd>
+<dt class="method" id="BluetoothLEDevice::getServiceAllUuids">
+<a class="backward-compatibility-anchor" name="::Bluetooth::BluetoothLEDevice::getServiceAllUuids"></a><code><b><span class="methodName">getServiceAllUuids</span></b></code>
+</dt>
+<dd>
+<div class="brief">
+ Retrieves list of all service UUIDs from connected GATT server.
+            </div>
+<div class="synopsis"><pre class="signature prettyprint"><a href="#BluetoothUUID">BluetoothUUID</a>[] getServiceAllUuids();
+             </pre></div>
+<p><span class="version">
+            Since: </span>
+ 3.0
+            </p>
+<p><span class="privilegelevel">
+            Privilege level: </span>
+ public
+            </p>
+<p><span class="privilege">
+            Privilege: </span>
+ http://tizen.org/privilege/bluetooth
+            </p>
+<div class="exceptionlist">
+<p><span class="except">Exceptions:</span></p>
+          <ul class="exception"><li>WebAPIException<ul>
+            <li class="list"><p> with error type InvalidValuesError, If GATT server is not available.</p></li>
+            <li class="list"><p> with error type NotSupportedError, If the feature is not supported.</p></li>
+          </ul>
+</li></ul>
+        </div>
+<div class="example">
+<span class="example"><p>Code example:</p></span><pre name="code" class="examplecode prettyprint"> function onconnected(device) {
+        console.log("Connected to device");
+        var services = device.getServiceAllUuids();
+        console.log("Services length " + services.length);
+ }
+
+ function onerror(e) {
+     console.log("Error occured: " + e.message);
+ }
+
+ function onDeviceFound(device) {
+    if (device.address == "11:22:33:44:55:66") {
+        console.log("Found device: " + device.name);
+        device.connect(onconnected.bind(null, device), onerror);
+    }
+ }
+
+ var adapter = tizen.bluetooth.getLEAdapter();
+ adapter.startScan(onDeviceFound, onerror);
+ </pre>
+</div>
+</dd>
 <dt class="method" id="BluetoothLEDevice::addConnectStateChangeListener">
 <a class="backward-compatibility-anchor" name="::Bluetooth::BluetoothLEDevice::addConnectStateChangeListener"></a><code><b><span class="methodName">addConnectStateChangeListener</span></b></code>
 </dt>
@@ -6722,6 +6775,8 @@ To guarantee that the Bluetooth Low Energy application runs on a device with Blu
 
         <a href="#BluetoothGATTService">BluetoothGATTService</a> getService(<a href="#BluetoothUUID">BluetoothUUID</a> uuid) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
 
+        <a href="#BluetoothUUID">BluetoothUUID</a>[] getServiceAllUuids() raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
+
         long addConnectStateChangeListener(<a href="#BluetoothLEConnectChangeCallback">BluetoothLEConnectChangeCallback</a> listener) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
 
         void removeConnectStateChangeListener(long watchID);