Core Concepts

Understand the fundamental building blocks of the Talksphere platform.

Rooms

A Room is a virtual space where real-time communication happens. Rooms are identified by a unique `roomId` string (e.g., "daily-standup", "guid-123").

• Dynamic Creation: You don't need to "create" a room via API. Just joining a room with a valid API key will spin it up instantly.
• Ephemeral: Rooms automatically close when the last participant leaves.

Participants

A Participant represents a user connected to a Room. Each participant has a unique identity and can publish media tracks.

• Local Participant: The user using your app on the current device.
• Remote Participant: Other users connected to the same room.

Tracks

A Track is a single stream of audio or video.

• Audio Track: Input from a microphone.
• Video Track: Input from a camera or screen share.

Talksphere automatically handles the complexities of encoding, bandwidth estimation, and simulcast for these tracks.

Authentication

Talksphere uses API Keys to authenticate your application.

⚠️ Security Note: For production applications, we recommend generating short-lived access tokens on your backend rather than exposing your API key in the client.