Source code
Revision control
Copy as Markdown
Other Tools
/* 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,
#ifndef _JSEPTRANSCEIVER_H_
#define _JSEPTRANSCEIVER_H_
#include <string>
#include "sdp/SdpAttribute.h"
#include "sdp/SdpMediaSection.h"
#include "sdp/Sdp.h"
#include "jsep/JsepTransport.h"
#include "jsep/JsepTrack.h"
#include "nsError.h"
namespace mozilla {
class JsepUuidGenerator {
public:
virtual ~JsepUuidGenerator() = default;
virtual bool Generate(std::string* id) = 0;
virtual JsepUuidGenerator* Clone() const = 0;
};
class JsepTransceiver {
public:
explicit JsepTransceiver(SdpMediaSection::MediaType type,
JsepUuidGenerator& aUuidGen,
SdpDirectionAttribute::Direction jsDirection =
SdpDirectionAttribute::kSendrecv)
: mJsDirection(jsDirection),
mSendTrack(type, sdp::kSend),
mRecvTrack(type, sdp::kRecv) {
if (!aUuidGen.Generate(&mUuid)) {
MOZ_CRASH();
}
}
JsepTransceiver(const JsepTransceiver& orig) = default;
JsepTransceiver(JsepTransceiver&& orig) = default;
JsepTransceiver& operator=(const JsepTransceiver& aRhs) = default;
JsepTransceiver& operator=(JsepTransceiver&& aRhs) = default;
~JsepTransceiver() = default;
void Rollback(JsepTransceiver& oldTransceiver, bool aRemote) {
MOZ_ASSERT(oldTransceiver.GetMediaType() == GetMediaType());
MOZ_ASSERT(!oldTransceiver.IsNegotiated() || !oldTransceiver.HasLevel() ||
!HasLevel() || oldTransceiver.GetLevel() == GetLevel());
mTransport = oldTransceiver.mTransport;
if (aRemote) {
mLevel = oldTransceiver.mLevel;
mBundleLevel = oldTransceiver.mBundleLevel;
mSendTrack = oldTransceiver.mSendTrack;
}
mRecvTrack = oldTransceiver.mRecvTrack;
// Don't allow rollback to re-associate a transceiver.
if (!oldTransceiver.IsAssociated()) {
Disassociate();
}
}
bool IsAssociated() const { return !mMid.empty(); }
const std::string& GetMid() const {
MOZ_ASSERT(IsAssociated());
return mMid;
}
void Associate(const std::string& mid) {
MOZ_ASSERT(HasLevel());
mMid = mid;
}
void Disassociate() { mMid.clear(); }
bool HasLevel() const { return mLevel != SIZE_MAX; }
void SetLevel(size_t level) {
MOZ_ASSERT(level != SIZE_MAX);
MOZ_ASSERT(!HasLevel());
MOZ_ASSERT(!IsStopped());
mLevel = level;
}
void ClearLevel() {
MOZ_ASSERT(!IsAssociated());
mLevel = SIZE_MAX;
mBundleLevel = SIZE_MAX;
}
size_t GetLevel() const {
MOZ_ASSERT(HasLevel());
return mLevel;
}
void Stop() { mStopping = true; }
bool IsStopping() const { return mStopping; }
bool IsStopped() const { return mStopped; }
void SetStopped() { mStopped = true; }
bool IsFreeToUse() const { return !mStopping && !mStopped && !HasLevel(); }
void RestartDatachannelTransceiver() {
MOZ_RELEASE_ASSERT(GetMediaType() == SdpMediaSection::kApplication);
mStopping = false;
mStopped = false;
mCanRecycleMyMsection = false;
}
void SetRemoved() { mRemoved = true; }
bool IsRemoved() const { return mRemoved; }
bool HasBundleLevel() const { return mBundleLevel != SIZE_MAX; }
size_t BundleLevel() const {
MOZ_ASSERT(HasBundleLevel());
return mBundleLevel;
}
void SetBundleLevel(size_t aBundleLevel) {
MOZ_ASSERT(aBundleLevel != SIZE_MAX);
mBundleLevel = aBundleLevel;
}
void ClearBundleLevel() { mBundleLevel = SIZE_MAX; }
size_t GetTransportLevel() const {
MOZ_ASSERT(HasLevel());
if (HasBundleLevel()) {
return BundleLevel();
}
return GetLevel();
}
void SetAddTrackMagic() { mAddTrackMagic = true; }
bool HasAddTrackMagic() const { return mAddTrackMagic; }
void SetOnlyExistsBecauseOfSetRemote(bool aValue) {
mOnlyExistsBecauseOfSetRemote = aValue;
}
bool OnlyExistsBecauseOfSetRemote() const {
return mOnlyExistsBecauseOfSetRemote;
}
void SetNegotiated() {
MOZ_ASSERT(IsAssociated());
MOZ_ASSERT(HasLevel());
mNegotiated = true;
}
bool IsNegotiated() const { return mNegotiated; }
void SetCanRecycleMyMsection() { mCanRecycleMyMsection = true; }
bool CanRecycleMyMsection() const { return mCanRecycleMyMsection; }
const std::string& GetUuid() const { return mUuid; }
// Convenience function
SdpMediaSection::MediaType GetMediaType() const {
MOZ_ASSERT(mRecvTrack.GetMediaType() == mSendTrack.GetMediaType());
return mRecvTrack.GetMediaType();
}
bool HasTransport() const { return mTransport.mComponents != 0; }
bool HasOwnTransport() const {
if (HasTransport() &&
(!HasBundleLevel() || (GetLevel() == BundleLevel()))) {
return true;
}
return false;
}
void SetRtxIsAllowed(bool aRtxIsAllowed) {
mSendTrack.SetRtxIsAllowed(aRtxIsAllowed);
mRecvTrack.SetRtxIsAllowed(aRtxIsAllowed);
}
// This is the direction JS wants. It might not actually happen.
SdpDirectionAttribute::Direction mJsDirection;
JsepTrack mSendTrack;
JsepTrack mRecvTrack;
JsepTransport mTransport;
private:
std::string mUuid;
// Stuff that is not negotiated
std::string mMid;
size_t mLevel = SIZE_MAX; // SIZE_MAX if no level
// Is this track pair sharing a transport with another?
size_t mBundleLevel = SIZE_MAX; // SIZE_MAX if no bundle level
// The w3c and IETF specs have a lot of "magical" behavior that happens
// when addTrack is used to create a transceiver. This was a deliberate
// design choice. Sadface.
bool mAddTrackMagic = false;
bool mOnlyExistsBecauseOfSetRemote = false;
bool mStopping = false;
bool mStopped = false;
bool mRemoved = false;
bool mNegotiated = false;
bool mCanRecycleMyMsection = false;
};
} // namespace mozilla
#endif // _JSEPTRANSCEIVER_H_