MediaConduitControl.h

Enable keyboard shortcuts

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */

/* vim:set ts=2 sw=2 sts=2 et cindent: */

/* This Source Code Form is subject to the terms of the Mozilla Public

 * License, v. 2.0. If a copy of the MPL was not distributed with this file,

 * You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef DOM_MEDIA_WEBRTC_LIBWEBRTCGLUE_MEDIACONDUITCONTROL_H_

#define DOM_MEDIA_WEBRTC_LIBWEBRTCGLUE_MEDIACONDUITCONTROL_H_

#include "jsapi/RTCDTMFSender.h"  // For DtmfEvent

#include "mozilla/StateMirroring.h"

#include "RtpRtcpConfig.h"

#include <vector>

#include <string>

#include "mozilla/Maybe.h"

#include "CodecConfig.h"                   // For Audio/VideoCodecConfig

#include "api/rtp_parameters.h"            // For webrtc::RtpExtension

#include "api/video_codecs/video_codec.h"  // For webrtc::VideoCodecMode

#include "FrameTransformerProxy.h"

namespace mozilla {

using RtpExtList = std::vector<webrtc::RtpExtension>;

using Ssrc = uint32_t;

using Ssrcs = std::vector<uint32_t>;

/**

 * These are the interfaces used to control the async conduits. Some parameters

 * are common, and some are tied to the conduit type. See

 * MediaSessionConduit::InitConduitControl for how they are used.

 * Put simply, the implementer of the interfaces below may set its canonicals on

 * any thread, and the conduits will react to those changes accordingly, on

 * their dedicated worker thread. One instance of these interfaces could control

 * multiple conduits as each canonical can connect to any number of mirrors.

*/

class MediaConduitControlInterface {

 public:

  virtual Canonical<bool>& CanonicalReceiving() = 0;

  virtual Canonical<bool>& CanonicalTransmitting() = 0;

  virtual Canonical<Ssrcs>& CanonicalLocalSsrcs() = 0;

  virtual Canonical<std::string>& CanonicalLocalCname() = 0;

  virtual Canonical<std::string>& CanonicalMid() = 0;

  virtual Canonical<Ssrc>& CanonicalRemoteSsrc() = 0;

  virtual Canonical<std::string>& CanonicalSyncGroup() = 0;

  virtual Canonical<RtpExtList>& CanonicalLocalRecvRtpExtensions() = 0;

  virtual Canonical<RtpExtList>& CanonicalLocalSendRtpExtensions() = 0;

  virtual Canonical<RefPtr<FrameTransformerProxy>>&

  CanonicalFrameTransformerProxySend() = 0;

  virtual Canonical<RefPtr<FrameTransformerProxy>>&

  CanonicalFrameTransformerProxyRecv() = 0;

};

class AudioConduitControlInterface : public MediaConduitControlInterface {

 public:

  virtual Canonical<Maybe<AudioCodecConfig>>& CanonicalAudioSendCodec() = 0;

  virtual Canonical<std::vector<AudioCodecConfig>>&

  CanonicalAudioRecvCodecs() = 0;

  virtual MediaEventSource<DtmfEvent>& OnDtmfEvent() = 0;

};

class VideoConduitControlInterface : public MediaConduitControlInterface {

 public:

  virtual Canonical<Ssrcs>& CanonicalLocalVideoRtxSsrcs() = 0;

  virtual Canonical<Ssrc>& CanonicalRemoteVideoRtxSsrc() = 0;

  virtual Canonical<Maybe<VideoCodecConfig>>& CanonicalVideoSendCodec() = 0;

  virtual Canonical<Maybe<RtpRtcpConfig>>&

  CanonicalVideoSendRtpRtcpConfig() = 0;

  virtual Canonical<std::vector<VideoCodecConfig>>&

  CanonicalVideoRecvCodecs() = 0;

  virtual Canonical<Maybe<RtpRtcpConfig>>&

  CanonicalVideoRecvRtpRtcpConfig() = 0;

  virtual Canonical<webrtc::VideoCodecMode>& CanonicalVideoCodecMode() = 0;

};

}  // namespace mozilla

#endif