This code looked a bit weird before this CL - probably because of old refactorings. In JsepTransport constructor, there is a DCHECK assuring that the RTP DTLS transport is always present, so it can be passed directly to the SctpTransport constructor, which avoids having the SetDtlsTransport method in it. Also, in the SctpTransport constructor, there was code that would set the SCTP transport state to `kConnecting` if the DTLS transport was present, but that was dead code, as it was always `nullptr` inside the constructor before this CL. With this CL, it's always present, and the SCTP Transport's state will initially always be `kConnecting` now. Which is a step to deprecating the `kNew` state that doesn't exist in https://w3c.github.io/webrtc-pc/#dom-rtcsctptransportstate. One test case was modified, as it didn't test the reality. The test created a SctpTransport, registered an observer, and added the DTLS transport, and expected to receive a "statechange" from `kNew` (which is not a state that exists in the spec) to `kConnecting`. If the test had tested the opposite ordering - adding the DTLS transport first, and then adding an observer, it wouldn't have experienced this. And since in reality (with the implementation of JsepTransport before and after this CL), it always adds the DTLS transport before any observer is registered. So it wouldn't ever be fired, outside of tests. Bug: webrtc:15897 Change-Id: I6ac24e0a331b686eb400fcf388ece50f2ad46a32 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/345420 Commit-Queue: Victor Boivie <boivie@webrtc.org> Reviewed-by: Harald Alvestrand <hta@webrtc.org> Cr-Commit-Position: refs/heads/main@{#41987}
104 lines
3.9 KiB
C++
104 lines
3.9 KiB
C++
/*
|
|
* Copyright 2019 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 PC_SCTP_TRANSPORT_H_
|
|
#define PC_SCTP_TRANSPORT_H_
|
|
|
|
#include <memory>
|
|
|
|
#include "api/dtls_transport_interface.h"
|
|
#include "api/scoped_refptr.h"
|
|
#include "api/sctp_transport_interface.h"
|
|
#include "api/sequence_checker.h"
|
|
#include "api/transport/data_channel_transport_interface.h"
|
|
#include "media/sctp/sctp_transport_internal.h"
|
|
#include "p2p/base/dtls_transport_internal.h"
|
|
#include "pc/dtls_transport.h"
|
|
#include "rtc_base/checks.h"
|
|
#include "rtc_base/thread.h"
|
|
#include "rtc_base/thread_annotations.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// This implementation wraps a cricket::SctpTransport, and takes
|
|
// ownership of it.
|
|
// This object must be constructed and updated on the networking thread,
|
|
// the same thread as the one the cricket::SctpTransportInternal object
|
|
// lives on.
|
|
class SctpTransport : public SctpTransportInterface,
|
|
public DataChannelTransportInterface {
|
|
public:
|
|
SctpTransport(std::unique_ptr<cricket::SctpTransportInternal> internal,
|
|
rtc::scoped_refptr<DtlsTransport> dtls_transport);
|
|
|
|
// SctpTransportInterface
|
|
rtc::scoped_refptr<DtlsTransportInterface> dtls_transport() const override;
|
|
SctpTransportInformation Information() const override;
|
|
void RegisterObserver(SctpTransportObserverInterface* observer) override;
|
|
void UnregisterObserver() override;
|
|
|
|
// DataChannelTransportInterface
|
|
RTCError OpenChannel(int channel_id) override;
|
|
RTCError SendData(int channel_id,
|
|
const SendDataParams& params,
|
|
const rtc::CopyOnWriteBuffer& buffer) override;
|
|
RTCError CloseChannel(int channel_id) override;
|
|
void SetDataSink(DataChannelSink* sink) override;
|
|
bool IsReadyToSend() const override;
|
|
size_t buffered_amount(int channel_id) const override;
|
|
size_t buffered_amount_low_threshold(int channel_id) const override;
|
|
void SetBufferedAmountLowThreshold(int channel_id, size_t bytes) override;
|
|
|
|
// Internal functions
|
|
void Clear();
|
|
// Initialize the cricket::SctpTransport. This can be called from
|
|
// the signaling thread.
|
|
void Start(int local_port, int remote_port, int max_message_size);
|
|
|
|
// TODO(https://bugs.webrtc.org/10629): Move functions that need
|
|
// internal() to be functions on the SctpTransport interface,
|
|
// and make the internal() function private.
|
|
cricket::SctpTransportInternal* internal() {
|
|
RTC_DCHECK_RUN_ON(owner_thread_);
|
|
return internal_sctp_transport_.get();
|
|
}
|
|
|
|
const cricket::SctpTransportInternal* internal() const {
|
|
RTC_DCHECK_RUN_ON(owner_thread_);
|
|
return internal_sctp_transport_.get();
|
|
}
|
|
|
|
protected:
|
|
~SctpTransport() override;
|
|
|
|
private:
|
|
void UpdateInformation(SctpTransportState state);
|
|
void OnInternalReadyToSendData();
|
|
void OnAssociationChangeCommunicationUp();
|
|
void OnInternalClosingProcedureStartedRemotely(int sid);
|
|
void OnInternalClosingProcedureComplete(int sid);
|
|
void OnDtlsStateChange(cricket::DtlsTransportInternal* transport,
|
|
DtlsTransportState state);
|
|
|
|
// NOTE: `owner_thread_` is the thread that the SctpTransport object is
|
|
// constructed on. In the context of PeerConnection, it's the network thread.
|
|
rtc::Thread* const owner_thread_;
|
|
SctpTransportInformation info_ RTC_GUARDED_BY(owner_thread_);
|
|
std::unique_ptr<cricket::SctpTransportInternal> internal_sctp_transport_
|
|
RTC_GUARDED_BY(owner_thread_);
|
|
SctpTransportObserverInterface* observer_ RTC_GUARDED_BY(owner_thread_) =
|
|
nullptr;
|
|
rtc::scoped_refptr<DtlsTransport> dtls_transport_
|
|
RTC_GUARDED_BY(owner_thread_);
|
|
};
|
|
|
|
} // namespace webrtc
|
|
#endif // PC_SCTP_TRANSPORT_H_
|