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"
 #include "base/memory/weak_ptr.h"
 #include "chromeos/dbus/experimental_bluetooth_agent_service_provider.h"
 #include "chromeos/dbus/experimental_bluetooth_device_client.h"
 #include "dbus/object_path.h"
 #include "device/bluetooth/bluetooth_device.h"
 
 namespace chromeos {
 
 class BluetoothAdapterExperimentalChromeOS;
 
 // The BluetoothDeviceExperimentalChromeOS class is an alternate implementation
 // of BluetoothDevice for the Chrome OS platform using the Bluetooth Smart
 // capable backend. It will become the sole implementation for Chrome OS, and
 // be renamed to BluetoothDeviceChromeOS, once the backend is switched.
 class BluetoothDeviceExperimentalChromeOS
     : public device::BluetoothDevice,
       private chromeos::ExperimentalBluetoothAgentServiceProvider::Delegate {
  public:
   // BluetoothDevice override
+  virtual uint32 GetBluetoothClass() const OVERRIDE;
   virtual std::string GetAddress() const OVERRIDE;
+  virtual uint16 GetVendorID() const OVERRIDE;
+  virtual uint16 GetProductID() const OVERRIDE;
+  virtual uint16 GetDeviceID() const OVERRIDE;
   virtual bool IsPaired() const OVERRIDE;
   virtual bool IsConnected() const OVERRIDE;
   virtual bool IsConnectable() const OVERRIDE;
   virtual bool IsConnecting() const OVERRIDE;
   virtual ServiceList GetServices() const OVERRIDE;
   virtual void GetServiceRecords(
       const ServiceRecordsCallback& callback,
       const ErrorCallback& error_callback) OVERRIDE;
   virtual void ProvidesServiceWithName(
       const std::string& name,
@@ skipping 24 matching lines @@
   virtual void SetOutOfBandPairingData(
       const device::BluetoothOutOfBandPairingData& data,
       const base::Closure& callback,
       const ErrorCallback& error_callback) OVERRIDE;
   virtual void ClearOutOfBandPairingData(
       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;
 
   BluetoothDeviceExperimentalChromeOS(
       BluetoothAdapterExperimentalChromeOS* adapter,
       const dbus::ObjectPath& object_path);
   virtual ~BluetoothDeviceExperimentalChromeOS();
 
@@ skipping 74 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