splive 1.0.2

Official Flutter SDK for Specular.Live voice, video, chat and realtime communication.

SPLive

Official Flutter SDK for Specular.Live

Voice • Video • Chat • Groups • Live Streaming • WebRTC • End-to-End Encryption

---

Overview

SPLive is the official Flutter SDK for building modern real-time communication applications powered by Specular.Live.

It provides everything required to build applications similar to:

• Discord
• Telegram Voice Chat
• Google Meet
• Clubhouse
• Slack Huddles

without having to manage signaling, media pipelines, or networking yourself.

---

Features

Authentication

• Login
• Register
• Refresh Token
• Logout
• Current User

---

Groups

• Create Groups
• Join Groups
• Leave Groups
• Group Management

---

Voice Rooms

• Join Voice Rooms
• Leave Voice Rooms
• Mute / Unmute
• Speaking Indicator
• Raise Hand
• Stage Mode
• Audience Mode

---

Video Rooms

• Camera
• Screen Sharing
• Camera Switching
• Active Speaker Detection
• Recording
• Google Meet Style UI

---

Chat

• Text Messages
• Images
• Voice Messages
• File Attachments
• Emoji Reactions
• Typing Indicator

---

Event System

Specular.events.onUserJoined

Specular.events.onUserLeft

Specular.events.onMessage

Specular.events.onReaction

Specular.events.onTyping

Specular.events.onRecordingStarted

Specular.events.onRoomClosed

---

Offline Support

• Offline Queue
• Automatic Retry
• File Cache
• Image Cache
• Audio Cache
• Video Cache

---

Reconnect

Automatic reconnection similar to Discord.

---

Security

• AES-256-GCM
• X25519
• End-to-End Encryption
• Secure Key Storage
• Media Encryption
• Key Rotation

---

Flutter Widgets

Ready-to-use UI widgets:

• VoiceRoomWidget
• VideoRoomWidget
• StageWidget
• AudienceGrid
• ParticipantTile
• ChatDrawer
• ReactionOverlay
• MicGlow
• RaiseHandWidget

---

Installation

Add SPLive to your project.

dependencies:
  splive: ^1.0.0

Install packages.

flutter pub get

---

Initialize

import 'package:flutter/widgets.dart';
import 'package:splive/splive.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Specular.initialize();

  runApp(const MyApp());
}

No API URL or WebSocket configuration is required.

All applications connect securely to the official Specular.Live infrastructure.

---

Login

final user = await Specular.login(
  username: "john",
  password: "123456",
);

---

Join Voice Room

await Specular.joinVoiceRoom(
  groupId: "community",
);

---

Join Video Room

await Specular.joinVideoRoom(
  groupId: "meeting-room",
);

---

Send Message

await Specular.chat.sendText(
  "Hello everyone!",
);

---

Listen For Events

Specular.events.onMessage.listen((event) {
  print(event.message);
});

---

Encryption

Enable End-to-End Encryption.

await Specular.enableEncryption();

---

Documentation

Complete documentation is available at

https://specular.live/docs

---

Example

A complete Flutter application is included inside

example/

It demonstrates:

• Authentication
• Groups
• Voice Rooms
• Video Rooms
• Chat
• Recording
• Notifications
• Admin Features
• Offline Queue
• Encryption

---

Platform Support

Platform	Supported
Android	✅
iOS	✅
macOS	✅
Windows	✅
Linux	✅
Web	🚧

---

Requirements

Flutter 3.24+

Dart 3.5+

---

License

MIT License

Copyright © 2026 Specular.Live

---

Links

Website

https://specular.live

Documentation

https://specular.live/docs

GitHub

https://github.com/specular-live/splive

Issues

https://github.com/specular-live/splive/issues