Dla aplikacji

WebSocket API bez serwera do utrzymania

API czasu rzeczywistego na hostowanych WebSockets, dla Next.js, Laravel, Django i każdego innego stacku. Twój serwer wysyła zdarzenie jednym krótkim żądaniem, a każda strona w pokoju dostaje je od razu. To my utrzymujemy połączenia, więc nie musisz uruchamiać, skalować ani restartować żadnego serwera WebSocket.

Albo wypróbuj demo na żywo: mały sklep, w którym zamówienie zmienia się na wysłane w innym oknie, gdy klikasz.

Najlepsze ceny za WebSockets. Od $11.99 miesięcznie za 1000 jednoczesnych połączeń przy rozliczeniu rocznym lub $14.99 przy rozliczeniu miesięcznym.

Twój serwer

Next.js na serwerze i React na stronie.

app/orders/actions.ts
'use server';

import { realtime } from '@/lib/realtime';

export async function markShipped( id: string ) {
    await saveStatus( id, 'shipped' );
    await realtime.to( `order:${ id }` )
        .emit( 'updated', { status: 'shipped' } );
}
Twoja aplikacja

Hooki i komponenty dla każdej aplikacji React, z dowolnym serwerem powyżej.

components/Status.jsx
'use client';   // in Next.js

import { useState } from 'react';
import { useRoom } from '@wordplus/realtime/react';

// Inside <RealtimeProvider>, once for the whole app.
export function Status( { id, initial } ) {
    const [ status, setStatus ] = useState( initial );
    useRoom( `order:${ id }`, {
        updated: ( data ) => setStatus( data.status ),
    } );
    return <p>{ status }</p>;
}
Zamówienie zmienia stan na Wysłane, na stronie sklepu i na żywo na stronie klienta

Hostowane

Część, której już nie utrzymujesz

Serwer WebSocket działa na Twoim laptopie. Na produkcji musi godzinami utrzymywać każde połączenie, przekazywać każde zdarzenie między maszynami i przetrwać Twoje wdrożenia, a hosting serverless w ogóle nie utrzyma połączenia. Tutaj połączenia zostają u nas, a Twój serwer pozostaje taki, jaki jest.

Żadnych serwerów websocket do utrzymania

Własny serwer websocket musi utrzymać każde połączenie, wyjść poza jedną maszynę i działać podczas wdrożeń. Chmura robi to za Ciebie, dokładając serwery wraz ze wzrostem ruchu, a strona przechodzi na inny serwer bez przerwy.

Dowolny hosting dla Twojego serwera

Twój serwer tylko podpisuje i wysyła, więc działa wszędzie, także w funkcjach serverless i edge, które same nie utrzymają otwartego połączenia.

Twoje logowanie zostaje Twoje

Użytkownik to dowolny identyfikator, pod którym zna go Twoja aplikacja, odczytany na Twoim serwerze, więc sesja i ciasteczka działają tak jak dotąd.

Decyduje Twój serwer

Wysyłaj do kogo chcesz, zobacz, kto jest online, i zarządzaj pokojami

Pokój to tylko nazwa, na przykład chat:7, i nic nie trzeba tworzyć w chmurze. Twoja baza danych mówi, jakie pokoje istnieją i kto w nich jest, jedna reguła na Twoim serwerze ją czyta, a chmura pilnuje, by każda strona trzymała się odpowiedzi. Oto czat zespołu, od początku do końca.

Twój serwer

Next.js na serwerze i React na stronie.

Utwórz pokój

Zapisz to w swojej bazie danych i napisz jedną regułę, która ją czyta. Reguła działa, gdy ktoś prosi o dołączenie: false nie wpuszcza, true wpuszcza, a readOnly pozwala tylko czytać i nic nie wysyłać. Tutaj db to Twoja własna baza danych, a me to zalogowana osoba.

app/rooms/actions.ts
// A room is a row of yours. Nothing is created in the cloud.
const room = await db.room.create( { data: { name: 'Team' } } );

