לאפליקציות

WebSocket API בלי שרת להפעיל

API בזמן אמת על WebSockets מנוהלים, ל-Next.js, ל-Laravel, ל-Django ולכל סטאק אחר. השרת שלכם שולח אירוע בבקשה קצרה אחת, וכל דף בחדר מקבל אותו מיד. אנחנו מחזיקים את החיבורים פתוחים, ולכן אין שרת WebSocket שצריך להפעיל, להרחיב או להפעיל מחדש.

או נסו את ההדגמה החיה: חנות קטנה, שבה הזמנה הופכת לנשלחה בחלון אחר בזמן שאתם לוחצים.

התמחור הטוב ביותר ל-WebSockets. החל מ-$11.99 לחודש עבור 1,000 חיבורים בו-זמניים, בחיוב שנתי, או $14.99 בחיוב חודשי.

השרת שלכם

Next.js בשרת ו-React בדף.

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' } );
}
האפליקציה שלכם

Hooks ורכיבים לכל אפליקציית React, עם כל אחד מהשרתים למעלה.

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>;
}
הזמנה שעוברת למצב נשלחה, בדף החנות ובשידור חי בדף הלקוח

מנוהל

החלק שכבר לא צריך להפעיל

שרת WebSocket עובד על המחשב הנייד שלכם. בייצור הוא צריך להחזיק כל חיבור פתוח שעות, להעביר כל אירוע בין מכונות ולשרוד את ה-deploy שלכם, ואחסון serverless לא יכול להחזיק חיבור בכלל. כאן החיבורים נשארים אצלנו, והשרת שלכם נשאר כמו שהוא.

בלי שרתי websocket לתחזק

שרת websocket משלכם צריך להחזיק כל חיבור, לגדול מעבר למכונה אחת ולהישאר זמין גם בזמן פריסות. הענן עושה את זה ומוסיף שרתים ככל שהתעבורה שלכם גדלה, ודף עובר לשרת אחר בלי ניתוק.

כל אחסון לשרת שלכם

השרת שלכם רק חותם ושולח, ולכן הוא רץ בכל מקום, כולל פונקציות serverless ופונקציות edge שלא יכולות להחזיק חיבור פתוח בעצמן.

ההתחברות נשארת שלכם

משתמש הוא המזהה שהאפליקציה שלכם מכירה, והוא נקרא בשרת שלכם, ולכן ה-session וה-cookies ממשיכים לעבוד כמו היום.

השרת שלכם מחליט

שליחה לכל אחד, מי מחובר וניהול החדרים שלכם

חדר הוא רק שם, כמו chat:7, ואין מה ליצור בענן. מסד הנתונים שלכם קובע אילו חדרים קיימים ומי בהם, כלל אחד בשרת שלכם קורא אותו, והענן מחייב כל דף לפי התשובה. הנה צ׳אט צוות, מההתחלה ועד הסוף.

השרת שלכם

Next.js בשרת ו-React בדף.

יצירת חדר

שמרו אותו במסד הנתונים שלכם, וכתבו כלל אחד שקורא אותו. הכלל רץ כשמישהו מבקש להצטרף: false משאיר אותו בחוץ, true מכניס אותו, ו-readOnly נותן לו לקרוא ולא לשלוח דבר. כאן db הוא מסד הנתונים שלכם, ו-me הוא האדם שמחובר.

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' ] } );

הצ׳אט הצוותי כאן הוא רק ההתחלה: ה-API של הצ׳אט מוסיף את הצ׳אט המוכן, את ההיסטוריה, סימוני קריאה, קבצים וניהול.

חדרים בכל סטאק, עם ההגדרה המלאה:

למה WebSockets הופכים קשים ב-framework שלכם: Next.js, Laravel, Django ו-Flask, FastAPI.

מפעילים שרת WebSocket משלכם? בדיקת ה-WebSocket שלנו בודקת אותו מהדפדפן שלכם.

בכל חיבור

יותר מסוקט

סוקט מעביר בתים. כל מה שאפליקציה בונה סביבו, מחיבור מחדש ועד מי מחובר, כבר קיים.

הדפדפנים של אן, בן וקארה, וכל אחד מציג את שלושתם בחנות עכשיו, עם התפקידים שלהם

שום דבר לא הולך לאיבוד בחיבור מחדש

חדר יכול לשמור את האירועים האחרונים שלו, ודף שחוזר מקבל את מה שהחמיץ, לפי הסדר, לפני מה שבא אחר כך.

מי מחובר

חדר יכול להציג מי נמצא בו, עם מה שתבחרו להציג על כל אחד. מונה אומר כמה צופים בדף, בכל היקף, ומי מחובר ידוע בכל האפליקציה שלכם.

אירועים מהדף

דפים שולחים לחדרים שהם נמצאים בהם, בלי בקשה לשרת שלכם: הודעות צ׳אט, הקלדה, סמן. הכלל קובע אילו אירועים מותר לשלוח, ווובהוק מעביר לשרת שלכם את אלה שהוא צריך לשמור.

לאדם אחד, בכל מקום

שלחו למשתמש, וזה מגיע לכל לשונית ולכל מכשיר שפתוחים אצלו, בלי להקים חדר.

מוצפן, במפתחות שאף פעם אינם אצלנו

אירועים, נוכחות והיסטוריה עוברים מוצפנים במפתחות שהשרת שלכם מחזיק, ושיחות בין שני אנשים מוצפנות מקצה לקצה. הענן מעביר אותם בלי יכולת לקרוא אותם.

חיבור אחד לכל הלשוניות

