[EasyUnlock] Add a private API for establishing an insecure Bluetooth connection.

chrome/common/extensions/api/easy_unlock_private.idl

 // Copyright 2014 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.
 
 // <code>chrome.easyUnlockPrivate</code> API that provides hooks to Chrome to
 // be used by Easy Unlock component app.
 [nodoc] namespace easyUnlockPrivate {
   // Signature algorithms supported by the crypto library methods used by
   // Easy Unlock.
   enum SignatureType {
@@ skipping 196 matching lines @@
     // Bluetooth address. This function is useful as a faster alternative to
     // Bluetooth discovery, when you already know the remote device's Bluetooth
     // address. A successful call to this function has the side-effect of
     // registering the device with the Bluetooth daemon, making it available for
     // future outgoing connections.
     // |deviceAddress|: The Bluetooth address of the device to connect to.
     // |callback|: Called to indicate success or failure.
     static void seekBluetoothDeviceByAddress(DOMString deviceAddress,
                                              optional EmptyCallback callback);
 
+    // Connects the socket to a remote Bluetooth device over an insecure
+    // connection, i.e. a connection that requests no bonding and no
+    // man-in-the-middle protection. Other than the reduced security setting,
+    // behaves identically to the chrome.bluetoothSocket.connect() function.
+    // |socketId| : The socket identifier, as issued by the

[Yoyo Zhou, 2014/08/21 22:42:53]

nit: no space between | and :

[Ilya Sherman, 2014/08/21 23:11:29]

Done.

+    //     chrome.bluetoothSocket API.
+    // |address| : The address of the Bluetooth device.

[Yoyo Zhou, 2014/08/21 22:42:52]

Should this be called deviceAddress for consistency with
seekBluetoothDeviceByAddress? The doc string should be the same if so.

[Ilya Sherman, 2014/08/21 23:11:29]

Done.

+    // |uuid| : The UUID of the service to connect to.
+    // |callback| : Called when the connect attempt is complete.
+    static void connectToBluetoothServiceInsecurely(long socketId,
+                                                    DOMString address,
+                                                    DOMString uuid,
+                                                    EmptyCallback callback);
+
     // Updates the screenlock state to reflect the Easy Unlock app state.
     static void updateScreenlockState(State state,
                                       optional EmptyCallback callback);
 
     // Saves the permit record for the local device.
     // |permitAccess|: The permit record to be saved.
     // |callback|: Called to indicate success or failure.
     static void setPermitAccess(PermitRecord permitAccess,
                                 optional EmptyCallback callback);
 
     // Gets the permit record for the local device.
     static void getPermitAccess(GetPermitAccessCallback callback);
 
     // Clears the permit record for the local device.
     static void clearPermitAccess(optional EmptyCallback callback);
 
     // Saves the remote device list.
     // |devices|: The list of remote devices to be saved.
     // |callback|: Called to indicate success or failure.
     static void setRemoteDevices(Device[] devices,
                                  optional EmptyCallback callback);
 
     // Gets the remote device list.
     static void getRemoteDevices(GetRemoteDevicesCallback callback);
   };
 };