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 67 matching lines @@
     static void isAvailable(BooleanCallback callback);
 
     // 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.
     static void getAddress(AddressCallback callback);
 
+    // Get the name of the Bluetooth adapter.
+    // |callback| : Called with the name, or null if there was an error.

[asargent_no_longer_on_chrome, 2012/08/20 19:07:19]

documentation nit: from a glance at the implementation, it looks like there
aren't any possible errors (apart from a null pointer dereference in the browser
process if the bluetooth adapter were somehow null), but even if there were
|name| would just end up as the empty string instead of null. Finally, for null
to be a valid return value, I think you'd need to change the signature of
NameCallback to:

callback NameCallback = void (DOMString? result);

[bryeung, 2012/08/20 23:13:19]

Done.

+    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);
@@ skipping 59 matching lines @@
     // 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);
   };
 };