1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
// Copyright 2022 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROMEOS_ASH_COMPONENTS_HID_DETECTION_BLUETOOTH_HID_DETECTOR_H_
#define CHROMEOS_ASH_COMPONENTS_HID_DETECTION_BLUETOOTH_HID_DETECTOR_H_
#include <optional>
#include <string>
#include "base/memory/raw_ptr.h"
namespace ash::hid_detection {
struct BluetoothHidPairingState {
BluetoothHidPairingState(const std::string& code, uint8_t num_keys_entered);
BluetoothHidPairingState(BluetoothHidPairingState&& other);
BluetoothHidPairingState& operator=(BluetoothHidPairingState&& other);
~BluetoothHidPairingState();
// The code required to be entered for the HID to pair.
std::string code;
// The number of keys of the code which have been entered.
uint8_t num_keys_entered;
};
// Manages searching for unpaired Bluetooth human interactive devices and
// automatically attempting to pairing with them if their device type is not
// currently paired with.
class BluetoothHidDetector {
public:
struct InputDevicesStatus {
bool pointer_is_missing;
bool keyboard_is_missing;
};
enum class BluetoothHidType {
// A mouse, trackball, touchpad, etc.
kPointer,
kKeyboard,
kKeyboardPointerCombo
};
// Struct representing a Bluetooth human-interactive device.
struct BluetoothHidMetadata {
BluetoothHidMetadata(std::string name, BluetoothHidType type);
BluetoothHidMetadata(BluetoothHidMetadata&& other);
BluetoothHidMetadata& operator=(BluetoothHidMetadata&& other);
~BluetoothHidMetadata();
std::string name;
BluetoothHidType type;
};
// Struct representing the current status of BluetoothHidDetector.
struct BluetoothHidDetectionStatus {
BluetoothHidDetectionStatus(
std::optional<BluetoothHidMetadata> current_pairing_device,
std::optional<BluetoothHidPairingState> pairing_state);
BluetoothHidDetectionStatus(BluetoothHidDetectionStatus&& other);
BluetoothHidDetectionStatus& operator=(BluetoothHidDetectionStatus&& other);
~BluetoothHidDetectionStatus();
// The metadata of the device currently being paired with.
std::optional<BluetoothHidMetadata> current_pairing_device;
// Set if the current pairing requires a code that should be displayed to
// the user to enter. This will always be null if |current_pairing_device|
// is null.
std::optional<BluetoothHidPairingState> pairing_state;
};
class Delegate {
public:
virtual ~Delegate() = default;
// Invoked whenever any Bluetooth detection status property changes.
virtual void OnBluetoothHidStatusChanged() = 0;
};
virtual ~BluetoothHidDetector();
// Begins scanning for Bluetooth devices. Invokes
// OnBluetoothHidStatusChanged() for |delegate| whenever the HID detection
// status updates. Calling this method when HID detection has already started
// is an error.
void StartBluetoothHidDetection(Delegate* delegate,
InputDevicesStatus input_devices_status);
// Stops scanning for Bluetooth devices. |is_using_bluetooth| indicates
// whether or not there is at least one HID connected via Bluetooth. Calling
// this method when HID detection has not been started is an error.
void StopBluetoothHidDetection(bool is_using_bluetooth);
// Informs BluetoothHidDetector which HID types have been connected.
virtual void SetInputDevicesStatus(
InputDevicesStatus input_devices_status) = 0;
// Fetches the current Bluetooth HID detection status.
virtual const BluetoothHidDetectionStatus
GetBluetoothHidDetectionStatus() = 0;
protected:
BluetoothHidDetector() = default;
// Implementation-specific version of StartBluetoothHidDetection().
virtual void PerformStartBluetoothHidDetection(
InputDevicesStatus input_devices_status) = 0;
// Implementation-specific version of StopBluetoothHidDetection().
virtual void PerformStopBluetoothHidDetection(bool is_using_bluetooth) = 0;
// Notifies |delegate_| of status changes; should be called by derived
// types to notify observers of status changes.
void NotifyBluetoothHidDetectionStatusChanged();
private:
raw_ptr<Delegate> delegate_ = nullptr;
};
} // namespace ash::hid_detection
#endif // CHROMEOS_ASH_COMPONENTS_HID_DETECTION_BLUETOOTH_HID_DETECTOR_H_
|
