2018-10-08 11:13:58 +02:00
|
|
|
/*
|
|
|
|
|
* Copyright 2018 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.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
// This is EXPERIMENTAL interface for media transport.
|
|
|
|
|
//
|
|
|
|
|
// The goal is to refactor WebRTC code so that audio and video frames
|
|
|
|
|
// are sent / received through the media transport interface. This will
|
|
|
|
|
// enable different media transport implementations, including QUIC-based
|
|
|
|
|
// media transport.
|
|
|
|
|
|
|
|
|
|
#include "api/media_transport_interface.h"
|
|
|
|
|
|
2018-10-23 12:03:01 +02:00
|
|
|
#include <cstdint>
|
|
|
|
|
#include <utility>
|
|
|
|
|
|
2018-10-08 11:13:58 +02:00
|
|
|
namespace webrtc {
|
|
|
|
|
|
2018-10-29 07:31:42 -07:00
|
|
|
MediaTransportSettings::MediaTransportSettings() = default;
|
2018-10-29 10:43:16 -07:00
|
|
|
MediaTransportSettings::MediaTransportSettings(const MediaTransportSettings&) =
|
|
|
|
|
default;
|
|
|
|
|
MediaTransportSettings& MediaTransportSettings::operator=(
|
|
|
|
|
const MediaTransportSettings&) = default;
|
2018-10-29 07:31:42 -07:00
|
|
|
MediaTransportSettings::~MediaTransportSettings() = default;
|
|
|
|
|
|
2018-10-08 09:43:21 -07:00
|
|
|
|
Add interfaces for using MediaTransport as the transport for data channels.
Adds the types and methods required for sending and receiving data
channel messages over the media transport. These are:
- A DataMessageType to distinguish between text, binary, and control
messages
- A parameters struct for sending data messages, which specifies the
channel id, type, and ordering/reliability parameters
- A sink for data-channel related callbacks (receive data, begin
closing procedure, and end closing procedure)
- A method to set the sink for data channels
- Methods to open, close, and send on data channels
These methods, combined with the state sink, allow PeerConnection to
implement the DataChannelProviderInterface using MediaTransport as the
underlying transport.
Change-Id: Iccb2ba374594762a5b4f995564e2a1ff7d8805f5
Bug: webrtc:9719
Reviewed-on: https://webrtc-review.googlesource.com/c/108541
Reviewed-by: Anton Sukhanov <sukhanov@webrtc.org>
Reviewed-by: Niels Moller <nisse@webrtc.org>
Reviewed-by: Seth Hampson <shampson@webrtc.org>
Reviewed-by: Peter Slatala <psla@webrtc.org>
Commit-Queue: Bjorn Mellem <mellem@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#25454}
2018-10-30 15:15:00 -07:00
|
|
|
SendDataParams::SendDataParams() = default;
|
2018-11-30 09:35:52 +01:00
|
|
|
SendDataParams::SendDataParams(const SendDataParams&) = default;
|
Add interfaces for using MediaTransport as the transport for data channels.
Adds the types and methods required for sending and receiving data
channel messages over the media transport. These are:
- A DataMessageType to distinguish between text, binary, and control
messages
- A parameters struct for sending data messages, which specifies the
channel id, type, and ordering/reliability parameters
- A sink for data-channel related callbacks (receive data, begin
closing procedure, and end closing procedure)
- A method to set the sink for data channels
- Methods to open, close, and send on data channels
These methods, combined with the state sink, allow PeerConnection to
implement the DataChannelProviderInterface using MediaTransport as the
underlying transport.
Change-Id: Iccb2ba374594762a5b4f995564e2a1ff7d8805f5
Bug: webrtc:9719
Reviewed-on: https://webrtc-review.googlesource.com/c/108541
Reviewed-by: Anton Sukhanov <sukhanov@webrtc.org>
Reviewed-by: Niels Moller <nisse@webrtc.org>
Reviewed-by: Seth Hampson <shampson@webrtc.org>
Reviewed-by: Peter Slatala <psla@webrtc.org>
Commit-Queue: Bjorn Mellem <mellem@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#25454}
2018-10-30 15:15:00 -07:00
|
|
|
|
2018-10-29 07:31:42 -07:00
|
|
|
RTCErrorOr<std::unique_ptr<MediaTransportInterface>>
|
|
|
|
|
MediaTransportFactory::CreateMediaTransport(
|
|
|
|
|
rtc::PacketTransportInternal* packet_transport,
|
|
|
|
|
rtc::Thread* network_thread,
|
|
|
|
|
bool is_caller) {
|
2018-10-29 10:43:16 -07:00
|
|
|
MediaTransportSettings settings;
|
|
|
|
|
settings.is_caller = is_caller;
|
|
|
|
|
return CreateMediaTransport(packet_transport, network_thread, settings);
|
2018-10-29 07:31:42 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
RTCErrorOr<std::unique_ptr<MediaTransportInterface>>
|
|
|
|
|
MediaTransportFactory::CreateMediaTransport(
|
|
|
|
|
rtc::PacketTransportInternal* packet_transport,
|
|
|
|
|
rtc::Thread* network_thread,
|
2018-10-29 10:43:16 -07:00
|
|
|
const MediaTransportSettings& settings) {
|
2018-10-29 07:31:42 -07:00
|
|
|
return std::unique_ptr<MediaTransportInterface>(nullptr);
|
|
|
|
|
}
|
|
|
|
|
|
2019-01-15 14:24:34 -08:00
|
|
|
MediaTransportInterface::MediaTransportInterface() = default;
|
|
|
|
|
MediaTransportInterface::~MediaTransportInterface() = default;
|
|
|
|
|
|
2018-12-10 11:06:02 +01:00
|
|
|
void MediaTransportInterface::SetKeyFrameRequestCallback(
|
|
|
|
|
MediaTransportKeyFrameRequestCallback* callback) {}
|
|
|
|
|
|
2018-11-08 07:43:31 -08:00
|
|
|
absl::optional<TargetTransferRate>
|
|
|
|
|
MediaTransportInterface::GetLatestTargetTransferRate() {
|
|
|
|
|
return absl::nullopt;
|
|
|
|
|
}
|
|
|
|
|
|
2019-02-05 00:59:35 +01:00
|
|
|
void MediaTransportInterface::AddNetworkChangeCallback(
|
|
|
|
|
MediaTransportNetworkChangeCallback* callback) {}
|
|
|
|
|
|
|
|
|
|
void MediaTransportInterface::RemoveNetworkChangeCallback(
|
|
|
|
|
MediaTransportNetworkChangeCallback* callback) {}
|
|
|
|
|
|
2019-01-15 14:24:34 -08:00
|
|
|
void MediaTransportInterface::SetFirstAudioPacketReceivedObserver(
|
|
|
|
|
AudioPacketReceivedObserver* observer) {}
|
|
|
|
|
|
2019-01-07 15:54:47 +01:00
|
|
|
void MediaTransportInterface::AddTargetTransferRateObserver(
|
|
|
|
|
TargetTransferRateObserver* observer) {}
|
2018-11-08 07:43:31 -08:00
|
|
|
void MediaTransportInterface::RemoveTargetTransferRateObserver(
|
2019-01-07 15:54:47 +01:00
|
|
|
TargetTransferRateObserver* observer) {}
|
2018-11-08 07:43:31 -08:00
|
|
|
|
2019-01-07 15:54:47 +01:00
|
|
|
void MediaTransportInterface::AddRttObserver(
|
|
|
|
|
MediaTransportRttObserver* observer) {}
|
|
|
|
|
void MediaTransportInterface::RemoveRttObserver(
|
|
|
|
|
MediaTransportRttObserver* observer) {}
|
2018-11-08 07:43:31 -08:00
|
|
|
|
|
|
|
|
size_t MediaTransportInterface::GetAudioPacketOverhead() const {
|
|
|
|
|
return 0;
|
|
|
|
|
}
|
|
|
|
|
|
2019-01-28 06:50:38 -08:00
|
|
|
void MediaTransportInterface::SetAllocatedBitrateLimits(
|
|
|
|
|
const MediaTransportAllocatedBitrateLimits& limits) {}
|
|
|
|
|
|
2019-02-22 10:31:48 -08:00
|
|
|
// TODO(mellem): Delete when all implementations support it.
|
|
|
|
|
RTCError MediaTransportInterface::OpenChannel(int channel_id) {
|
|
|
|
|
// NB: This must return OK to avoid breaking existing implementations, which
|
|
|
|
|
// do not require calling OpenChannel.
|
|
|
|
|
return RTCError::OK();
|
|
|
|
|
}
|
|
|
|
|
|
2018-10-08 11:13:58 +02:00
|
|
|
} // namespace webrtc
|