Chrome OS: Add bluetooth API for device discovery

chrome/browser/chromeos/bluetooth/bluetooth_adapter.h

+// Copyright (c) 2011 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 CHROME_BROWSER_CHROMEOS_BLUETOOTH_BLUETOOTH_ADAPTER_H_
+#define CHROME_BROWSER_CHROMEOS_BLUETOOTH_BLUETOOTH_ADAPTER_H_
+#pragma once
+
+#include <string>
+
+#include "base/basictypes.h"
+
+namespace chromeos {
+
+class BluetoothDevice;
+
+// BluetoothAdapter is an interface class representing a local bluetoooth
+// interface through which we can discover and interact with remote bluetooth
+// devices.
+class BluetoothAdapter {
+ public:
+  // Interface for observing changes from bluetooth adapters.
+  class Observer {
+   public:
+    // The discovery process has started on adapter |adapter_id|.
+    virtual void DiscoveryStarted(const std::string& adapter_id) {}
+
+    // The discovery process has ended on adapter |adapter_id|.
+    virtual void DiscoveryEnded(const std::string& adapter_id) {}
+
+    // A device has been discovered on adapter |adapter_id|.
+    // The observer should not cache the |device| pointer.
+    virtual void DeviceFound(const std::string& adapter_id,
+                             BluetoothDevice* device) {}
+
+    virtual ~Observer() {}
+  };
+
+  virtual ~BluetoothAdapter();
+
+  // Adds and removes the observer.
+  virtual void AddObserver(Observer* observer) = 0;
+  virtual void RemoveObserver(Observer* observer) = 0;
+
+  // Returns the unique identifier for this adapter.
+  virtual const std::string& Id() const = 0;
+
+  // Starts a device discovery on this adapter.
+  // Caller should call AddObserver() first since results will be received via
+  // the Observer interface.
+  virtual void StartDiscovery() = 0;
+
+  // Cancels any previous device discovery on this adapter.
+  virtual void StopDiscovery() = 0;
+
+  // Creates an adapter with id |id|.
+  static BluetoothAdapter* Create(const std::string& id);
+
+ protected:
+  BluetoothAdapter();
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(BluetoothAdapter);
+};
+
+}  // namespace chromeos
+
+#endif  // CHROME_BROWSER_CHROMEOS_BLUETOOTH_BLUETOOTH_ADAPTER_H_