Messaging Platform SDK - Real-Time Communication

Live Demos

Experience the SDK in action. No installation required.

🎨

Featured

Collaborative Whiteboard

Draw together in real-time. Perfect for brainstorming, design reviews, and remote collaboration.

Canvas API Multi-user

Try It Live

💻

Featured

Interactive Terminal

Execute commands locally or on remote servers via SSH. Share terminal sessions in real-time with session management and SFTP support.

SSH Real-time SFTP

Open Terminal

🏒

Game

Air Hockey

Real-time multiplayer physics game. Challenge a friend to a quick match with smooth 60 FPS gameplay.

Physics 2-Player

Play Now

📁

Tool

Quick Share

Share files and text instantly with nearby devices. No accounts, no uploads to cloud servers.

File Transfer P2P

Try It Live

💬

Basic

Chat Demo

Simple chat room demonstrating basic messaging patterns and event handling.

Messaging Events

Open Chat

📹

Experimental

Video Chat

WebRTC-powered video conferencing with screen sharing and real-time communication.

WebRTC Streaming

Start Call

🔧

Tool

Connection Tester

Test your API keys, validate connections, and debug integration issues.

Debug Testing

Test Now

🎮

More Demos

Fall Guys, Race Balls, Quiz Battle, Find the Liar, Channel Storage, and more...

Developer Portal

🚀 Quick Start — 3 Steps

Include the SDK

<!-- Add to your HTML -->
<script src="web-agent.libs.js"></script>
<script src="web-agent.js"></script>

<!-- Optional: For WebRTC (video/audio/screen sharing) -->
<script src="web-agent.webrtc.js"></script>

Connect to a Channel

const agent = new AgentConnection();

agent.connect({
  channelName:     'my-room',
  channelPassword: 'secret123',
  agentName:       'player-1',
  api:             'https://hmdevonline.com/messaging-platform/api/v1/messaging-service',
  apiKey:          'your-api-key'
});

Send & Receive Messages

// Simple text message
agent.sendTextMessage('Hello, World!');

// Object format (for advanced options)
agent.sendMessage({
  content:    'Hello, World!',
  type:       'chat-text',
  to:         'player-2'  // Optional: specific agent
});

// Receive messages
agent.onMessage = (msg) => {
  console.log(msg.content);
};

📚 Full Documentation →

How It Works

Simple architecture, powerful capabilities

🔐

Secure by Default

End-to-end encryption ensures your data stays private between clients

⚡

Real-Time Communication

WebSocket-based messaging with sub-50ms latency for smooth interactions

🌍

Cross-Platform

SDKs for Web, Java, Python, and C++ with consistent APIs

Show Architecture Details

System Architecture


┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Client A  │────▶│   Server    │◀────│   Client B  │
│  (Browser)  │     │  (Gateway)  │     │   (Game)    │
└─────────────┘     └─────────────┘     └─────────────┘
      │                    │                    │
      │    WebSocket       │    WebSocket       │
      │   + Encryption     │   + Encryption     │
      │                    │                    │
      └────────────────────┴────────────────────┘
                  Real-Time Channel

Channel-Based

Clients join named channels to communicate. No complex room management required.

Message Types

Send any JSON-serializable data. Define your own message protocol.

Presence Tracking

Know when users join, leave, or disconnect from a channel.

WebRTC Relay

Optional P2P connections for video/audio with automatic fallback.

🎮 Mini-Games

Interactive multiplayer games showcasing real-time communication

🏒

Featured

Air Hockey

Classic 2-player physics game with ultra-low latency P2P gameplay.

Physics 2-Player

Play Now

❓

Featured

Quiz Battle

Multiplayer trivia quiz with real-time scoring and timed questions.

2-8 Players Trivia

Play Now

🤥

Game

Find the Liar

Social deduction party game where players vote to catch the liar!

3-10 Players Party

Play Now

🏃

Game

Fall Guys Race

Obstacle course racing with 3D graphics and physics.

Multi-player 3D

Play Now

🏁

Game

Race Balls

3D racing with physics-based ball controls and boost system.

2-4 Players Racing

Play Now

⚡

Game

Reactor

Fast-paced 4-player reaction game testing your reflexes.

4-Player Reaction

Play Now

🏗️ System Architecture Overview

The Messaging Platform is a real-time communication system that enables agents (clients) to exchange messages through channels. It supports multiple protocols (HTTP, WebSocket, UDP) and provides features like encryption, WebRTC relay, channel isolation, and ephemeral messaging.

📊 HIGH-LEVEL ARCHITECTURE

🔑 API Key System

The platform uses a flexible API key system with two types of keys for different security requirements.

🔐 API KEY ARCHITECTURE

