Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Improve connection reliability #18

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 81 commits into from
Aug 27, 2025
Merged

Improve connection reliability #18

merged 81 commits into from
Aug 27, 2025

Conversation

ladvoc
Copy link
Collaborator

@ladvoc ladvoc commented Aug 27, 2025

New features:

  • Automatic connection retry for non-fatal errors
    • Retry up to LK_MAX_RETRIES times
    • Exponential backoff + randomization between retry attempts
  • Room failure reason
    • Exposes a unified enum, livekit_failure_reason_t describing why a room connection failed
    • Public APIs to get failure reason and map to string description

New examples:

  • Minimal: bare minimum example for connecting to a room with two-way audio

Internal refactoring & improvements:

  • Hardcode STUN servers: this is a temporary workaround due to an issue using LiveKit TURN servers
  • Implement an event-driven FSM for more robust handling of engine state transitions
  • Create helper methods for encoding/decoding protocol messages
  • Implement signaling ping timeout
  • Switch to FreeRTOS timers over esp_timer for ping
  • Skip decoding protocol message types that are not supported yet
  • Benchmarking: measure WebSocket and peer connection time
    • Enable with LK_BENCHMARK=y, see results in console

ladvoc added 30 commits August 7, 2025 14:22
@ladvoc
Create minimal example
c275024
@ladvoc
Wip
244b355
@ladvoc
Connect signal
40eab0a
@ladvoc
Signal refactor
e3e741a
@ladvoc
Connect primary peer
16df9d3
@ladvoc
Remove dead code
c7da5a4
@ladvoc
Use event queue approach
2c7e496
@ladvoc
Introduce timer
46b1403
@ladvoc
Proper cleanup
7586145
@ladvoc
Implement reconnecting state
eafe3f1
@ladvoc
Remove disconnecting state
bc90f79
@ladvoc
Reintroduce all features
cd12ec3
@ladvoc
Add additional transitions
894b199
@ladvoc
Docs and organization
3e90462
@ladvoc
Remove any state handler
eef3f49
@ladvoc
Change event memory model
85d8e94
@ladvoc
Store local participant ID
043efde
@ladvoc
Consolidate event detail cases
5f88fb6
@ladvoc
Cleanup session state
7a1a309
@ladvoc
Engine refactor
1832a9c 
- Handle all signal responses in state machine
- Helper functions for protocol messages
@ladvoc
Simplify state machine memory model
a2eae8f 
Always discard events
@ladvoc
Helper methods for data packets
0f71911
@ladvoc
Allow engine to take ownership of data packet
2a7a1eb
@ladvoc
Process data packets via state machine
fcca62b
@ladvoc
Notify of engine state change
8b2b1db
@ladvoc
Add documentation
d47510a
@ladvoc
Allow handlers to take ownership of events
8569b41
@ladvoc
Exponential backoff
5d64e93
@ladvoc
Create helper to enqueue events
da8e6af
@ladvoc
Zero initialize protobuf structs
eb9a979
ladvoc added 25 commits August 25, 2025 14:18
@ladvoc
Inline remaining protocol helpers
c996bad
@ladvoc
Use consistent naming convention
b062bdd
@ladvoc
Make nanopb encode/decode includes private
7137330
@ladvoc
Simplify internal API
7865715
@ladvoc
Send data packets
b34f9aa
@ladvoc
Zero only
efd71e9
@ladvoc
Remove state guards for sub audio
c63c7c5 
Audio stream can begin while still in connecting state
@ladvoc
Handle room and participant update in connecting state
2153875 
Early participant update messages are necessary to subscribe to remote track
@ladvoc
Cleanup previous connection in backoff
0f774a1 
Perform same cleanup steps when entering both disconnected and backoff
@ladvoc
Handle ICE servers
5d2dac5 
Reintroduce support for dynamically setting ICE servers, use hardcoded for now.
@ladvoc
Use SAFE_FREE macro
04f5919
@ladvoc
Remove dead code
5927628
@ladvoc
Do not handle data packets in FSM
891f727
@ladvoc
Add basic connection time benchmarking
af98bb4
@ladvoc
Queue peer SDP messages
bf5a343
@ladvoc
Clean up
7457ae2
@ladvoc
Increase timer stack depth
bc81a93
@ladvoc
Fix typo
7ee5894
@ladvoc
Document how to get failure reason
35de2ca
@ladvoc
Data packet optimization
9cf876d 
- Ignore types that are not supported yet
- Fixed length sender SID
@ladvoc
Signal response optimization
a5332fa 
- Ignore types that are not supported yet
@ladvoc
Fix incorrect field type
5d23758
@ladvoc
Fix voice agent example agent join
69e63af
@ladvoc
Demonstrate getting failure reason in all examples
62d7a2c
@ladvoc
Consistent sdkconfig defaults between examples
aa8abd6
@ladvoc ladvoc requested a review from chenosaurus August 27, 2025 05:37
@ladvoc ladvoc merged commit 78dc1ca into main Aug 27, 2025
4 of 6 checks passed
@ladvoc ladvoc deleted the ladvoc/connection-reliability branch August 27, 2025 23:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@chenosaurus chenosaurus chenosaurus approved these changes

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
2 participants
@ladvoc @chenosaurus