OLD | NEW |
---|---|
1 // Copyright 2016 The Chromium Authors. All rights reserved. | 1 // Copyright 2016 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef MEDIA_MIDI_MIDI_SERVICE_H_ | 5 #ifndef MEDIA_MIDI_MIDI_SERVICE_H_ |
6 #define MEDIA_MIDI_MIDI_SERVICE_H_ | 6 #define MEDIA_MIDI_MIDI_SERVICE_H_ |
7 | 7 |
8 #include <stdint.h> | 8 #include <stdint.h> |
9 | 9 |
10 #include <memory> | 10 #include <memory> |
11 #include <vector> | 11 #include <vector> |
12 | 12 |
13 #include "base/macros.h" | 13 #include "base/macros.h" |
14 #include "base/memory/ref_counted.h" | |
15 #include "base/single_thread_task_runner.h" | |
14 #include "base/synchronization/lock.h" | 16 #include "base/synchronization/lock.h" |
17 #include "base/threading/thread.h" | |
15 #include "media/midi/midi_export.h" | 18 #include "media/midi/midi_export.h" |
16 #include "media/midi/midi_manager.h" | 19 #include "media/midi/midi_manager.h" |
17 | 20 |
18 namespace midi { | 21 namespace midi { |
19 | 22 |
23 class MidiManagerAlsa; | |
24 | |
20 // Manages MidiManager backends. This class expects to be constructed and | 25 // Manages MidiManager backends. This class expects to be constructed and |
21 // destructed on the browser main thread, but methods can be called on both | 26 // destructed on the browser main thread, but methods can be called on both |
22 // the main thread and the I/O thread. | 27 // the main thread and the I/O thread. |
23 class MIDI_EXPORT MidiService final { | 28 class MIDI_EXPORT MidiService final { |
24 public: | 29 public: |
25 // |MidiManager| can be explicitly specified in the constructor for testing. | 30 // |MidiManager| can be explicitly specified in the constructor for testing. |
26 explicit MidiService(std::unique_ptr<MidiManager> manager = nullptr); | 31 explicit MidiService(std::unique_ptr<MidiManager> manager = nullptr); |
27 ~MidiService(); | 32 ~MidiService(); |
28 | 33 |
29 // Called on the browser main thread to notify the I/O thread will stop and | 34 // Called on the browser main thread to notify the I/O thread will stop and |
30 // the instance will be destructed on the main thread soon. | 35 // the instance will be destructed on the main thread soon. |
31 void Shutdown(); | 36 void Shutdown(); |
32 | 37 |
33 // A client calls StartSession() to receive and send MIDI data. | 38 // A client calls StartSession() to receive and send MIDI data. |
34 void StartSession(MidiManagerClient* client); | 39 void StartSession(MidiManagerClient* client); |
35 | 40 |
36 // A client calls EndSession() to stop receiving MIDI data. | 41 // A client calls EndSession() to stop receiving MIDI data. |
37 void EndSession(MidiManagerClient* client); | 42 void EndSession(MidiManagerClient* client); |
38 | 43 |
39 // A client calls DispatchSendMidiData() to send MIDI data. | 44 // A client calls DispatchSendMidiData() to send MIDI data. |
40 virtual void DispatchSendMidiData(MidiManagerClient* client, | 45 void DispatchSendMidiData(MidiManagerClient* client, |
41 uint32_t port_index, | 46 uint32_t port_index, |
42 const std::vector<uint8_t>& data, | 47 const std::vector<uint8_t>& data, |
43 double timestamp); | 48 double timestamp); |
44 | 49 |
50 protected: | |
yhirano
2017/02/08 03:50:24
Why is this protected? Even if you place the frien
Takashi Toyoshima
2017/02/08 09:08:00
Done.
| |
51 friend class MidiManagerAlsa; | |
52 | |
53 // Returns a SingleThreadTaskRunner reference to serve MidiManager. Each | |
54 // TaskRunner will be constructed on demand. | |
55 // MidiManager that supports the dynamic instantiation feature will use this | |
56 // method to post tasks that should not run on I/O. Since TaskRunners outlive | |
57 // MidiManager, each task should be bound with WeakPtr<> if the task is not a | |
58 // static method. TaskRunners will be reused when another MidiManager is | |
59 // instantiated. | |
60 static scoped_refptr<base::SingleThreadTaskRunner> GetTaskRunner( | |
yhirano
2017/02/08 03:50:24
Can you tell me what this means? Does that mean ea
Takashi Toyoshima
2017/02/08 09:08:01
Oops, later part of this comment was stale (explai
| |
61 size_t runner_id); | |
62 | |
63 private: | |
64 scoped_refptr<base::SingleThreadTaskRunner> GetTaskRunnerImpl( | |
65 size_t runner_id); | |
66 | |
67 // Holds MidiManager instance. If the dynamic instantiation feature is | |
68 // enabled, the MidiManager would be constructed and destructed on the I/O | |
69 // thread, and all MidiManager methods would be called on the I/O thread. | |
45 std::unique_ptr<MidiManager> manager_; | 70 std::unique_ptr<MidiManager> manager_; |
71 | |
72 // A flag to indicate if the dynamic instantiation feature is supported and | |
73 // actually enabled. | |
74 bool is_dynamic_instantiation_enabled_; | |
yhirano
2017/02/08 03:50:24
I think you don't need to protect this member, rig
Takashi Toyoshima
2017/02/08 09:08:00
Done.
| |
75 | |
76 // Counts active clients to manage dynamic MidiManager instantiation. | |
77 size_t active_clients_; | |
78 | |
79 // Protects all members above. | |
46 base::Lock lock_; | 80 base::Lock lock_; |
47 | 81 |
82 // Threads to host SingleThreadTaskRunners. | |
83 std::vector<std::unique_ptr<base::Thread>> threads_; | |
84 | |
85 // Protects |threads_|. | |
86 base::Lock threads_lock_; | |
87 | |
48 DISALLOW_COPY_AND_ASSIGN(MidiService); | 88 DISALLOW_COPY_AND_ASSIGN(MidiService); |
49 }; | 89 }; |
50 | 90 |
51 } // namespace midi | 91 } // namespace midi |
52 | 92 |
53 #endif // MEDIA_MIDI_MIDI_SERVICE_H_ | 93 #endif // MEDIA_MIDI_MIDI_SERVICE_H_ |
OLD | NEW |