| OLD | NEW |
| 1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2013 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_MANAGER_H_ | 5 #ifndef MEDIA_MIDI_MIDI_MANAGER_H_ |
| 6 #define MEDIA_MIDI_MIDI_MANAGER_H_ | 6 #define MEDIA_MIDI_MIDI_MANAGER_H_ |
| 7 | 7 |
| 8 #include <map> | |
| 9 #include <set> | 8 #include <set> |
| 10 #include <vector> | 9 #include <vector> |
| 11 | 10 |
| 12 #include "base/basictypes.h" | 11 #include "base/basictypes.h" |
| 13 #include "base/memory/ref_counted.h" | 12 #include "base/memory/ref_counted.h" |
| 14 #include "base/synchronization/lock.h" | 13 #include "base/synchronization/lock.h" |
| 15 #include "base/time/time.h" | 14 #include "base/time/time.h" |
| 16 #include "media/base/media_export.h" | 15 #include "media/base/media_export.h" |
| 17 #include "media/midi/midi_port_info.h" | 16 #include "media/midi/midi_port_info.h" |
| 18 #include "media/midi/midi_result.h" | 17 #include "media/midi/midi_result.h" |
| 19 | 18 |
| 20 namespace base { | 19 namespace base { |
| 21 class SingleThreadTaskRunner; | 20 class SingleThreadTaskRunner; |
| 22 } // namespace base | 21 } // namespace base |
| 23 | 22 |
| 24 namespace media { | 23 namespace media { |
| 25 | 24 |
| 26 // A MidiManagerClient registers with the MidiManager to receive MIDI data. | 25 // A MidiManagerClient registers with the MidiManager to receive MIDI data. |
| 27 // See MidiManager::RequestAccess() and MidiManager::ReleaseAccess() | 26 // See MidiManager::RequestAccess() and MidiManager::ReleaseAccess() |
| 28 // for details. | 27 // for details. |
| 29 class MEDIA_EXPORT MidiManagerClient { | 28 class MEDIA_EXPORT MidiManagerClient { |
| 30 public: | 29 public: |
| 31 virtual ~MidiManagerClient() {} | 30 virtual ~MidiManagerClient() {} |
| 32 | 31 |
| 33 // CompleteStartSession() is called when platform dependent preparation is | 32 // CompleteStartSession() is called when platform dependent preparation is |
| 34 // finished. | 33 // finished. |
| 35 virtual void CompleteStartSession(int client_id, MidiResult result) = 0; | 34 virtual void CompleteStartSession(MidiResult result) = 0; |
| 36 | 35 |
| 37 // ReceiveMidiData() is called when MIDI data has been received from the | 36 // ReceiveMidiData() is called when MIDI data has been received from the |
| 38 // MIDI system. | 37 // MIDI system. |
| 39 // |port_index| represents the specific input port from input_ports(). | 38 // |port_index| represents the specific input port from input_ports(). |
| 40 // |data| represents a series of bytes encoding one or more MIDI messages. | 39 // |data| represents a series of bytes encoding one or more MIDI messages. |
| 41 // |length| is the number of bytes in |data|. | 40 // |length| is the number of bytes in |data|. |
| 42 // |timestamp| is the time the data was received, in seconds. | 41 // |timestamp| is the time the data was received, in seconds. |
| 43 virtual void ReceiveMidiData(uint32 port_index, | 42 virtual void ReceiveMidiData(uint32 port_index, |
| 44 const uint8* data, | 43 const uint8* data, |
| 45 size_t length, | 44 size_t length, |
| (...skipping 18 matching lines...) Expand all Loading... |
| 64 // thread. | 63 // thread. |
| 65 static MidiManager* Create(); | 64 static MidiManager* Create(); |
| 66 | 65 |
| 67 // A client calls StartSession() to receive and send MIDI data. | 66 // A client calls StartSession() to receive and send MIDI data. |
| 68 // If the session is ready to start, the MIDI system is lazily initialized | 67 // If the session is ready to start, the MIDI system is lazily initialized |
| 69 // and the client is registered to receive MIDI data. | 68 // and the client is registered to receive MIDI data. |
| 70 // CompleteStartSession() is called with MIDI_OK if the session is started. | 69 // CompleteStartSession() is called with MIDI_OK if the session is started. |
| 71 // Otherwise CompleteStartSession() is called with proper MidiResult code. | 70 // Otherwise CompleteStartSession() is called with proper MidiResult code. |
| 72 // StartSession() and EndSession() can be called on the Chrome_IOThread. | 71 // StartSession() and EndSession() can be called on the Chrome_IOThread. |
| 73 // CompleteStartSession() will be invoked on the same Chrome_IOThread. | 72 // CompleteStartSession() will be invoked on the same Chrome_IOThread. |
| 74 void StartSession(MidiManagerClient* client, int client_id); | 73 void StartSession(MidiManagerClient* client); |
| 75 | 74 |
| 76 // A client calls EndSession() to stop receiving MIDI data. | 75 // A client calls EndSession() to stop receiving MIDI data. |
| 77 void EndSession(MidiManagerClient* client); | 76 void EndSession(MidiManagerClient* client); |
| 78 | 77 |
| 79 // DispatchSendMidiData() is called when MIDI data should be sent to the MIDI | 78 // DispatchSendMidiData() is called when MIDI data should be sent to the MIDI |
| 80 // system. | 79 // system. |
| 81 // This method is supposed to return immediately and should not block. | 80 // This method is supposed to return immediately and should not block. |
| 82 // |port_index| represents the specific output port from output_ports(). | 81 // |port_index| represents the specific output port from output_ports(). |
| 83 // |data| represents a series of bytes encoding one or more MIDI messages. | 82 // |data| represents a series of bytes encoding one or more MIDI messages. |
| 84 // |length| is the number of bytes in |data|. | 83 // |length| is the number of bytes in |data|. |
| (...skipping 56 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 141 | 140 |
| 142 size_t clients_size_for_testing() const { return clients_.size(); } | 141 size_t clients_size_for_testing() const { return clients_.size(); } |
| 143 size_t pending_clients_size_for_testing() const { | 142 size_t pending_clients_size_for_testing() const { |
| 144 return pending_clients_.size(); | 143 return pending_clients_.size(); |
| 145 } | 144 } |
| 146 | 145 |
| 147 private: | 146 private: |
| 148 void CompleteInitializationInternal(MidiResult result); | 147 void CompleteInitializationInternal(MidiResult result); |
| 149 | 148 |
| 150 // Keeps track of all clients who wish to receive MIDI data. | 149 // Keeps track of all clients who wish to receive MIDI data. |
| 151 typedef std::set<MidiManagerClient*> ClientList; | 150 typedef std::set<MidiManagerClient*> ClientSet; |
| 152 ClientList clients_; | 151 ClientSet clients_; |
| 153 | 152 |
| 154 // Keeps track of all clients who are waiting for CompleteStartSession(). | 153 // Keeps track of all clients who are waiting for CompleteStartSession(). |
| 155 typedef std::multimap<MidiManagerClient*, int> PendingClientMap; | 154 ClientSet pending_clients_; |
| 156 PendingClientMap pending_clients_; | |
| 157 | 155 |
| 158 // Keeps a SingleThreadTaskRunner of the thread that calls StartSession in | 156 // Keeps a SingleThreadTaskRunner of the thread that calls StartSession in |
| 159 // order to invoke CompleteStartSession() on the thread. | 157 // order to invoke CompleteStartSession() on the thread. |
| 160 scoped_refptr<base::SingleThreadTaskRunner> session_thread_runner_; | 158 scoped_refptr<base::SingleThreadTaskRunner> session_thread_runner_; |
| 161 | 159 |
| 162 // Keeps true if platform dependent initialization is already completed. | 160 // Keeps true if platform dependent initialization is already completed. |
| 163 bool initialized_; | 161 bool initialized_; |
| 164 | 162 |
| 165 // Keeps the platform dependent initialization result if initialization is | 163 // Keeps the platform dependent initialization result if initialization is |
| 166 // completed. Otherwise keeps MIDI_NOT_SUPPORTED. | 164 // completed. Otherwise keeps MIDI_NOT_SUPPORTED. |
| 167 MidiResult result_; | 165 MidiResult result_; |
| 168 | 166 |
| 169 // Protects access to |clients_|, |pending_clients_|, |initialized_|, and | 167 // Protects access to |clients_|, |pending_clients_|, |initialized_|, and |
| 170 // |result_|. | 168 // |result_|. |
| 171 base::Lock lock_; | 169 base::Lock lock_; |
| 172 | 170 |
| 173 MidiPortInfoList input_ports_; | 171 MidiPortInfoList input_ports_; |
| 174 MidiPortInfoList output_ports_; | 172 MidiPortInfoList output_ports_; |
| 175 | 173 |
| 176 DISALLOW_COPY_AND_ASSIGN(MidiManager); | 174 DISALLOW_COPY_AND_ASSIGN(MidiManager); |
| 177 }; | 175 }; |
| 178 | 176 |
| 179 } // namespace media | 177 } // namespace media |
| 180 | 178 |
| 181 #endif // MEDIA_MIDI_MIDI_MANAGER_H_ | 179 #endif // MEDIA_MIDI_MIDI_MANAGER_H_ |
| OLD | NEW |