בלוג

איך לממש שיחות וידאו ב-Next.js

· Andrij Tkachenko · 5 דקות קריאה

שני חלונות דפדפן זה לצד זה, בכל אחד מהם האדם השני בווידאו וצ׳אט לצידו, ולב שמחבר ביניהם

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

רוב המדריכים עוצרים בשני דפדפנים באותו דף שמחליפים offers באופן ידני. הפוסט הזה עובר על כל חלק שאפליקציה אמיתית צריכה, עם דוגמה מלאה שעובדת: אתר ההיכרויות מהמדריך שלנו ל-Next.js, שבו שני משתמשים יוצאים לדייט בווידאו בתוך הצ׳אט שלהם. אפשר לנסות אותו בהדגמה חיה: בחרו בתור מי להיכנס, פתחו אותו בחלון פרטי, בחרו מישהו אחר, והתקשרו.

מה שיחת וידאו צריכה

  • איתות וצלצול. לפני שמופיעה תמונה כלשהי, שני הדפדפנים מחליפים offers ומועמדי רשת דרך שרת, והשיחה צריכה לצלצל אצל מי שמקבל אותה בכל לשונית שפתוחה אצלו. לשם כך צריך חיבורים שנשארים פתוחים כל הזמן, ופונקציית serverless לא יכולה להחזיק אותם (למה, ומה עושים עם זה).
  • דרך בין הדפדפנים. ישירות כשהרשתות שלהם מאפשרות זאת, ודרך ממסר כשלא (הסבר על שרתי STUN ו-TURN).
  • מי רשאי להתקשר למי. כלל בשרת שלכם, עם הנתונים של האפליקציה שלכם, שנבדק עוד לפני שמשהו מצלצל אצל מישהו.
  • המצלמה והמיקרופון. בקשת הרשאה אחת מהדפדפן, החלפת מכשירים, השתקה וכיבוי מצלמה.
  • מסך שיחה. צלצול, מענה ודחייה, הווידאו של שני הצדדים, משך השיחה, ניתוק.
  • שרתי מדיה, ברגע שיש בשיחה יותר משני אנשים (איך שיחות קבוצתיות עובדות).

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

הדוגמה: דייטים בווידאו באתר היכרויות

המשתמשים באתר מוצאים את האנשים שהם מחפשים, רואים מי מחובר, מתכתבים ויוצאים לדייט בווידאו לפני שהם נפגשים פנים אל פנים. זו אפליקציית Next.js עם App Router ו-Postgres, וחלק זמן האמת שלה הוא כמה קבצים בלבד. ארבעה שלבים בונים את השיחות שלה.

1. מי רשאי להתקשר למי

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

lib/realtime.ts
realtime.calls('chat:{id}', async (user, other, { id }) => {
    // The one asking: who calls, as they call, or who is called, as they answer.
    const userMayChat = await mayChat(user, id);
    // The other one of the call.
    const otherMayChat = await mayChat(other, id);
    return userMayChat && otherMayChat;
});

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

2. איפה הכלל רץ

כשדף מבקש להתקשר, או לענות, הוא שואל קודם את השרת של האתר עצמו, ב-route handler:

app/api/realtime/calls/route.ts
import { currentUserId } from '@/lib/auth';
import { realtime } from '@/lib/realtime';

export async function POST(request: Request) {
    // JSON only, which a page of another site can't send here.
    if (!request.headers.get('content-type')?.includes('application/json')) {
        return new Response(null, { status: 415 });
    }
    const ask = await request.json();
    const user = await currentUserId();
    const pass = await realtime.authorizeCall(ask, user);
    return Response.json(pass);
}

currentUserId() היא ההתחברות של האתר עצמו, כך שה-session עובד כאן כמו בכל דף. כשהכלל עונה כן, הדף מקבל אישור שחתום בסוד של האפליקציה, ואיתו WordPlus Cloud מצלצל אצל האדם השני. ה-route עונה בבקשה קצרה אחת, ובדיוק בזה אחסון serverless טוב.

3. צלצול בכל דף

ה-layout של הדפים שדורשים התחברות מתחבר פעם אחת, ומרנדר את מסך השיחה לצד הדפים:

app/(app)/screens.tsx
'use client';

import '@wordplus/realtime-ui/calls.css';
import '@wordplus/realtime-ui/chat.css';
import { useRealtime } from '@wordplus/realtime/react';
import { CallScreen } from '@wordplus/realtime-ui/react';

export function Screens() {
    return <CallScreen rt={useRealtime()} />;
}

<Screens /> יושב בתוך RealtimeProvider ב-app/(app)/layout.tsx, כך ששיחה מצלצלת בכל דף שמשתמש פתח, בכל לשונית ובכל מכשיר, ומפסיקה לצלצל בכולם ברגע שעונים לה באחד מהם. מסך השיחה הוא זה של Better Messages, והוא מצויר בעץ ה-React של האתר עצמו, כך שה-CSS של האתר חל עליו.

4. השיחה בתוך הצ׳אט שלה

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

app/(app)/members/[id]/chat.tsx
<Chat
    rt={useRealtime()}
    room={room}
    to={to}
    name={name}
    avatar={avatar}
    call
    startCall={start}
/>

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

הצ׳אט הוא רק אחד מהמקומות לשיחה. CallButton מתחיל שיחה מכל מקום, CallSpot מציג שיחות בחלק של הדף שאתם בוחרים, ו-useCalls נותן לכם כל שיחה כדי לצייר מסך משלכם.

מה מקבלים איתה

  • בקשת הרשאה אחת. הדפדפן מבקש פעם אחת גישה למצלמה ולמיקרופון יחד. אם מישהו לא נראה או לא נשמע, שלחו לו את בדיקת המצלמה ואת בדיקת המיקרופון שלנו. אם הבעיה במצלמה, המדריך שלנו למצלמה שלא עובדת עובר על כל סיבה, מאתר חסום ועד אפליקציה אחרת שמשתמשת בה.
  • היא תמיד מתחברת. שיחה בין שני אנשים עוברת ישירות בין הדפדפנים שלהם כשאפשר, דרך ממסרים בפורטים שכל רשת משאירה פתוחים כשאי אפשר, ודרך שרתי מדיה כשאפילו הממסרים לא מצליחים להגיע, ועוברת ביניהם בלי להתנתק, מוצפנת בכל נתיב.
  • היא לא נופלת. החיבור, ואיתו השיחה, נשארים כשהמשתמש עובר בין דפי האתר.
  • שיחות קבוצתיות על אותו API. חדר עם יותר אנשים רץ על שרתי מדיה, עם כפתור ומסך משלו לשיחה קבוצתית (שיחות וידאו לאפליקציות).

נסו, ואז בנו משלכם

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

המדריך לאתר ההיכרויות בונה את כל האתר, עם כל קובץ של צד זמן האמת שלו במלואו, ו-שיחות ב-Next.js מציג כל דרך להתחיל שיחה באפליקציה שלכם.

WordPlus Cloud for Apps מתומחר לפי חיבורים בו-זמניים, החל מ-1,000, בחיוב חודשי או שנתי. ראו מה הוא עושה לאפליקציות, או את המחירים לאפליקציות. שאלות על האינטגרציה שלכם? כתבו לנו.