Bluetooth: gather usage metrics

device/bluetooth/bluetooth_device_experimental_chromeos.h

 // Copyright (c) 2013 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.
 
 #ifndef DEVICE_BLUETOOTH_BLUETOOTH_DEVICE_EXPERIMENTAL_CHROMEOS_H
 #define DEVICE_BLUETOOTH_BLUETOOTH_DEVICE_EXPERIMENTAL_CHROMEOS_H
 
 #include <string>
 
 #include "base/memory/scoped_ptr.h"
@@ skipping 58 matching lines @@
       const base::Closure& callback,
       const ErrorCallback& error_callback) OVERRIDE;
 
  protected:
    // BluetoothDevice override
   virtual uint32 GetBluetoothClass() const OVERRIDE;
   virtual std::string GetDeviceName() const OVERRIDE;
 
  private:
   friend class BluetoothAdapterExperimentalChromeOS;
+  friend class MetricsLog;
 
   BluetoothDeviceExperimentalChromeOS(
       BluetoothAdapterExperimentalChromeOS* adapter,
       const dbus::ObjectPath& object_path);
   virtual ~BluetoothDeviceExperimentalChromeOS();
 
   // ExperimentalBluetoothAgentServiceProvider::Delegate override.
   virtual void Release() OVERRIDE;
   virtual void RequestPinCode(const dbus::ObjectPath& device_path,
                               const PinCodeCallback& callback) OVERRIDE;
   virtual void DisplayPinCode(const dbus::ObjectPath& device_path,
                               const std::string& pincode) OVERRIDE;
   virtual void RequestPasskey(const dbus::ObjectPath& device_path,
                               const PasskeyCallback& callback) OVERRIDE;
   virtual void DisplayPasskey(const dbus::ObjectPath& device_path,
                               uint32 passkey, int16 entered) OVERRIDE;
   virtual void RequestConfirmation(const dbus::ObjectPath& device_path,
                                    uint32 passkey,
                                    const ConfirmationCallback& callback)
       OVERRIDE;
   virtual void RequestAuthorization(const dbus::ObjectPath& device_path,
                                     const ConfirmationCallback& callback)
       OVERRIDE;
   virtual void AuthorizeService(const dbus::ObjectPath& device_path,
                                 const std::string& uuid,
                                 const ConfirmationCallback& callback) OVERRIDE;
   virtual void Cancel() OVERRIDE;
 
+  // Used by MetricsLog to obtain the device information.
+  std::string GetModalias() const;
+
   // Internal method to initiate a connection to this device, and methods called
   // by dbus:: on completion of the D-Bus method call.
   void ConnectInternal(const base::Closure& callback,
                        const ConnectErrorCallback& error_callback);
   void OnConnect(const base::Closure& callback);
   void OnConnectError(const ConnectErrorCallback& error_callback,
                       const std::string& error_name,
                       const std::string& error_message);
 
   // Called by dbus:: on completion of the D-Bus method call to register the
@@ skipping 42 matching lines @@
   // there is no matching completion call since this object is deleted in the
   // process of unpairing.
   void OnForgetError(const ErrorCallback& error_callback,
                      const std::string& error_name,
                      const std::string& error_message);
 
   // Run any outstanding pairing callbacks passing |status| as the result of
   // pairing. Returns true if any callbacks were run, false if not.
   bool RunPairingCallbacks(Status status);
 
+  // Record the result of pairing as a UMA histogram metric; |success| should
+  // be true if pairing succeeded, and |false| if not - in which case
+  // |error_code| specifies the reason for failure.
+  void RecordPairingResult(bool success, ConnectErrorCode error_code);
+
   // Return the object path of the device; used by
   // BluetoothAdapterExperimentalChromeOS
   const dbus::ObjectPath& object_path() const { return object_path_; }
 
   // The adapter that owns this device instance.
   BluetoothAdapterExperimentalChromeOS* adapter_;
 
   // The dbus object path of the device object.
   dbus::ObjectPath object_path_;
 
   // Number of ongoing calls to Connect().
   int num_connecting_calls_;
 
   // During pairing this is set to an object that we don't own, but on which
   // we can make method calls to request, display or confirm PIN Codes and
   // Passkeys. Generally it is the object that owns this one.
   PairingDelegate* pairing_delegate_;
 
+  // Flag to indicate whether a pairing delegate method has been called during
+  // pairing.
+  bool pairing_delegate_used_;
+
   // During pairing this is set to an instance of a D-Bus agent object
   // intialized with our own class as its delegate.
   scoped_ptr<ExperimentalBluetoothAgentServiceProvider> agent_;
 
   // During pairing these callbacks are set to those provided by method calls
   // made on us by |agent_| and are called by our own method calls such as
   // SetPinCode() and SetPasskey().
   PinCodeCallback pincode_callback_;
   PasskeyCallback passkey_callback_;
   ConfirmationCallback confirmation_callback_;
 
   // Note: This should remain the last member so it'll be destroyed and
   // invalidate its weak pointers before any other members are destroyed.
   base::WeakPtrFactory<BluetoothDeviceExperimentalChromeOS> weak_ptr_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(BluetoothDeviceExperimentalChromeOS);
 };
 
 }  // namespace chromeos
 
 #endif /* DEVICE_BLUETOOTH_BLUETOOTH_DEVICE_EXPERIMENTAL_CHROMEOS_H */