┌─────────────────────────────────────────────────────────────────────────────────┐
│                           API KEY SYSTEM                                         │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                  │
│   ORIGINAL API KEY (Developer Key)                                             │
│   ├── Permanent key issued to developer                                         │
│   ├── Full access to all features                                               │
│   ├── Used for server-side applications                                         │
│   └── Should be kept SECRET (never expose to clients)                           │
│                                                                                  │
│                          │                                                       │
│                          ▼                                                       │
│   TEMPORARY API KEY (Client Key)                                               │
│   ├── Short-lived (expires automatically)                                       │
│   ├── Limited capabilities                                                      │
│   ├── Safe for client-side applications                                         │
│   └── If compromised, expires soon anyway                                       │
│                                                                                  │
└─────────────────────────────────────────────────────────────────────────────────┘

💡 WHEN TO USE EACH:

┌──────────────────────────────────┬──────────────────────────────────────────────┐
│         Original API Key          │              Temporary API Key              │
├──────────────────────────────────┼──────────────────────────────────────────────┤
│ ✓ Server-side applications       │ ✓ Web browsers (JavaScript)                  │
│ ✓ Backend services               │ ✓ Mobile apps                                │
│ ✓ Trusted environments           │ ✓ Untrusted clients                          │
│ ✓ Full feature access needed     │ ✓ Limited feature access OK                  │
│ ✗ Never in client-side code      │ ✓ Safe to expose in client code              │
└──────────────────────────────────┴──────────────────────────────────────────────┘

Temporary Key Flow

Server Creates Temporary Key

Your backend server uses the original API key to create a temporary key with specific restrictions.

Client Receives Temporary Key

The temporary key is sent to the client (browser, mobile app). It's safe to transmit over the network.

Client Connects to Channel

The client uses the temporary key to connect. The platform validates it and applies restrictions.

Key Expires Automatically

After the expiration time, the key stops working. Client needs a new temporary key to continue.

✨ Key Features

🔐 End-to-End Encryption

All messages encrypted by default using DTLS and TLS

📡 WebSocket + WebRTC

Real-time messaging with ultra-low latency P2P channels

🌐 Channel-Based

Simple and intuitive room management with named channels

👥 Presence Tracking

Real-time notifications when users join, leave, or disconnect

💾 Channel Storage

Persistent key-value storage for game state and settings

🔄 Auto-Reconnection

Built-in logic handles network interruptions gracefully

💻 Code Examples

Quick code snippets to get you started

1. Include the SDK

<script src="web-agent.libs.js"></script>
<script src="web-agent.js"></script>

2. Connect to a Channel

const agent = new AgentConnection();

agent.connect({
  channelName:     'my-room',
  channelPassword: 'secret123',
  agentName:       'player-1',
  api:             'https://hmdevonline.com/messaging-platform/api/v1/messaging-service',
  apiKey:          'your-api-key'
});

3. Send Messages

// Simple text message
agent.sendTextMessage('Hello, World!');

// Object format
agent.sendMessage({
  content: 'Hello, World!',
  type: 'chat-text',
  to: 'player-2'
});

4. Receive Messages

agent.onMessage = (msg) => {
  console.log(msg.content);
};

View Full Documentation

✨ Features

Everything you need for real-time applications

🔐

End-to-End Encryption

DTLS and TLS encryption by default. Your data stays private.

⚡

Ultra-Low Latency

WebRTC P2P connections for sub-50ms latency in games.

🌍

Cross-Platform SDKs

JavaScript, Java, Python, and C++ with consistent APIs.

📡

Real-Time Messaging

WebSocket-based instant communication between all clients.

💾

Channel Storage

Persistent key-value storage for game state and settings.

👥

Presence Tracking

Real-time notifications when users join, leave, or disconnect.

🔄

Auto-Reconnection

Built-in logic handles network interruptions gracefully.

🎮

Game-Ready

Optimized for real-time multiplayer games and simulations.

📱

Mobile-Friendly

Works on iOS, Android, and all modern browsers.

🔓

Open Source

MIT License - use it freely in your projects.

📋 Current Status

Production readiness and API stability

🚧

Pre-Production Status

The Messaging Platform SDK is currently in active development and pre-production stage.

What This Means:

✅ Fully Functional: All core features work and are stable
⚠️ API Changes: APIs may change between releases
🧪 Active Testing: Undergoing extensive testing and optimization
📖 Documentation: Being continuously improved
🎯 Production Ready: Target Q2 2026

Want to use it in production? Join the discussion

🚀 Roadmap

What's coming next

Q1 2026 - CURRENT

✅ Core SDK & Examples

JavaScript/Java/Python/C++ SDKs
WebSocket + WebRTC support
Example games and applications
Channel storage API

Q2 2026

🎯 Production Release

API stabilization and v1.0 release
Complete documentation
Performance optimizations
Production-ready deployment guides

Q3 2026

🚀 Advanced Features

Voice/Video chat SDK
Screen sharing support
Advanced matchmaking
Analytics dashboard

Q4 2026

🌟 Enterprise Features

Self-hosted server option
Custom authentication integration
Advanced monitoring and logging
SLA and enterprise support

Have suggestions? We'd love to hear from you!

Join Discussions