Tune RTC connections¶

Use RTCSettings to configure direct connections, retries and incoming sessions. Pass the settings when creating the peer and room, as shown in the room example.

Direct connections and retries¶

Set the number of direct connections and how failed connections are retried:

RTCSettings settings = RTCSettings.getDefault("my-app", "chat-v1")
    .withMaxDirectPeers(4)
    .withMaxConcurrentConnectionAttempts(2)
    .withConnectionRetryInitialDelay(Duration.ofSeconds(1))
    .withConnectionRetryMaxDelay(Duration.ofSeconds(30))
    .withConnectionRetryMultiplier(2.0f)
    .withConnectionRetryJitter(0.2f)
    .withConnectionMinimumLifetime(Duration.ofSeconds(10));

This example allows four direct connections and two simultaneous connection attempts. Failed attempts wait longer between retries, up to 30 seconds. Jitter adds variation to the delay so peers avoid retrying together. The minimum lifetime helps keep working connections stable.

Prefer a known peer¶

If your app has a reliable host, give its public key a higher connection priority:

room.setDiscoveryPriority(peer ->
    peer.getPubkey().equals(author) ? 10.0f : 1.0f);

Higher values are preferred when choosing direct neighbors. The room also considers available capacity and the connections needed to keep participants reachable.

Limit incoming session requests¶

A room can receive connection messages before a peer's signed announcement arrives. Session limits control how much information it keeps while waiting:

int pendingSessions = 64;
int pendingSessionsPerIdentity = 2;
int announcedSessionsPerIdentity = 4;
int presenceRecordsPerIdentity = 16;
Duration announcementTimeout = Duration.ofSeconds(20);

RTCSessionLimits limits = new RTCSessionLimits(
    pendingSessions,
    pendingSessionsPerIdentity,
    announcedSessionsPerIdentity,
    presenceRecordsPerIdentity,
    announcementTimeout);
RTCSettings settings = RTCSettings.getDefault("my-app", "chat-v1")
    .withSessionLimits(limits);

An identity is a peer's public key; it can have several sessions. Presence records track its announcements.

These settings limit memory used during discovery. Your app decides who may join the room.