Files
screen_cast/include/screencast/network/signaling.h
T
fegger 7be8d59d07 feat(network): implement Phase 6 LAN discovery and session signaling
Add mDNS/DNS-SD discovery and JSON session negotiation so two peers on
a LAN connect without hard-coded addresses.

- Discovery (Avahi threaded-poll client): the receiver announces
  _screencast._tcp with its signaling port; senders browse and resolve
  peers. Strict lock ordering (poll lock before state mutex) keeps the
  callbacks deadlock-free; name collisions rename via
  avahi_alternative_service_name.
- Signaling: one JSON object per newline-terminated TCP line. The
  receiver hosts a server (port 5005) and answers session offers with
  its RTP port; senders connect, offer, and stream to the negotiated
  endpoint. WebSocket was deferred: no WS library is installed, the
  skill permits plain TCP, and the wire format is transport-agnostic.
- Dual-stack transports: this machine resolves its own services over
  IPv6, so getaddrinfo now runs AF_UNSPEC and listeners bind IPv6 with
  IPV6_V6ONLY=0 (IPv4 fallback), covering UDP and TCP alike. The
  signaling client shutdown now uses shutdown() so a reader blocked in
  recv() cannot hang the join (a plain close() does not wake it).
- CLI: --discover lists receivers (deduped to one entry per host);
  --send auto-disovers when exactly one receiver is found; --peer
  targets a receiver directly; --signaling-port overrides the default.

Validation: meson test 5/5 (new signaling round-trip test), valgrind
clean. End-to-end over loopback: --discover finds the announced
receiver, a probe negotiated a session and streamed 60 frames over
both IPv4 and IPv6, and the receiver reported stream started. mDNS
resolution was verified against avahi-browse as an independent
reference.
2026-09-07 12:16:34 +02:00

59 lines
1.8 KiB
C++

#pragma once
#include "screencast/network/error.h"
#include "screencast/network/transport.h"
#include <cstdint>
#include <functional>
#include <memory>
#include <string>
#include <variant>
namespace sc {
// JSON-based control messages exchanged before or during a session. The wire
// format is one JSON object per newline-terminated TCP line; a WebSocket
// transport can replace TCP in a later phase without changing these types.
struct SessionOffer {
std::string session_id;
std::string codec_name;
int width = 0; // informational; the stream carries its own SPS/PPS
int height = 0;
int frame_rate_num = 30;
int frame_rate_den = 1;
Endpoint rtp_endpoint; // unused by the receiver; kept for symmetry
};
struct SessionAnswer {
std::string session_id;
// The address may be empty: the sender then targets the address of its
// signaling connection and the port carried here.
Endpoint rtp_endpoint;
};
using SignalingMessage = std::variant<SessionOffer, SessionAnswer>;
class SignalingChannel {
public:
using MessageCallback = std::function<void(const SignalingMessage&)>;
virtual ~SignalingChannel() = default;
// Client channels connect to a receiver's signaling server.
virtual bool connect(const Endpoint& server) = 0;
virtual void send(const SignalingMessage& message) = 0;
virtual void on_message(MessageCallback callback) = 0;
virtual void disconnect() = 0;
};
class SignalingFactory {
public:
// A client channel that connects to a receiver's signaling server.
static NetworkResult<std::unique_ptr<SignalingChannel>> create_client();
// A server channel listening on the given port; it keeps the most
// recent connection as its active peer.
static NetworkResult<std::unique_ptr<SignalingChannel>> create_server(uint16_t port);
};
} // namespace sc