await db.member.create( { data: { roomId: room.id, userId: me, role: 'member' } } );

// Its name is yours to choose: row 7 is the room chat:7.
lib/realtime.ts
// Once, for every chat. When someone asks to join chat:7, id is '7'.
realtime.room( 'chat:{id}', async ( user, { id } ) => {
    const room = await db.room.findUnique( { where: { id: Number( id ) } } );
    if ( !room || room.closed ) return false;       // no such room, or closed

    const member = await db.member.findFirst( { where: { roomId: room.id, userId: user } } );
    if ( !member || member.banned ) return false;   // not a member, or banned

    return member.role === 'reader' ? { readOnly: true } : true;
}, { presence: true, emit: [ 'message' ] } );

Czat zespołu tutaj to dopiero początek: API czatu dodaje gotowy czat, historię, potwierdzenia odczytu, pliki i moderację.

Pokoje w każdym stacku, z całą konfiguracją:

Dlaczego websockety robią się trudne w Twoim frameworku: Next.js, Laravel, Django i Flask, FastAPI.

Masz własny serwer WebSocket? Nasz test WebSocket sprawdzi go z Twojej przeglądarki.

Na każdym połączeniu

Więcej niż gniazdo

Gniazdo przenosi bajty. Wszystko, co aplikacja buduje wokół niego, od ponownych połączeń po to, kto jest online, jest już gotowe.

Przeglądarki Ann, Bena i Cary, każda z całą trójką w sklepie, z ich rolami

Nic nie ginie przy ponownym połączeniu

Pokój może przechowywać swoje ostatnie zdarzenia, a strona, która wraca, dostaje to, co ją ominęło, po kolei, zanim dotrze to, co nastąpi dalej.

Kto jest online

Pokój może pokazywać, kto w nim jest, z tym, co zechcesz pokazać o każdej osobie. Licznik mówi, ile osób ogląda stronę, w każdej skali, a to, kto jest online, jest znane w całej Twojej aplikacji.

Zdarzenia ze strony

Strony wysyłają do pokoi, w których są, bez żądania do Twojego serwera: wiadomości czatu, pisanie, kursor. Reguła mówi, które zdarzenia można wysłać, a webhook przekazuje Twojemu serwerowi te, które ma zachować.

Do jednej osoby, wszędzie

Wyślij do użytkownika, a dotrze do każdej karty i urządzenia, które ma otwarte, bez tworzenia pokoju.

Zaszyfrowane kluczami, których nigdy nie mamy

Zdarzenia, obecność i historia podróżują zapieczętowane kluczami, które ma Twój serwer, a połączenia między dwiema osobami są szyfrowane end-to-end. Chmura je przenosi, nie mogąc ich odczytać.

Jedno połączenie dla wszystkich kart

Karty przeglądarki dzielą jedno połączenie, więc osoba z trzema otwartymi kartami liczy się raz.

Zastosowania

Co ludzie budują na WebSockets

Każde to cała aplikacja w dokumentacji, z serwerem w Node.js, PHP i Pythonie.

Aktualizacje na żywo i powiadomienia

Zamówienie, które przesuwa się na swojej stronie, panel, postęp zadania i powiadomienie dla jednego użytkownika w każdej karcie i aplikacji.

Czat

Rozmowy między dwiema osobami i w grupach, z pisaniem, znacznikami odczytu i reakcjami, przechowywane w Twojej własnej bazie danych.

Kto jest online i kto tu jest

Kropka przy każdym awatarze, osoby w pokoju wraz z rolami i liczba osób, które oglądają stronę.

Wspólna edycja

Kto jest w dokumencie, ich kursory i zmiany, wysyłane jako dane binarne i przechowywane na wypadek ponownego połączenia.

Ankiety, quizy i pytania

Głosy i pytania, które trafiają tylko do Twojego serwera, wyniki wysyłane do wszystkich i wynik każdego gracza.

Aukcje na żywo

