| OLD | NEW |
| (Empty) |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef CHROMEOS_DBUS_BLUETOOTH_MEDIA_CLIENT_H_ | |
| 6 #define CHROMEOS_DBUS_BLUETOOTH_MEDIA_CLIENT_H_ | |
| 7 | |
| 8 #include <memory> | |
| 9 #include <string> | |
| 10 #include <vector> | |
| 11 | |
| 12 #include "base/callback.h" | |
| 13 #include "base/values.h" | |
| 14 #include "chromeos/chromeos_export.h" | |
| 15 #include "chromeos/dbus/dbus_client.h" | |
| 16 #include "dbus/object_path.h" | |
| 17 #include "dbus/property.h" | |
| 18 | |
| 19 namespace chromeos { | |
| 20 | |
| 21 // BluetoothMediaClient is used to communicate with the Media interface of a | |
| 22 // local Bluetooth adapter. | |
| 23 class CHROMEOS_EXPORT BluetoothMediaClient : public DBusClient { | |
| 24 public: | |
| 25 // Properties used to register a Media Endpoint. | |
| 26 struct CHROMEOS_EXPORT EndpointProperties { | |
| 27 EndpointProperties(); | |
| 28 ~EndpointProperties(); | |
| 29 | |
| 30 // UUID of the profile implemented by the endpoint. | |
| 31 std::string uuid; | |
| 32 | |
| 33 // Assigned codec value supported by the endpoint. The byte should match the | |
| 34 // codec specification indicated by the UUID. | |
| 35 // Since SBC codec is mandatory for A2DP, the default value of codec should | |
| 36 // be 0x00. | |
| 37 uint8_t codec; | |
| 38 | |
| 39 // Capabilities of the endpoints. The order of bytes should match the bit | |
| 40 // arrangement in the specification indicated by the UUID. | |
| 41 std::vector<uint8_t> capabilities; | |
| 42 }; | |
| 43 | |
| 44 class Observer { | |
| 45 public: | |
| 46 virtual ~Observer() {} | |
| 47 | |
| 48 // Called when the Media object with object path |object_path| is added to | |
| 49 // the system. | |
| 50 virtual void MediaAdded(const dbus::ObjectPath& object_path) {} | |
| 51 | |
| 52 // Called when the Media object with object path |object_path| is removed | |
| 53 // from the system. | |
| 54 virtual void MediaRemoved(const dbus::ObjectPath& object_path) {} | |
| 55 }; | |
| 56 | |
| 57 // Constants used to indicate exceptional error conditions. | |
| 58 static const char kNoResponseError[]; | |
| 59 | |
| 60 // The string representation for the 128-bit UUID for A2DP Sink. | |
| 61 static const char kBluetoothAudioSinkUUID[]; | |
| 62 | |
| 63 ~BluetoothMediaClient() override; | |
| 64 | |
| 65 // The ErrorCallback is used by media API methods to indicate failure. | |
| 66 // It receives two arguments: the name of the error in |error_name| and | |
| 67 // an optional message in |error_message|. | |
| 68 typedef base::Callback<void(const std::string& error_name, | |
| 69 const std::string& error_message)> ErrorCallback; | |
| 70 | |
| 71 // Adds and removes observers for events on all Media objects. Check the | |
| 72 // |object_path| parameter of observer methods to determine which Media object | |
| 73 // is issuing the event. | |
| 74 virtual void AddObserver(Observer* observer) = 0; | |
| 75 virtual void RemoveObserver(Observer* observer) = 0; | |
| 76 | |
| 77 // Registers a media endpoint to sender at the D-Bus object path | |
| 78 // |endpoint_path|. |properties| specifies profile UUID which the endpoint is | |
| 79 // for, Codec implemented by the endpoint and the Capabilities of the | |
| 80 // endpoint. | |
| 81 virtual void RegisterEndpoint(const dbus::ObjectPath& object_path, | |
| 82 const dbus::ObjectPath& endpoint_path, | |
| 83 const EndpointProperties& properties, | |
| 84 const base::Closure& callback, | |
| 85 const ErrorCallback& error_callback) = 0; | |
| 86 | |
| 87 // Unregisters the media endpoint with the D-Bus object path |endpoint_path|. | |
| 88 virtual void UnregisterEndpoint(const dbus::ObjectPath& object_path, | |
| 89 const dbus::ObjectPath& endpoint_path, | |
| 90 const base::Closure& callback, | |
| 91 const ErrorCallback& error_callback) = 0; | |
| 92 | |
| 93 // TODO(mcchou): The RegisterPlayer and UnregisterPlayer methods are not | |
| 94 // included, since they are not used. These two methods may be added later. | |
| 95 | |
| 96 static BluetoothMediaClient* Create(); | |
| 97 | |
| 98 protected: | |
| 99 BluetoothMediaClient(); | |
| 100 | |
| 101 private: | |
| 102 DISALLOW_COPY_AND_ASSIGN(BluetoothMediaClient); | |
| 103 }; | |
| 104 | |
| 105 } // namespace chromeos | |
| 106 | |
| 107 #endif // CHROMEOS_DBUS_BLUETOOTH_MEDIA_CLIENT_H_ | |
| OLD | NEW |