Adding OrtcFactory, and changing UdpTransport to match current plan.
The factory follows the same principles as PeerConnectionFactory;
various modules can be passed into its constructor but default
implementations are provided. Currently the only object the factory can
create is a UdpTransport (need to start somewhere).
UdpTransportChannel (renamed to UdpTransport)
will now accept a socket passed into its constructor,
relying on the factory to create the socket. This allows some
simplifications to be made, such as getting rid of "State" since the
only states are now "has destination set or doesn't".
BUG=webrtc:7013
Review-Url: https://codereview.webrtc.org/2632613002
Cr-Original-Commit-Position: refs/heads/master@{#16154}
Cr-Mirrored-From: https://chromium.googlesource.com/external/webrtc
Cr-Mirrored-Commit: d1c0998730443e4901ec329ee816fd1f115b6223
diff --git a/api/udptransportinterface.h b/api/udptransportinterface.h
new file mode 100644
index 0000000..1a28531
--- /dev/null
+++ b/api/udptransportinterface.h
@@ -0,0 +1,57 @@
+/*
+ * Copyright 2017 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_UDPTRANSPORTINTERFACE_H_
+#define WEBRTC_API_UDPTRANSPORTINTERFACE_H_
+
+#include "webrtc/api/proxy.h"
+#include "webrtc/base/socketaddress.h"
+
+namespace webrtc {
+
+// Interface for a raw UDP transport (not using ICE), meaning a combination of
+// a local/remote IP address/port.
+//
+// An instance can be instantiated using OrtcFactory.
+//
+// Each instance reserves a UDP port, which will be freed when the
+// UdpTransportInterface destructor is called.
+//
+// Calling SetRemoteAddress sets the destination of outgoing packets; without a
+// destination, packets can't be sent, but they can be received.
+class UdpTransportInterface {
+ public:
+ virtual ~UdpTransportInterface() {}
+
+ // Get the address of the socket allocated for this transport.
+ virtual rtc::SocketAddress GetLocalAddress() const = 0;
+
+ // Sets the address to which packets will be delivered.
+ //
+ // Calling with a "nil" (default-constructed) address is legal, and unsets
+ // any previously set destination.
+ //
+ // However, calling with an incomplete address (port or IP not set) will
+ // fail.
+ virtual bool SetRemoteAddress(const rtc::SocketAddress& dest) = 0;
+ // Simple getter. If never set, returns nil address.
+ virtual rtc::SocketAddress GetRemoteAddress() const = 0;
+};
+
+BEGIN_OWNED_PROXY_MAP(UdpTransport)
+ PROXY_WORKER_THREAD_DESTRUCTOR()
+ PROXY_WORKER_CONSTMETHOD0(rtc::SocketAddress, GetLocalAddress)
+ PROXY_WORKER_METHOD1(bool, SetRemoteAddress, const rtc::SocketAddress&)
+ PROXY_WORKER_CONSTMETHOD0(rtc::SocketAddress, GetRemoteAddress)
+END_PROXY_MAP()
+
+} // namespace webrtc
+
+#endif // WEBRTC_API_UDPTRANSPORTINTERFACE_H_
