1 /*
2  *  Copyright 2018 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 PC_CHANNEL_INTERFACE_H_
12 #define PC_CHANNEL_INTERFACE_H_
13 
14 #include <string>
15 #include <vector>
16 
17 #include "api/jsep.h"
18 #include "api/media_types.h"
19 #include "media/base/media_channel.h"
20 #include "pc/rtp_transport_internal.h"
21 
22 namespace cricket {
23 
24 class MediaContentDescription;
25 
26 // ChannelInterface contains methods common to voice, video and data channels.
27 // As more methods are added to BaseChannel, they should be included in the
28 // interface as well.
29 class ChannelInterface {
30  public:
31   virtual cricket::MediaType media_type() const = 0;
32 
33   virtual MediaChannel* media_channel() const = 0;
34 
35   // TODO(deadbeef): This is redundant; remove this.
36   virtual const std::string& transport_name() const = 0;
37 
38   virtual const std::string& content_name() const = 0;
39 
40   virtual bool enabled() const = 0;
41 
42   // Enables or disables this channel
43   virtual bool Enable(bool enable) = 0;
44 
45   // Used for latency measurements.
46   virtual sigslot::signal1<ChannelInterface*>& SignalFirstPacketReceived() = 0;
47 
48   // Channel control
49   virtual bool SetLocalContent(const MediaContentDescription* content,
50                                webrtc::SdpType type,
51                                std::string* error_desc) = 0;
52   virtual bool SetRemoteContent(const MediaContentDescription* content,
53                                 webrtc::SdpType type,
54                                 std::string* error_desc) = 0;
55   virtual bool SetPayloadTypeDemuxingEnabled(bool enabled) = 0;
56 
57   // Access to the local and remote streams that were set on the channel.
58   virtual const std::vector<StreamParams>& local_streams() const = 0;
59   virtual const std::vector<StreamParams>& remote_streams() const = 0;
60 
61   // Set an RTP level transport.
62   // Some examples:
63   //   * An RtpTransport without encryption.
64   //   * An SrtpTransport for SDES.
65   //   * A DtlsSrtpTransport for DTLS-SRTP.
66   virtual bool SetRtpTransport(webrtc::RtpTransportInternal* rtp_transport) = 0;
67 
68  protected:
69   virtual ~ChannelInterface() = default;
70 };
71 
72 }  // namespace cricket
73 
74 #endif  // PC_CHANNEL_INTERFACE_H_
75