db0cd9e774
This is similar to how a "receive" method is used to apply RtpParameters to an RtpReceiver in ORTC. Currently, SetParameters doesn't allow changing the parameters, so the main use of the API is to retrieve the set of configured codecs. But other uses will likely be made possible in the future. R=glaznev@webrtc.org, pthatcher@webrtc.org, tkchin@webrtc.org Review URL: https://codereview.webrtc.org/1917193008 . Cr-Commit-Position: refs/heads/master@{#12761}
112 lines
4.0 KiB
C++
112 lines
4.0 KiB
C++
/*
|
|
* Copyright 2012 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef WEBRTC_API_MEDIASTREAMPROVIDER_H_
|
|
#define WEBRTC_API_MEDIASTREAMPROVIDER_H_
|
|
|
|
#include <memory>
|
|
|
|
#include "webrtc/api/rtpsenderinterface.h"
|
|
#include "webrtc/base/basictypes.h"
|
|
#include "webrtc/media/base/videosinkinterface.h"
|
|
#include "webrtc/media/base/videosourceinterface.h"
|
|
|
|
namespace cricket {
|
|
|
|
class AudioSource;
|
|
class VideoFrame;
|
|
struct AudioOptions;
|
|
struct VideoOptions;
|
|
|
|
} // namespace cricket
|
|
|
|
namespace webrtc {
|
|
|
|
class AudioSinkInterface;
|
|
|
|
// TODO(deadbeef): Change the key from an ssrc to a "sender_id" or
|
|
// "receiver_id" string, which will be the MSID in the short term and MID in
|
|
// the long term.
|
|
|
|
// TODO(deadbeef): These interfaces are effectively just a way for the
|
|
// RtpSenders/Receivers to get to the BaseChannels. These interfaces should be
|
|
// refactored away eventually, as the classes converge.
|
|
|
|
// This interface is called by AudioRtpSender/Receivers to change the settings
|
|
// of an audio track connected to certain PeerConnection.
|
|
class AudioProviderInterface {
|
|
public:
|
|
// Enable/disable the audio playout of a remote audio track with |ssrc|.
|
|
virtual void SetAudioPlayout(uint32_t ssrc, bool enable) = 0;
|
|
// Enable/disable sending audio on the local audio track with |ssrc|.
|
|
// When |enable| is true |options| should be applied to the audio track.
|
|
virtual void SetAudioSend(uint32_t ssrc,
|
|
bool enable,
|
|
const cricket::AudioOptions& options,
|
|
cricket::AudioSource* source) = 0;
|
|
|
|
// Sets the audio playout volume of a remote audio track with |ssrc|.
|
|
// |volume| is in the range of [0, 10].
|
|
virtual void SetAudioPlayoutVolume(uint32_t ssrc, double volume) = 0;
|
|
|
|
// Allows for setting a direct audio sink for an incoming audio source.
|
|
// Only one audio sink is supported per ssrc and ownership of the sink is
|
|
// passed to the provider.
|
|
virtual void SetRawAudioSink(
|
|
uint32_t ssrc,
|
|
std::unique_ptr<webrtc::AudioSinkInterface> sink) = 0;
|
|
|
|
virtual RtpParameters GetAudioRtpSendParameters(uint32_t ssrc) const = 0;
|
|
virtual bool SetAudioRtpSendParameters(uint32_t ssrc,
|
|
const RtpParameters& parameters) = 0;
|
|
|
|
virtual RtpParameters GetAudioRtpReceiveParameters(uint32_t ssrc) const = 0;
|
|
virtual bool SetAudioRtpReceiveParameters(
|
|
uint32_t ssrc,
|
|
const RtpParameters& parameters) = 0;
|
|
|
|
protected:
|
|
virtual ~AudioProviderInterface() {}
|
|
};
|
|
|
|
// This interface is called by VideoRtpSender/Receivers to change the settings
|
|
// of a video track connected to a certain PeerConnection.
|
|
class VideoProviderInterface {
|
|
public:
|
|
virtual bool SetSource(
|
|
uint32_t ssrc,
|
|
rtc::VideoSourceInterface<cricket::VideoFrame>* source) = 0;
|
|
// Enable/disable the video playout of a remote video track with |ssrc|.
|
|
virtual void SetVideoPlayout(
|
|
uint32_t ssrc,
|
|
bool enable,
|
|
rtc::VideoSinkInterface<cricket::VideoFrame>* sink) = 0;
|
|
// Enable sending video on the local video track with |ssrc|.
|
|
virtual void SetVideoSend(uint32_t ssrc,
|
|
bool enable,
|
|
const cricket::VideoOptions* options) = 0;
|
|
|
|
virtual RtpParameters GetVideoRtpSendParameters(uint32_t ssrc) const = 0;
|
|
virtual bool SetVideoRtpSendParameters(uint32_t ssrc,
|
|
const RtpParameters& parameters) = 0;
|
|
|
|
virtual RtpParameters GetVideoRtpReceiveParameters(uint32_t ssrc) const = 0;
|
|
virtual bool SetVideoRtpReceiveParameters(
|
|
uint32_t ssrc,
|
|
const RtpParameters& parameters) = 0;
|
|
|
|
protected:
|
|
virtual ~VideoProviderInterface() {}
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // WEBRTC_API_MEDIASTREAMPROVIDER_H_
|