webrtc.h File Reference

Client-side WebRTC signaling callback implementations. More...

Go to the source code of this file.

Functions
webrtc_signaling_callbacks_t	webrtc_get_signaling_callbacks (void)
	Get signaling callbacks for WebRTC peer manager.
void	webrtc_set_acds_transport (acip_transport_t *transport)
	Set the ACDS transport for signaling callbacks.
void	webrtc_set_session_context (const uint8_t session_id[16], const uint8_t participant_id[16])
	Set session and participant IDs for signaling.
void	webrtc_set_transport (acip_transport_t *transport)
	Set the WebRTC data channel transport.
acip_transport_t *	webrtc_get_transport (void)
	Get the current WebRTC data channel transport.
void	webrtc_cleanup_transport (void)
	Cleanup and release the WebRTC data channel transport.

Detailed Description

Client-side WebRTC signaling callback implementations.

Provides callback functions for sending SDP/ICE via ACDS when the peer manager generates local descriptions and candidates. These callbacks bridge the peer manager to the ACDS TCP connection.

INTEGRATION POINTS:

• webrtc_peer_manager: Calls these callbacks when generating local SDP/ICE
• ACDS connection: These callbacks send ACIP packets via ACDS TCP transport
• client/main.c: Initializes peer manager with these callbacks

LIFECYCLE:

1. Client joins ACDS session (gets session_id, participant_id)
2. Client initializes peer manager with these callbacks
3. Peer manager generates local SDP/ICE
4. Callbacks send SDP/ICE to ACDS server for relay to remote peers
5. ACDS relays messages to target participants

Author

Zachary Fogg me@zf.nosp@m.o.gg

Date

January 2026

Definition in file client/webrtc.h.

Function Documentation

webrtc_cleanup_transport()

void webrtc_cleanup_transport

(

void

)

Cleanup and release the WebRTC data channel transport.

Clears the WebRTC transport. Called on disconnect or fallback.

Note

Thread-safe - uses internal mutex protection

Actual transport cleanup (closing connections, freeing resources) should be done by caller before calling this

Closes and releases the WebRTC transport. Called when disconnecting or falling back to a different transport type.

Note

This is a convenience function that sets transport to NULL

Actual transport cleanup (closing sockets, freeing peer manager) should be done by the caller before calling this

Definition at line 365 of file src/client/webrtc.c.

                                    {
  ensure_mutex_initialized();
  mutex_lock(&g_signaling_mutex);
 
  if (g_webrtc_transport) {
    log_debug("Cleaning up WebRTC data channel transport");
    g_webrtc_transport = NULL;
  }
 
  mutex_unlock(&g_signaling_mutex);
}

webrtc_get_signaling_callbacks()

webrtc_signaling_callbacks_t webrtc_get_signaling_callbacks

(

void

)

Get signaling callbacks for WebRTC peer manager.

Returns a structure containing callback functions that send SDP/ICE via the ACDS TCP connection. The callbacks are stateless - they use the global ACDS transport to send signaling messages.

Returns

Signaling callbacks structure (valid until program exit)

Note

The returned structure points to static callbacks, safe to use for the lifetime of the peer manager.

Callbacks will fail if ACDS connection is not active.

Definition at line 265 of file src/client/webrtc.c.

                                                                  {
  ensure_mutex_initialized();
 
  webrtc_signaling_callbacks_t callbacks = {
      .send_sdp = client_send_sdp, .send_ice = client_send_ice, .user_data = NULL};
 
  return callbacks;
}

webrtc_get_transport()

acip_transport_t * webrtc_get_transport

(

void

)

Get the current WebRTC data channel transport.

Retrieves the active WebRTC transport for peer-to-peer communication.

Returns

Current WebRTC transport pointer (NULL if not set)

Note

Thread-safe - uses internal mutex protection

Pointer is valid only until webrtc_set_transport(NULL) is called

Retrieves the active WebRTC transport for peer-to-peer communication.

Returns

Current WebRTC transport pointer (NULL if not set)

Note

Caller must not free the returned pointer

Pointer is valid only until webrtc_set_transport(NULL) is called

Definition at line 344 of file src/client/webrtc.c.

                                             {
  ensure_mutex_initialized();
  mutex_lock(&g_signaling_mutex);
 
  acip_transport_t *transport = g_webrtc_transport;
 
  mutex_unlock(&g_signaling_mutex);
 
  return transport;
}

webrtc_set_acds_transport()

void webrtc_set_acds_transport

(

acip_transport_t *

transport

)

Set the ACDS transport for signaling callbacks.

Configures the transport that will be used to send SDP/ICE messages. Must be called before peer manager generates any local descriptions.

Parameters

transport

ACDS TCP transport (NULL to clear)

Note

This is called automatically when connecting to ACDS.

Callbacks will fail with ERROR_INVALID_STATE if transport is NULL.

Definition at line 274 of file src/client/webrtc.c.

                                                            {
  ensure_mutex_initialized();
  mutex_lock(&g_signaling_mutex);
 
  g_acds_transport = transport;
 
  if (transport) {
    log_debug("ACDS transport set for WebRTC signaling");
  } else {
    log_debug("ACDS transport cleared for WebRTC signaling");
  }
 
  mutex_unlock(&g_signaling_mutex);
}

webrtc_set_session_context()

void webrtc_set_session_context	(	const uint8_t	session_id[16],
		const uint8_t	participant_id[16]
	)

Set session and participant IDs for signaling.

Configures the session context used when sending SDP/ICE messages. Must be called after successful ACDS session join.

Parameters

session_id	Session UUID (16 bytes, copied)
participant_id	Local participant UUID (16 bytes, copied)

Note

This is called automatically when joining ACDS session.

Callbacks will fail with ERROR_INVALID_STATE if IDs are not set.

Definition at line 289 of file src/client/webrtc.c.

                                                                                                {
  if (!session_id || !participant_id) {
    log_error("Invalid session context parameters");
    return;
  }
 
  ensure_mutex_initialized();
  mutex_lock(&g_signaling_mutex);
 
  memcpy(g_session_context.session_id, session_id, 16);
  memcpy(g_session_context.participant_id, participant_id, 16);
  g_session_context.is_set = true;
 
  log_info("Session context set for WebRTC signaling (session=%.8s..., participant=%.8s...)", (const char *)session_id,
           (const char *)participant_id);
 
  mutex_unlock(&g_signaling_mutex);
}

References participant_id, and session_id.

webrtc_set_transport()

void webrtc_set_transport

(

acip_transport_t *

transport

)

Set the WebRTC data channel transport.

Stores the active WebRTC transport for peer-to-peer communication. Separate from ACDS signaling transport.

Parameters

transport

WebRTC transport (NULL to clear)

Note

Thread-safe - uses internal mutex protection

Stores the active WebRTC transport that will be used for peer-to-peer communication. This is different from the ACDS signaling transport - it's the actual data channel.

Parameters

transport

WebRTC transport (NULL to clear)

Note

Called when WebRTC connection is established or when falling back to TCP

If NULL is passed, the transport is cleared (e.g., on disconnect)

Definition at line 319 of file src/client/webrtc.c.

                                                       {
  ensure_mutex_initialized();
  mutex_lock(&g_signaling_mutex);
 
  g_webrtc_transport = transport;
 
  if (transport) {
    log_debug("WebRTC data channel transport set");
  } else {
    log_debug("WebRTC data channel transport cleared");
  }
 
  mutex_unlock(&g_signaling_mutex);
}