Canali, presence ed eventi client sul protocollo Pusher. Tieni pusher-js e la tua libreria server, puntali su Vixus Push e dedica la settimana alla funzionalità invece che a una flotta di WebSocket.
import Pusher from "pusher";
const pusher = new Pusher({ appId, key, secret, host });
await pusher.trigger("presence-room-7", "message", {
from: "linus",
text: "ship it",
});// funzionalità
Il protocollo Pusher che conosci, su un’infrastruttura che non devi gestire tu. Crea un’app, copia tre valori e rilascia.
Tieni pusher-js, Laravel Echo e tutte le librerie server di Pusher. Sostituisci il cluster con un host: nomi dei canali, eventi ed endpoint di autenticazione restano esattamente come sono.
const pusher = new Pusher("YOUR_KEY", {
- cluster: "eu",
+ cluster: "",
+ wsHost: "YOUR_HOST",
+ wssPort: 443,
+ forceTLS: true,
+ enabledTransports: ["ws", "wss"],
channelAuthorization: { endpoint: "/api/pusher/auth" },
});
Trasmetti a tutti, proteggi i canali con il tuo endpoint di autenticazione o scopri chi è online in questo momento.
Indicatori di scrittura e cursori passano direttamente da client a client sui canali privati e presence. Un interruttore per app.
Pubblica, pubblica in batch, leggi le info dei canali ed elenca i membri presence da qualsiasi backend. Ogni libreria server di Pusher firma le richieste per te.
// POST /apps/:id/batch_events, signed with your secret
await pusher.triggerBatch([
{ channel: "orders.4821", name: "status", data: { status: "packed" } },
{ channel: "private-user-ada", name: "notify", data: { order: 4821 } },
]);Porta il tuo team in un’organizzazione. I ruoli decidono chi vede i secret, chi cambia le impostazioni e chi guarda soltanto.
Messaggi, chiamate API e connessioni, ora per ora, per ogni app. I messaggi di oggi compaiono accanto al tuo limite giornaliero.
Ogni app ha una stanza demo. Manda il link a un secondo browser, senza account, e guarda i messaggi arrivare su entrambi.
// quickstart
Sono gli snippet veri, con l’host di questo servizio già inserito. Incolla l’ID e la key della tua app ed eseguili.
Registrati, crea un’app e copia app_id, key e secret. Per il piano Free non serve la carta.
Punta pusher-js sul tuo host, iscriviti a un canale e ascolta un evento. I canali privati e presence chiamano il tuo endpoint di autenticazione.
Chiama trigger da qualsiasi libreria server di Pusher. Il secret resta sul tuo server; al browser arriva solo la key.
import Pusher from "pusher-js";
const pusher = new Pusher("YOUR_APP_KEY", {
cluster: "", // not used; the host below decides where you connect
wsHost: "ws.push.vixus.io",
wsPort: 443,
wssPort: 443,
forceTLS: true,
enabledTransports: ["ws", "wss"],
});
const channel = pusher.subscribe("my-channel");
channel.bind("my-event", (data) => console.log(data));Trovi di più nel quickstart e nel riferimento dell’API HTTP (in inglese).
// da chi lo usa ogni giorno
Scegli la parte che ti interessa e leggi cosa ne pensa chi la usa.
Abbiamo lasciato Pusher un martedì pomeriggio. Il diff era la rigaclusterpiù qualche opzione nuova; nomi dei canali, endpoint di autenticazione e ogni chiamata abind()sono rimasti esattamente com’erano.
Gli avatar «chi c’è» sui nostri documenti condivisi sono un unico canale presence.member_addedemember_removedscattano esattamente quando te lo aspetti, e l’elenco dei membri arriva già al momento dell’iscrizione.
Le posizioni del cursore passano da client a client con gli eventi client-, quindi il nostro server non vede mai quel flusso. Per attivarli è bastato un interruttore nelle impostazioni, più una riconnessione, come avvisava la documentazione.triggerBatch è l’eroe silenzioso: una sola richiesta firmata invia l’aggiornamento di un ordine al cliente, al corriere e alla dashboard operativa. La documentazione avverte subito che gli errori tornano nel body, quindi non ci ha mai colto di sorpresa.Echo non ha dovuto accorgersi di nulla. Ho cambiato le variabiliPUSHER_*nel.env, ricompilato gli asset Vite e il broadcasting ha funzionato al primo deploy.
Chi lavora a progetto ha il ruolo Sviluppatore, l’amministrazione il ruolo Fatturazione e non vede mai un secret delle app. Quando qualcuno se ne va, la rimozione vale dalla sua richiesta successiva, non da quando gli scade la sessione.
La scheda «Utilizzo» risponde ora per ora alla domanda: cosa ha fatto quel rilascio al nostro volume di messaggi? Avere i messaggi di oggi accanto al limite giornaliero nella pagina App ci ha risparmiato un lunedì di sorprese.
Nei workshop apro il link della demo live sul portatile e sul telefono, e tutta la sala vede i messaggi arrivare su entrambi. Nessuno ha bisogno di un account, e il link scade da solo dopo un giorno.
I canali privati passano dal nostro endpoint di autenticazione, quindi la decisione di autorizzazione resta nel nostro codice. La key va al browser, il secret non lascia mai i nostri server, e ogni snippet è scritto così.
Mettiamo in pausa la nostra app di staging quando nessuno la usa. Nuove connessioni e pubblicazioni vengono rifiutate, non si cancella niente, e la ripresa la rimette subito in funzione. Ruotare un secret è un solo pulsante.
La nostra classe dal vivo mostra chi è in aula in quel momento. Con presence l’elenco dei presenti ce l’abbiamo gratis; l’unico codice che abbiamo scritto è l’endpoint di autenticazione, e quello c’era già da Pusher.
Nel quickstart l’host vero è già inserito. Ho copiato le schede browser e Node, le ho eseguite e avevo un messaggio in console prima che il caffè si raffreddasse.
// nessuna sorpresa
Dove Vixus Push si comporta come Pusher e dove no, prima che tu lo scopra in produzione. La tabella completa è nella documentazione (in inglese).
I canali cifrati e cache sono supportati da Soketi sotto il cofano, ma non sono ancora coperti dai nostri test. Stai migrando un’app esistente? Segui la guida alla migrazione (in inglese).
// prezzi
Questi numeri vengono dallo stesso catalogo che il servizio applica. I piani a pagamento non sono ancora in vendita e i loro limiti possono cambiare prima di allora.
Per costruire e provare le tue funzionalità in tempo reale.
Per i prodotti che vanno online con utenti reali.
Per app molto usate e team che hanno bisogno di margine.
pusher.subscribe("your-next-feature")
Crea un’app con il piano Free e guarda il tuo primo evento arrivare nel browser. Nessun server da gestire, nessuna carta da inserire.