Add bluetooth.getName API.

chrome/common/extensions/api/experimental_bluetooth.idl

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Bluetooth API.
 // TODO(bryeung): mark this API as ChromeOS only (see crbug.com/119398).
 
 namespace experimental.bluetooth {
   dictionary Device {
     // The address of the device, in the format 'XX:XX:XX:XX:XX:XX'.
@@ skipping 36 matching lines @@
     // Simple Pairing Randomizer R.
     // Always 16 octets long.
     ArrayBuffer randomizer;
   };
 
   callback AddressCallback = void (DOMString result);
   callback BooleanCallback = void (boolean result);
   callback DataCallback = void (ArrayBuffer result);
   callback DeviceCallback = void (Device device);
   callback DevicesCallback = void (Device[] result);
+  callback NameCallback = void (DOMString result);
   callback OutOfBandPairingDataCallback = void (OutOfBandPairingData data);
   callback ResultCallback = void ();
   callback ServicesCallback = void(ServiceRecord[] result);
   callback SizeCallback = void (long result);
   callback SocketCallback = void (Socket result);
 
   // Options for the getDevices function. If neither |uuid| or |name| are
   // provided, all devices known to the system are returned.
   dictionary GetDevicesOptions {
     // Only devices providing a service with a UUID that matches |uuid| will be
@@ skipping 55 matching lines @@
   };
 
   // Options for the startDiscovery function.
   dictionary StartDiscoveryOptions {
     // Called for each device that is discovered.
     DeviceCallback deviceCallback;
   };
 
   // These functions all report failures via chrome.extension.lastError.
   interface Functions {
-    // Checks if the system has bluetooth support.
+    // Checks if the system has Bluetooth support.
     // |callback| : Called with the boolean result.
     static void isAvailable(BooleanCallback callback);
 
-    // Checks if the system's bluetooth module has power.
+    // Checks if the system's Bluetooth module has power.
     // |callback| : Called with the boolean result.
     static void isPowered(BooleanCallback callback);
 
-    // Get the bluetooth address of the system's bluetooth module.
-    // |callback| : Called with the address, or null if there was an error.
+    // Get the Bluetooth address of the system's Bluetooth module.
+    // |callback| : Called with the address of the Bluetooth adapter, or "" if
+    //              there is no adapater available.
     static void getAddress(AddressCallback callback);
 
-    // Get a list of bluetooth devices.
+    // Get the name of the Bluetooth adapter.
+    // |callback| : Called with the name of the Bluetooth adapter, or "" if
+    //              there is no adapater available.
+    static void getName(NameCallback callback);
+
+    // Get a list of Bluetooth devices.
     // NOTE: This API is likely to change.  Please see crbug.com/134545
     // |options|  : Controls which devices are returned.
     // |callback| : Called with an array of Device objects.
     static void getDevices(GetDevicesOptions options,
                            DevicesCallback callback);
 
     // Get a list of services provided by a device.
     static void getServices(GetServicesOptions options,
                             ServicesCallback callback);
 
     // Connect to a service on a device.
     // |options|  : The options for the connection.
     // |callback| : Called when the connection is established with a Socket
     //              that can be used to communicate with |device|.
     static void connect(ConnectOptions options,
                         SocketCallback callback);
 
-    // Close a bluetooth connection.
+    // Close a Bluetooth connection.
     // |options|  : The options for this function.
     // |callback| : Called to indicate success or failure.
     static void disconnect(DisconnectOptions options,
                            optional ResultCallback callback);
 
-    // Read data from a bluetooth connection.
+    // Read data from a Bluetooth connection.
     // |options|  : The options for this function.
     // |callback| : Called with the data when it is available.
     static void read(ReadOptions options,
                      DataCallback callback);
 
-    // Write data to a bluetooth connection.
+    // Write data to a Bluetooth connection.
     // |options|  : The options for this function.
     // |callback| : Called with the number of bytes written.
     static void write(WriteOptions options,
                       optional SizeCallback callback);
 
     // Get the local Out of Band Pairing data.
     // |callback| : Called with the data.
     static void getLocalOutOfBandPairingData(
         OutOfBandPairingDataCallback callback);
 
@@ skipping 14 matching lines @@
         StartDiscoveryOptions options,
         optional ResultCallback callback);
 
     // Stop discovery.
     // |callback| : Called to indicate success or failure.
     static void stopDiscovery(
         optional ResultCallback callback);
   };
 
   interface Events {
-    // Fired when the availability of bluetooth on the system changes.
-    // |available| : True if bluetooth is available, false otherwise.
+    // Fired when the availability of Bluetooth on the system changes.
+    // |available| : True if Bluetooth is available, false otherwise.
     static void onAvailabilityChanged(boolean available);
 
-    // Fired when the power state of bluetooth on the system changes.
-    // |powered| : True if bluetooth is powered, false otherwise.
+    // Fired when the power state of Bluetooth on the system changes.
+    // |powered| : True if Bluetooth is powered, false otherwise.
     static void onPowerChanged(boolean has_power);
 
     // Fired when the discovering state of the system changes.
     // |discovering| : True if the system is currently in discovery mode, false
     //                 otherwise.
     static void onDiscoveringChanged(boolean discovering);
   };
 };