Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (c) 2015 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 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 11 | #ifndef CALL_AUDIO_RECEIVE_STREAM_H_ |
| 12 | #define CALL_AUDIO_RECEIVE_STREAM_H_ |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 13 | |
Fredrik Solenberg | 04f4931 | 2015-06-08 13:04:56 +0200 | [diff] [blame] | 14 | #include <map> |
kwiberg | fffa42b | 2016-02-23 10:46:32 -0800 | [diff] [blame] | 15 | #include <memory> |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 16 | #include <string> |
| 17 | #include <vector> |
| 18 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 19 | #include "api/audio_codecs/audio_decoder_factory.h" |
| 20 | #include "api/call/transport.h" |
| 21 | #include "api/optional.h" |
| 22 | #include "api/rtpparameters.h" |
| 23 | #include "api/rtpreceiverinterface.h" |
| 24 | #include "call/rtp_config.h" |
Mirko Bonadei | 7120742 | 2017-09-15 13:58:09 +0200 | [diff] [blame] | 25 | #include "common_types.h" // NOLINT(build/include) |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 26 | #include "rtc_base/scoped_ref_ptr.h" |
Mirko Bonadei | 7120742 | 2017-09-15 13:58:09 +0200 | [diff] [blame] | 27 | #include "typedefs.h" // NOLINT(build/include) |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 28 | |
| 29 | namespace webrtc { |
Tommi | f888bb5 | 2015-12-12 01:37:01 +0100 | [diff] [blame] | 30 | class AudioSinkInterface; |
Fredrik Solenberg | 04f4931 | 2015-06-08 13:04:56 +0200 | [diff] [blame] | 31 | |
pbos | 1ba8d39 | 2016-05-01 20:18:34 -0700 | [diff] [blame] | 32 | class AudioReceiveStream { |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 33 | public: |
Fredrik Solenberg | 4f4ec0a | 2015-10-22 10:49:27 +0200 | [diff] [blame] | 34 | struct Stats { |
| 35 | uint32_t remote_ssrc = 0; |
| 36 | int64_t bytes_rcvd = 0; |
| 37 | uint32_t packets_rcvd = 0; |
| 38 | uint32_t packets_lost = 0; |
| 39 | float fraction_lost = 0.0f; |
| 40 | std::string codec_name; |
hbos | 1acfbd2 | 2016-11-17 23:43:29 -0800 | [diff] [blame] | 41 | rtc::Optional<int> codec_payload_type; |
Fredrik Solenberg | 4f4ec0a | 2015-10-22 10:49:27 +0200 | [diff] [blame] | 42 | uint32_t ext_seqnum = 0; |
| 43 | uint32_t jitter_ms = 0; |
| 44 | uint32_t jitter_buffer_ms = 0; |
| 45 | uint32_t jitter_buffer_preferred_ms = 0; |
| 46 | uint32_t delay_estimate_ms = 0; |
| 47 | int32_t audio_level = -1; |
Gustaf Ullberg | 9a2e906 | 2017-09-18 09:28:20 +0200 | [diff] [blame] | 48 | // Stats below correspond to similarly-named fields in the WebRTC stats |
| 49 | // spec. https://w3c.github.io/webrtc-stats/#dom-rtcmediastreamtrackstats |
zstein | e76bd3a | 2017-07-14 12:17:49 -0700 | [diff] [blame] | 50 | double total_output_energy = 0.0; |
Steve Anton | 2dbc69f | 2017-08-24 17:15:13 -0700 | [diff] [blame] | 51 | uint64_t total_samples_received = 0; |
zstein | e76bd3a | 2017-07-14 12:17:49 -0700 | [diff] [blame] | 52 | double total_output_duration = 0.0; |
Steve Anton | 2dbc69f | 2017-08-24 17:15:13 -0700 | [diff] [blame] | 53 | uint64_t concealed_samples = 0; |
Gustaf Ullberg | 9a2e906 | 2017-09-18 09:28:20 +0200 | [diff] [blame] | 54 | uint64_t concealment_events = 0; |
Gustaf Ullberg | b0a0207 | 2017-10-02 12:00:34 +0200 | [diff] [blame] | 55 | double jitter_buffer_delay_seconds = 0.0; |
Gustaf Ullberg | 9a2e906 | 2017-09-18 09:28:20 +0200 | [diff] [blame] | 56 | // Stats below DO NOT correspond directly to anything in the WebRTC stats |
Fredrik Solenberg | 4f4ec0a | 2015-10-22 10:49:27 +0200 | [diff] [blame] | 57 | float expand_rate = 0.0f; |
| 58 | float speech_expand_rate = 0.0f; |
| 59 | float secondary_decoded_rate = 0.0f; |
minyue-webrtc | 0e320ec | 2017-08-28 13:51:27 +0200 | [diff] [blame] | 60 | float secondary_discarded_rate = 0.0f; |
Fredrik Solenberg | 4f4ec0a | 2015-10-22 10:49:27 +0200 | [diff] [blame] | 61 | float accelerate_rate = 0.0f; |
| 62 | float preemptive_expand_rate = 0.0f; |
| 63 | int32_t decoding_calls_to_silence_generator = 0; |
| 64 | int32_t decoding_calls_to_neteq = 0; |
| 65 | int32_t decoding_normal = 0; |
| 66 | int32_t decoding_plc = 0; |
| 67 | int32_t decoding_cng = 0; |
| 68 | int32_t decoding_plc_cng = 0; |
henrik.lundin | 6348978 | 2016-09-20 01:47:12 -0700 | [diff] [blame] | 69 | int32_t decoding_muted_output = 0; |
Fredrik Solenberg | 4f4ec0a | 2015-10-22 10:49:27 +0200 | [diff] [blame] | 70 | int64_t capture_start_ntp_time_ms = 0; |
| 71 | }; |
Fredrik Solenberg | 04f4931 | 2015-06-08 13:04:56 +0200 | [diff] [blame] | 72 | |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 73 | struct Config { |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 74 | std::string ToString() const; |
| 75 | |
| 76 | // Receive-stream specific RTP settings. |
| 77 | struct Rtp { |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 78 | std::string ToString() const; |
| 79 | |
| 80 | // Synchronization source (stream identifier) to be received. |
Fredrik Solenberg | 04f4931 | 2015-06-08 13:04:56 +0200 | [diff] [blame] | 81 | uint32_t remote_ssrc = 0; |
| 82 | |
| 83 | // Sender SSRC used for sending RTCP (such as receiver reports). |
| 84 | uint32_t local_ssrc = 0; |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 85 | |
Stefan Holmer | 3842c5c | 2016-01-12 13:55:00 +0100 | [diff] [blame] | 86 | // Enable feedback for send side bandwidth estimation. |
| 87 | // See |
| 88 | // https://tools.ietf.org/html/draft-holmer-rmcat-transport-wide-cc-extensions |
| 89 | // for details. |
| 90 | bool transport_cc = false; |
| 91 | |
solenberg | 8189b02 | 2016-06-14 12:13:00 -0700 | [diff] [blame] | 92 | // See NackConfig for description. |
| 93 | NackConfig nack; |
| 94 | |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 95 | // RTP header extensions used for the received stream. |
| 96 | std::vector<RtpExtension> extensions; |
| 97 | } rtp; |
Fredrik Solenberg | 04f4931 | 2015-06-08 13:04:56 +0200 | [diff] [blame] | 98 | |
solenberg | cf18b34 | 2015-10-01 08:13:42 -0700 | [diff] [blame] | 99 | Transport* rtcp_send_transport = nullptr; |
| 100 | |
Fredrik Solenberg | 8f5787a | 2018-01-11 13:52:30 +0100 | [diff] [blame^] | 101 | // TODO(solenberg): Remove once clients don't use it anymore. |
pbos | 8fc7fa7 | 2015-07-15 08:02:58 -0700 | [diff] [blame] | 102 | int voe_channel_id = -1; |
| 103 | |
Fredrik Solenberg | 8f5787a | 2018-01-11 13:52:30 +0100 | [diff] [blame^] | 104 | // NetEq settings. |
| 105 | size_t jitter_buffer_max_packets = 50; |
| 106 | bool jitter_buffer_fast_accelerate = false; |
| 107 | |
pbos | 8fc7fa7 | 2015-07-15 08:02:58 -0700 | [diff] [blame] | 108 | // Identifier for an A/V synchronization group. Empty string to disable. |
| 109 | // TODO(pbos): Synchronize streams in a sync group, not just one video |
| 110 | // stream to one audio stream. Tracked by issue webrtc:4762. |
| 111 | std::string sync_group; |
| 112 | |
kwiberg | d32bf75 | 2017-01-19 07:03:59 -0800 | [diff] [blame] | 113 | // Decoder specifications for every payload type that we can receive. |
| 114 | std::map<int, SdpAudioFormat> decoder_map; |
ossu | 29b1a8d | 2016-06-13 07:34:51 -0700 | [diff] [blame] | 115 | |
| 116 | rtc::scoped_refptr<AudioDecoderFactory> decoder_factory; |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 117 | }; |
| 118 | |
Fredrik Solenberg | 3b903d0 | 2018-01-10 15:17:10 +0100 | [diff] [blame] | 119 | // Reconfigure the stream according to the Configuration. |
| 120 | virtual void Reconfigure(const Config& config) = 0; |
| 121 | |
pbos | 1ba8d39 | 2016-05-01 20:18:34 -0700 | [diff] [blame] | 122 | // Starts stream activity. |
| 123 | // When a stream is active, it can receive, process and deliver packets. |
| 124 | virtual void Start() = 0; |
| 125 | // Stops stream activity. |
| 126 | // When a stream is stopped, it can't receive, process or deliver packets. |
| 127 | virtual void Stop() = 0; |
| 128 | |
Fredrik Solenberg | 04f4931 | 2015-06-08 13:04:56 +0200 | [diff] [blame] | 129 | virtual Stats GetStats() const = 0; |
solenberg | 796b8f9 | 2017-03-01 17:02:23 -0800 | [diff] [blame] | 130 | // TODO(solenberg): Remove, once AudioMonitor is gone. |
| 131 | virtual int GetOutputLevel() const = 0; |
Tommi | f888bb5 | 2015-12-12 01:37:01 +0100 | [diff] [blame] | 132 | |
| 133 | // Sets an audio sink that receives unmixed audio from the receive stream. |
Fredrik Solenberg | 8f5787a | 2018-01-11 13:52:30 +0100 | [diff] [blame^] | 134 | // Ownership of the sink is managed by the caller. |
deadbeef | 884f585 | 2016-01-15 09:20:04 -0800 | [diff] [blame] | 135 | // Only one sink can be set and passing a null sink clears an existing one. |
Tommi | f888bb5 | 2015-12-12 01:37:01 +0100 | [diff] [blame] | 136 | // NOTE: Audio must still somehow be pulled through AudioTransport for audio |
| 137 | // to stream through this sink. In practice, this happens if mixed audio |
| 138 | // is being pulled+rendered and/or if audio is being pulled for the purposes |
| 139 | // of feeding to the AEC. |
Fredrik Solenberg | 8f5787a | 2018-01-11 13:52:30 +0100 | [diff] [blame^] | 140 | virtual void SetSink(AudioSinkInterface* sink) = 0; |
pbos | 1ba8d39 | 2016-05-01 20:18:34 -0700 | [diff] [blame] | 141 | |
solenberg | 217fb66 | 2016-06-17 08:30:54 -0700 | [diff] [blame] | 142 | // Sets playback gain of the stream, applied when mixing, and thus after it |
| 143 | // is potentially forwarded to any attached AudioSinkInterface implementation. |
| 144 | virtual void SetGain(float gain) = 0; |
| 145 | |
hbos | 8d609f6 | 2017-04-10 07:39:05 -0700 | [diff] [blame] | 146 | virtual std::vector<RtpSource> GetSources() const = 0; |
| 147 | |
pbos | 1ba8d39 | 2016-05-01 20:18:34 -0700 | [diff] [blame] | 148 | protected: |
| 149 | virtual ~AudioReceiveStream() {} |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 150 | }; |
Fredrik Solenberg | 23fba1f | 2015-04-29 15:24:01 +0200 | [diff] [blame] | 151 | } // namespace webrtc |
| 152 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 153 | #endif // CALL_AUDIO_RECEIVE_STREAM_H_ |