Canaux, présence et événements client via le protocole Pusher. Gardez pusher-js et votre bibliothèque serveur, pointez-les vers Vixus Push et consacrez votre semaine à la fonctionnalité plutôt qu’à une flotte de WebSockets.
import Pusher from "pusher";
const pusher = new Pusher({ appId, key, secret, host });
await pusher.trigger("presence-room-7", "message", {
from: "linus",
text: "ship it",
});// fonctionnalités
Le protocole Pusher que vous connaissez, sur une infrastructure que vous n’avez pas à gérer. Créez une app, copiez trois valeurs, livrez.
Gardez pusher-js, Laravel Echo et toutes les bibliothèques serveur Pusher. Remplacez le cluster par un hôte : les noms de canaux, les événements et votre endpoint d’authentification restent identiques.
const pusher = new Pusher("YOUR_KEY", {
- cluster: "eu",
+ cluster: "",
+ wsHost: "YOUR_HOST",
+ wssPort: 443,
+ forceTLS: true,
+ enabledTransports: ["ws", "wss"],
channelAuthorization: { endpoint: "/api/pusher/auth" },
});
Diffusez à tout le monde, protégez des canaux avec votre propre endpoint d’authentification, ou sachez qui est en ligne en ce moment.
Indicateurs de saisie et curseurs passent directement de client à client sur les canaux privés et de présence. Un interrupteur par app.
Publiez, publiez par lots, lisez les infos des canaux et listez les membres de présence depuis n’importe quel backend. Chaque bibliothèque serveur Pusher signe les requêtes pour vous.
// 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 } },
]);Invitez votre équipe dans une organisation. Les rôles décident qui voit les secrets, qui modifie les paramètres et qui se contente de consulter.
Messages, appels API et connexions, heure par heure, pour chaque app. Les messages du jour s’affichent à côté de votre limite quotidienne.
Chaque app a sa salle de démo. Envoyez le lien à un second navigateur, sans compte, et regardez les messages arriver des deux côtés.
// quickstart
Ce sont les vrais extraits de code, avec l’hôte de ce service déjà renseigné. Collez l’ID et la clé de votre app, puis lancez-les.
Inscrivez-vous, créez une app et copiez son app_id, sa clé et son secret. L’offre Free ne demande pas de carte bancaire.
Pointez pusher-js vers votre hôte, abonnez-vous à un canal et écoutez un événement. Les canaux privés et de présence appellent votre propre endpoint d’authentification.
Appelez trigger depuis n’importe quelle bibliothèque serveur Pusher. Le secret reste sur votre serveur ; seule la clé part dans le navigateur.
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));Plus de détails dans le quickstart et la référence de l’API HTTP (en anglais).
// celles et ceux qui livrent avec
Choisissez la partie qui vous intéresse et découvrez ce qu’en dit quelqu’un qui l’utilise.
Nous avons quitté Pusher un mardi après-midi. Le diff se résumait à la ligneclusteret à quelques nouvelles options ; les noms de canaux, l’endpoint d’authentification et chaque appel àbind()sont restés exactement les mêmes.
Les avatars « qui est là » sur nos documents partagés, c’est un seul canal de présence.member_addedetmember_removedse déclenchent exactement quand on s’y attend, et la liste des membres est là dès l’abonnement.
Les positions de curseur passent de client à client avec les événements client-, donc notre serveur ne voit jamais ce flot. Pour les activer, un interrupteur dans les paramètres, plus une reconnexion, ce dont la doc m’avait prévenu.triggerBatch est le héros discret : une seule requête signée diffuse une mise à jour de commande au client, au livreur et au tableau des opérations. La doc précise d’emblée que les erreurs reviennent dans le corps de la réponse, donc on ne s’est jamais fait avoir.Echo n’a même pas eu besoin de savoir que quelque chose avait changé. J’ai remplacé les variablesPUSHER_*dans.env, recompilé les assets Vite, et le broadcasting a fonctionné dès le premier déploiement.
Les prestataires ont le rôle Développeur, la compta le rôle Facturation et ne voit jamais un secret d’app. Quand quelqu’un part, son retrait prend effet à sa requête suivante, pas quand sa session finit par expirer.
L’onglet « Utilisation » répond heure par heure à la question : qu’a fait cette release à notre volume de messages ? Voir les messages du jour à côté de la limite quotidienne sur la page Apps nous a évité un lundi plein de surprises.
En atelier, j’ouvre le lien de la démo en direct sur mon portable et sur mon téléphone, et toute la salle voit les messages arriver sur les deux. Personne n’a besoin de compte, et le lien expire tout seul au bout d’un jour.
Les canaux privés passent par notre propre endpoint d’authentification, donc la décision d’autorisation reste dans notre code. La clé part dans le navigateur, le secret ne quitte jamais nos serveurs, et chaque extrait de code est écrit ainsi.
Nous mettons notre app de staging en pause quand personne ne s’en sert. Les nouvelles connexions et publications sont refusées, rien n’est supprimé, et la reprise la remet en route aussitôt. Renouveler un secret tient en un bouton.
Notre classe en direct montre quels élèves sont dans la salle. La présence nous a donné la liste gratuitement ; le seul code que nous avons écrit, c’est l’endpoint d’authentification, et nous l’avions déjà grâce à Pusher.
Le quickstart contient déjà le vrai hôte. J’ai copié les onglets navigateur et Node, je les ai lancés, et j’avais un message dans la console avant que mon café refroidisse.
// pas de surprises
Là où Vixus Push se comporte comme Pusher et là où ce n’est pas le cas, avant que vous ne le découvriez en production. Le tableau complet se trouve dans la documentation (en anglais).
Les canaux chiffrés et les canaux cache sont pris en charge par Soketi en dessous, mais pas encore couverts par nos tests. Vous migrez une app existante ? Suivez le guide de migration (en anglais).
// tarifs
Ces chiffres viennent du même catalogue que celui appliqué par le service. Les offres payantes ne sont pas encore en vente, et leurs limites peuvent changer d’ici là.
Pour créer et tester vos fonctionnalités temps réel.
Pour les produits qui passent en production avec de vrais utilisateurs.
Pour les apps très actives et les équipes qui ont besoin de marge.
pusher.subscribe("your-next-feature")
Créez une app avec l’offre Free et regardez votre premier événement arriver dans le navigateur. Aucun serveur à gérer, aucune carte à saisir.