Skip to content

docs(calling): add call streaming guide - #692

Open
Devon-White wants to merge 3 commits into
mainfrom
devon/call-streaming-guide
Open

Devon-White wants to merge 3 commits into
mainfrom
devon/call-streaming-guide

Conversation

@Devon-White

Copy link
Copy Markdown
Collaborator

Summary

Adds a call streaming guide following the same template as the outbound calling guide (#660): prepare, stream your first call, handle the audio stream, control the stream, stream in both directions, and worked examples.

  • New guide at /voice/call-streaming covering SWML stream, the REST Calling API stream commands, and Relay's call.stream(), with a themed lifecycle diagram.
  • Bidirectional streaming documented as a connect destination (stream:wss://…) across SWML, REST (dial with inline SWML), and Relay (call.connect()), verified against the relay-apis and FreeSWITCH module source.
  • Two examples with no external dependencies: save call audio to WAV, and a bidirectional echo server.
  • Links the new guide from the calling overview page.

Verification

  • yarn fern-md-check passes (all MDX files valid).
  • Every SDK call in the guide checked against installed signalwire-sdk==3.4.1 and @signalwire/sdk@2.0.5 (Python py_compile, TypeScript tsc --strict, JS node --check).
  • All 6 WebSocket server examples executed end-to-end against a scripted stream client (Python websockets, Node ws); save-audio and echo servers verified byte-for-byte.
  • REST command names (calling.stream, calling.stream.stop) and both_tracks confirmed against specs/signalwire-rest/calling-api/calls/.
  • All in-page anchors and link references resolve.

🤖 Generated with Claude Code

Adds a call streaming guide covering SWML `stream`, the REST Calling
API stream commands, and Relay's `call.stream()`, following the same
template as the outbound calling guide (PR #660): prepare, stream your
first call, handle the audio stream, control the stream, stream in
both directions, and worked examples.

- New guide at /voice/call-streaming with a themed lifecycle diagram.
- Bidirectional streaming via `connect` to a `stream:wss://` device,
  covering SWML, REST (dial with inline SWML), and Relay
  (`call.connect()`), verified against the relay-apis and FreeSWITCH
  module source.
- Examples: save call audio to WAV with no external dependencies, and
  a bidirectional echo server.
- Links the new guide from the calling overview page.
@github-actions

github-actions Bot commented Sep 15, 2026

Copy link
Copy Markdown
Contributor

Devon-White and others added 2 commits September 15, 2026 11:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant