Za aplikacije

WebSocket API bez poslužitelja kojim morate upravljati

API za stvarno vrijeme na hostiranim WebSockets, za Next.js, Laravel, Django i svaki drugi stack. Vaš poslužitelj šalje događaj jednim kratkim zahtjevom, a svaka stranica u sobi ga dobiva odmah. Mi držimo veze otvorenima, pa nema WebSocket poslužitelja koji biste morali pokretati, skalirati ili ponovno pokretati.

Ili isprobajte demo uživo: malu trgovinu u kojoj se narudžba u drugom prozoru mijenja u poslanu dok vi klikate.

Najbolje cijene za WebSockets. Od $11.99 mjesečno za 1.000 istodobnih veza uz godišnju naplatu, ili $14.99 uz mjesečnu naplatu.

Vaš poslužitelj

Next.js na poslužitelju i React na stranici.

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' } );
}
Vaša aplikacija

Hookovi i komponente za svaku React aplikaciju, uz bilo koji poslužitelj gore.

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>;
}
Narudžba prelazi u stanje Poslano, na stranici trgovine i uživo na stranici kupca

Hostirano

Dio kojim više ne upravljate

WebSocket poslužitelj radi na vašem laptopu. U produkciji mora satima držati svaku vezu otvorenom, dijeliti svaki događaj među strojevima i preživjeti vaše deploye, a serverless hosting uopće ne može držati vezu. Ovdje veze ostaju kod nas, a vaš poslužitelj ostaje kakav jest.

Nema websocket poslužitelja za održavanje

Vaš vlastiti websocket poslužitelj mora držati svaku vezu, rasti preko jednog stroja i raditi tijekom isporuka. Oblak to radi umjesto vas, dodajući poslužitelje kako promet raste, a stranica prelazi na drugi poslužitelj bez prekida.

Bilo koji hosting za vaš poslužitelj

Vaš poslužitelj samo potpisuje i šalje, pa radi bilo gdje, uključujući serverless i edge funkcije, koje same ne mogu držati vezu otvorenom.

Vaša prijava ostaje vaša

Korisnik je ono što vaša aplikacija koristi kao njegov id, a čita se na vašem poslužitelju, pa vaša sesija i kolačići rade kao i sada.

Odlučuje vaš poslužitelj

Šaljite kome želite, pogledajte tko je na mreži i upravljajte sobama

Soba je samo naziv, poput chat:7, a u oblaku nema ništa što biste morali stvarati. Vaša baza podataka određuje koje sobe postoje i tko je u njima, jedno pravilo na vašem poslužitelju to čita, a oblak svaku stranicu drži onoga što pravilo odgovori. Evo timskog chata, od početka do kraja.

Vaš poslužitelj

Next.js na poslužitelju i React na stranici.

Stvorite sobu

Spremite je u svoju bazu podataka i napišite jedno pravilo koje je čita. Pravilo se pokreće kad se netko želi pridružiti: false ga ne pušta, true ga pušta, a readOnly mu dopušta samo čitanje, bez slanja. Ovdje je db vaša baza podataka, a me je prijavljena 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' ] } );

Timski chat ovdje tek je početak: chat API dodaje gotov chat, povijest, oznake čitanja, datoteke i moderiranje.

Sobe u svakom stacku, s cijelim postavljanjem:

Zašto WebSockets postaju teški u vašem frameworku: Next.js, Laravel, Django i Flask, FastAPI.

Imate vlastiti WebSocket poslužitelj? Naš WebSocket test provjerava ga iz vašeg preglednika.

Na svakoj vezi

Više od socketa

Socket prenosi bajtove. Sve što aplikacija gradi oko njega, od ponovnih povezivanja do toga tko je na mreži, već postoji.

Preglednici Ann, Bena i Care, svaki s njih troje u trgovini, s njihovim ulogama

Ništa se ne gubi pri ponovnom povezivanju

Soba može čuvati svoje zadnje događaje, a stranica koja se vrati dobiva što je propustila, redom, prije onoga što slijedi.

Tko je online

Soba može prikazati tko je u njoj, s onim što odaberete prikazati o svakoj osobi. Brojač govori koliko ljudi gleda stranicu, u bilo kojem opsegu, a tko je online poznato je u cijeloj vašoj aplikaciji.

Događaji sa stranice

Stranice šalju u sobe u kojima jesu, bez zahtjeva prema vašem poslužitelju: poruke chata, tipkanje, kursor. Pravilo određuje koji se događaji smiju slati, a webhook vašem poslužitelju predaje one koje treba zadržati.

Jednoj osobi, posvuda

Pošaljite korisniku i poruka stiže na svaku karticu i uređaj koje ima otvorene, bez postavljanja sobe.

Šifrirano, ključevima koje nikad nemamo

Događaji, prisutnost i povijest putuju zapečaćeni ključevima koje drži vaš poslužitelj, a pozivi između dvoje ljudi šifrirani su s kraja na kraj. Oblak ih prenosi bez mogućnosti da ih pročita.

Jedna veza za sve kartice

Kartice jednog preglednika dijele jednu vezu, pa se osoba s tri otvorene kartice računa jednom.

Primjeri upotrebe

Što ljudi grade na WebSockets

Svaki je cijela aplikacija u dokumentaciji, s poslužiteljem u Node.js-u, PHP-u i Pythonu.

Ažuriranja i obavijesti uživo

Narudžba koja se mijenja na svojoj stranici, nadzorna ploča, napredak nekog posla i obavijest jednom korisniku u svakoj kartici i aplikaciji.

Chat

Razgovori između dviju osoba i u grupama, s tipkanjem, oznakama pročitanosti i reakcijama, spremljeni u vašu bazu podataka.

Tko je na mreži i tko je ovdje

Točka na svakom avataru, osobe u sobi s njihovim ulogama i broj onih koji gledaju stranicu.

Zajedničko uređivanje

Tko je u dokumentu, njihovi kursori i izmjene, poslani binarno i sačuvani za ponovno povezivanje.

Ankete, kvizovi i pitanja

Glasovi i pitanja koji stižu samo do vašeg poslužitelja, rezultati poslani svima i rezultat za svakog igrača.

Aukcije uživo

Ponude o kojima vaš poslužitelj odlučuje jednu po jednu, nova cijena svima i sat koji se pomiče kad ponuda stigne u zadnji čas.

Cijene

Cijena prema vezama, nikad prema porukama

Od $11.99 mjesečno za 1.000 istodobnih veza uz godišnju naplatu, ili $14.99 uz mjesečnu naplatu.

Cijena ovisi o broju istodobnih veza, počevši od 1.000, uz mjesečnu ili godišnju naplatu. Poruke i promet nikad se ne naplaćuju, a ono što šalje vaš poslužitelj ne troši nijednu vašu vezu.

Isti plan i SDK donose video pozive i prijenos uživo, na istoj vezi.

Pitanja

Česta pitanja

Trebam li vlastiti WebSocket poslužitelj?

Ne. Preglednici i aplikacije drže svoje veze otvorenima prema našim poslužiteljima, a kako vaša aplikacija raste, pokreće se još njih. Vaš poslužitelj samo određuje tko se čemu smije pridružiti i šalje svaki događaj jednim kratkim HTTP zahtjevom.

Radi li na serverless hostingu?

Da. Serverless funkcija ne može držati vezu otvorenom i ovdje ne mora: svaki događaj šalje jednim kratkim zahtjevom, a veze ostaju kod nas. Edge funkcije i svaki drugi hosting rade na isti način.

Koji stackovi mogu koristiti WebSocket API?

Next.js i Express, Laravel i obični PHP, Django, FastAPI i Flask, Capacitor, iOS i Android, svaki s vlastitim vodičem. Aplikacije u React Nativeu i Flutteru također imaju sobe i prisutnost. Poslužitelj u bilo kojem drugom jeziku koristi HTTP API.

Moram li sam pisati WebSocket kôd?

Ne. SDK otvara vezu, sam se ponovno povezuje i ponovno vas pridružuje vašim sobama, a vi slušate događaje po nazivu. U Laravelu je to broadcasting driver, pa broadcast() i vaša datoteka s kanalima ostaju kakvi jesu.

Što se broji kao veza?

Preglednik ili uređaj koji je u tom trenutku povezan s oblakom. Kartice jednog preglednika dijele jednu vezu kada vaša aplikacija poslužuje SDK worker, a ono što vaš poslužitelj šalje preko API-ja ne broji se.

Što se događa kad dosegnem ograničenje veza?

Do 20% više veza i dalje se uspješno spaja, a vlasnik računa dobiva e-poštu na 80% i na 100% veza, na vrijeme da prijeđe na veći plan.

Što se događa kad stranica izgubi vezu?

Sama se ponovno povezuje. Soba koja čuva povijest daje joj što je propustila, redom, do 5 minuta, a stranica koja je bila odsutna dulje dobiva obavijest o tome, pa ponovno može čitati vaš poslužitelj. Povijest služi samo za ponovna povezivanja: vaše zapise čuva vaša baza podataka.

Tko odlučuje tko se pridružuje sobi?

Vaš poslužitelj, pravilom za svaku vrstu sobe: tko se pridružuje, što smije slati i tko samo čita. Oblak provodi svaki odgovor, a vaš poslužitelj može u svakom trenutku nekoga izbaciti iz sobe.

Možete li čitati što moja aplikacija šalje?

Ne u privatnoj ili presence sobi. Njezini događaji, povijest i popis tko je u njoj putuju zapečaćeni ključevima koje izrađuje vaš poslužitelj, a oblak ih prenosi bez mogućnosti čitanja. Javna soba, kojoj se svatko može pridružiti, ide nešifrirano.

Gdje su vaši poslužitelji?

Poslužitelji za stvarno vrijeme koji prenose vaše događaje nalaze se u Njemačkoj. Releji i medijski poslužitelji za pozive nalaze se u više zemalja.

Pitanja o vašoj integraciji? Pišite nam: pomažemo sa SDK-ovima, zaslonom poziva i vašim stackom.