Oferty, o których Twój serwer rozstrzyga po kolei, nowa cena dla wszystkich i zegar, który przesuwa się po spóźnionej ofercie.

Cennik

Cena według połączeń, nigdy według wiadomości

Od $11.99 miesięcznie za 1000 jednoczesnych połączeń przy rozliczeniu rocznym lub $14.99 przy rozliczeniu miesięcznym.

Cena zależy od jednoczesnych połączeń, od 1000, rozliczana miesięcznie lub rocznie. Wiadomości i transfer nigdy nie są rozliczane, a to, co wysyła Twój serwer, nie zużywa żadnych Twoich połączeń.

Ten sam plan i SDK dają też rozmowy wideo i transmisje na żywo, na tym samym połączeniu.

Pytania

Najczęstsze pytania

Czy potrzebuję własnego serwera WebSocket?

Nie. Przeglądarki i aplikacje utrzymują połączenia z naszymi serwerami, a w miarę wzrostu Twojej aplikacji uruchamia się ich więcej. Twój serwer tylko mówi, kto może do czego dołączyć, i wysyła każde zdarzenie jednym krótkim żądaniem HTTP.

Czy działa na hostingu serverless?

Tak. Funkcja serverless nie utrzyma otwartego połączenia i tutaj nie musi: wysyła każde zdarzenie jednym krótkim żądaniem, a połączenia zostają u nas. Funkcje edge i każdy inny hosting działają tak samo.

Które stacki mogą korzystać z WebSocket API?

Next.js i Express, Laravel i zwykłe PHP, Django, FastAPI i Flask, Capacitor, iOS i Android, każdy z przewodnikiem. Aplikacje React Native i Flutter też mają pokoje i obecność. Serwer w dowolnym innym języku używa HTTP API.

Czy sam piszę kod WebSocket?

Nie. SDK otwiera połączenie, samo łączy się ponownie i znów dołącza do Twoich pokoi, a Ty nasłuchujesz zdarzeń po nazwie. W Laravel jest to sterownik broadcastingu, więc broadcast() i Twój plik kanałów zostają bez zmian.

Co liczy się jako połączenie?

Przeglądarka lub urządzenie połączone w danej chwili z chmurą. Karty jednej przeglądarki dzielą jedno połączenie, gdy Twoja aplikacja udostępnia worker SDK, a to, co Twój serwer wysyła przez API, się nie liczy.

Co się dzieje przy limicie połączeń?

Do 20% więcej połączeń nadal się łączy, a właściciel konta dostaje e-mail przy 80% i przy 100% limitu, w porę, by przejść na większy plan.

Co się dzieje, gdy strona traci połączenie?

Łączy się ponownie sama. Pokój z historią przekazuje jej to, co ją ominęło, po kolei, do 5 minut, a strona nieobecna dłużej dostaje o tym informację, więc może znów odczytać dane z Twojego serwera. Historia służy tylko ponownym połączeniom: Twoje dane przechowuje Twoja własna baza.

Kto decyduje, kto dołącza do pokoju?

Twój serwer, z regułą dla każdego rodzaju pokoju: kto dołącza, co może wysyłać i kto tylko czyta. Chmura egzekwuje każdą odpowiedź, a Twój serwer może w dowolnej chwili usunąć kogoś z pokoju.

Czy możecie czytać to, co wysyła moja aplikacja?

Nie w pokoju prywatnym ani pokoju obecności. Jego zdarzenia, historia i lista osób podróżują zapieczętowane kluczami, które tworzy Twój serwer, a chmura przenosi je bez możliwości odczytu. Pokój publiczny, do którego może dołączyć każdy, działa bez szyfrowania.

Gdzie są Wasze serwery?

Serwery czasu rzeczywistego, które przenoszą Twoje zdarzenia, działają w Niemczech. Przekaźniki i serwery multimediów dla rozmów działają w większej liczbie krajów.

Pytania o Twoją integrację? Napisz do nas: pomagamy z SDK, ekranem rozmowy i Twoim stackiem.