הלשוניות של דפדפן חולקות חיבור אחד, ולכן אדם עם שלוש לשוניות פתוחות נספר פעם אחת.

שימושים

מה בונים על WebSockets

כל אחד מהם הוא אפליקציה שלמה בתיעוד, עם השרת שלה ב-Node.js,‏ PHP ו-Python.

עדכונים חיים והתראות

הזמנה שמתקדמת בדף שלה, לוח בקרה, התקדמות של משימה, והתראה למשתמש אחד בכל לשונית ואפליקציה.

צ׳אט

שיחות בין שני אנשים ובקבוצות, עם הקלדה, סימוני קריאה ותגובות, שנשמרות במסד הנתונים שלכם.

מי מחובר ומי כאן

נקודה על כל אווטאר, האנשים בחדר עם התפקידים שלהם, וכמה אנשים צופים בדף.

עריכה משותפת

מי נמצא במסמך, הסמנים שלהם והשינויים, שנשלחים כבינארי ונשמרים לחיבור מחדש.

סקרים, חידונים ושאלות

הצבעות ושאלות שמגיעות רק לשרת שלכם, תוצאות שנשלחות לכולם, וניקוד לכל שחקן.

מכירות פומביות חיות

הצעות שהשרת שלכם מכריע בהן אחת אחרי השנייה, המחיר החדש לכולם, ושעון שמתארך כשמגיעה הצעה מאוחרת.

מחירים

מחיר לפי חיבורים, אף פעם לא לפי הודעות

החל מ-$11.99 לחודש עבור 1,000 חיבורים בו-זמניים, בחיוב שנתי, או $14.99 בחיוב חודשי.

התמחור לפי חיבורים בו-זמניים, החל מ-1,000, בחיוב חודשי או שנתי. הודעות ורוחב פס אף פעם לא מחויבים, ומה שהשרת שלכם שולח לא משתמש באף אחד מהחיבורים שלכם.

אותה תוכנית ואותו SDK מביאים גם שיחות וידאו וגם שידור חי, על אותו חיבור.

שאלות

שאלות נפוצות

האם אני צריך שרת WebSocket משלי?

לא. דפדפנים ואפליקציות מחזיקים את החיבורים שלהם פתוחים לשרתים שלנו, ועוד נפתחים כשהאפליקציה גדלה. השרת שלכם רק קובע מי רשאי להצטרף לאן, ושולח כל אירוע בבקשת HTTP קצרה אחת.

האם זה עובד באחסון serverless?

כן. פונקציית serverless לא יכולה להחזיק חיבור פתוח, וכאן היא לא צריכה: היא שולחת כל אירוע בבקשה קצרה אחת, והחיבורים נשארים אצלנו. פונקציות edge וכל אחסון אחר עובדים באותו אופן.

אילו סטאקים יכולים להשתמש ב-WebSocket API?

Next.js ו-Express, Laravel ו-PHP רגיל, Django, FastAPI ו-Flask, Capacitor, iOS ו-Android, לכל אחד מדריך. גם באפליקציות React Native ו-Flutter יש חדרים ונוכחות. שרת בכל שפה אחרת משתמש ב-HTTP API.

האם אני כותב בעצמי את קוד ה-WebSocket?

לא. ה-SDK פותח את החיבור, מתחבר מחדש מעצמו ומצטרף שוב לחדרים שלכם, ואתם מאזינים לאירועים לפי שם. ב-Laravel הוא broadcasting driver, ולכן broadcast() וקובץ הערוצים שלכם נשארים כמו שהם.

מה נחשב לחיבור?

דפדפן או מכשיר שמחובר לענן באותו רגע. הלשוניות של דפדפן אחד חולקות חיבור אחד כשהאפליקציה מגישה את ה-worker של ה-SDK, ומה שהשרת שולח דרך ה-API לא נספר.

מה קורה כשמגיעים למגבלת החיבורים?

עד 20% נוספים עדיין מתחברים, ובעל החשבון מקבל אימייל ב-80% וב-100% מהם, בזמן כדי לעבור לתוכנית גדולה יותר.

מה קורה כשדף מאבד את החיבור?

הוא מתחבר מחדש מעצמו. חדר ששומר היסטוריה נותן לו מה שהחמיץ, לפי הסדר, עד 5 דקות, ודף שנעדר זמן רב יותר מקבל הודעה על כך, כדי שיוכל לקרוא מחדש מהשרת שלכם. ההיסטוריה נועדה רק לחיבור מחדש: מסד הנתונים שלכם שומר את הרשומות שלכם.

מי מחליט מי מצטרף לחדר?

השרת שלכם, עם כלל לכל סוג חדר: מי מצטרף, מה מותר לו לשלוח, ומי רק קורא. הענן אוכף כל תשובה, והשרת שלכם יכול להוציא מישהו מחדר בכל רגע.

האם אתם יכולים לקרוא מה שהאפליקציה שלי שולחת?

לא בחדר פרטי או בחדר נוכחות. האירועים שלו, ההיסטוריה שלו ומי נמצא בו עוברים מוצפנים במפתחות שהשרת שלכם יוצר, והענן מעביר אותם בלי יכולת לקרוא אותם. חדר ציבורי, שכל אחד רשאי להצטרף אליו, עובר בלי הצפנה.

איפה השרתים שלכם?

שרתי הזמן אמת שמעבירים את האירועים שלכם פועלים בגרמניה. שרתי ההעברה ושרתי המדיה לשיחות פועלים בכמה מדינות נוספות.

שאלות על האינטגרציה שלכם? כתבו לנו: אנחנו עוזרים עם ה-SDK, מסך השיחה וה-stack שלכם.