OLD | NEW |
| (Empty) |
1 /* | |
2 * Copyright (c) 2011 The WebRTC project authors. All Rights Reserved. | |
3 * | |
4 * Use of this source code is governed by a BSD-style license | |
5 * that can be found in the LICENSE file in the root of the source | |
6 * tree. An additional intellectual property rights grant can be found | |
7 * in the file PATENTS. All contributing project authors may | |
8 * be found in the AUTHORS file in the root of the source tree. | |
9 */ | |
10 | |
11 #ifndef WEBRTC_MODULES_AUDIO_MIXER_AUDIO_MIXER_H_ | |
12 #define WEBRTC_MODULES_AUDIO_MIXER_AUDIO_MIXER_H_ | |
13 | |
14 #include <memory> | |
15 | |
16 #include "webrtc/base/refcount.h" | |
17 #include "webrtc/modules/include/module_common_types.h" | |
18 | |
19 namespace webrtc { | |
20 | |
21 class AudioMixer : public rtc::RefCountInterface { | |
22 public: | |
23 // A callback class that all mixer participants must inherit from/implement. | |
24 class Source { | |
25 public: | |
26 enum class AudioFrameInfo { | |
27 kNormal, // The samples in audio_frame are valid and should be used. | |
28 kMuted, // The samples in audio_frame should not be used, but should be | |
29 // implicitly interpreted as zero. Other fields in audio_frame | |
30 // may be read and should contain meaningful values. | |
31 kError // audio_frame will not be used. | |
32 }; | |
33 | |
34 struct AudioFrameWithInfo { | |
35 AudioFrame* audio_frame; | |
36 AudioFrameInfo audio_frame_info; | |
37 }; | |
38 | |
39 // The implementation of GetAudioFrameWithInfo should update | |
40 // audio_frame with new audio every time it's called. Implementing | |
41 // classes are allowed to return the same AudioFrame pointer on | |
42 // different calls. The pointer must stay valid until the next | |
43 // mixing call or until this audio source is disconnected from the | |
44 // mixer. The mixer may modify the contents of the passed | |
45 // AudioFrame pointer at any time until the next call to | |
46 // GetAudioFrameWithInfo, or until the source is removed from the | |
47 // mixer. | |
48 virtual AudioFrameWithInfo GetAudioFrameWithInfo(int sample_rate_hz) = 0; | |
49 | |
50 // A way for a mixer implementation do distinguish participants. | |
51 virtual int ssrc() = 0; | |
52 | |
53 protected: | |
54 virtual ~Source() {} | |
55 }; | |
56 | |
57 // Since the mixer is reference counted, the destructor may be | |
58 // called from any thread. | |
59 ~AudioMixer() override {} | |
60 | |
61 // Returns true if adding/removing was successful. A source is never | |
62 // added twice and removal is never attempted if a source has not | |
63 // been successfully added to the mixer. Addition and removal can | |
64 // happen on different threads. | |
65 virtual bool AddSource(Source* audio_source) = 0; | |
66 virtual bool RemoveSource(Source* audio_source) = 0; | |
67 | |
68 // Performs mixing by asking registered audio sources for audio. The | |
69 // mixed result is placed in the provided AudioFrame. Will only be | |
70 // called from a single thread. The rate and channels arguments | |
71 // specify the rate and number of channels of the mix result. | |
72 virtual void Mix(int sample_rate_hz, | |
73 size_t number_of_channels, | |
74 AudioFrame* audio_frame_for_mixing) = 0; | |
75 }; | |
76 } // namespace webrtc | |
77 | |
78 #endif // WEBRTC_MODULES_AUDIO_MIXER_AUDIO_MIXER_H_ | |
OLD | NEW |