איך מטמיעים ועידות וידאו ב-Next.js

פגישת וידאו נראית כמו תכונה אחת, ובאפליקציית Next.js היא כמה תכונות. צוות פותח את חדר הישיבות שלו, והחברים בו רואים ושומעים זה את זה, כמה אנשים או כמה עשרות, ומשתפים את המסכים שלהם. מישהו מנהל את הפגישה, ויכול להשתיק מיקרופון רועש או להוציא מישהו. עמית שפותח את הדף בזמן שהפגישה מתקיימת צריך להיות בתוכה מיד, ושאר הצוות צריך לשמוע שהיא התחילה, בכל דף שבו הם נמצאים.
הפוסט הזה עובר על כל חלק שאפליקציה אמיתית צריכה, עם דוגמה שלמה ועובדת: Team Space, האינטראנט לצוותים מהמדריך שלנו ל-Next.js, שבו לכל צוות יש חדר ישיבות וערוצים משלו, והעמיתים רואים מי מחובר ומתקשרים זה לזה. אפשר לנסות אותו בהדגמה חיה: היו מיה, ראש צוות העיצוב, והתחילו את הפגישה של הצוות, ואז פתחו את הדף של צוות העיצוב בחלון פרטי בתור אווה, גם היא מצוות העיצוב, והיא בתוך הפגישה ברגע שהדף נפתח.
מה ועידת וידאו צריכה
- הרבה מצלמות בבת אחת. בין שני אנשים, התמונה יכולה לעבור ישירות מדפדפן אחד לשני. בפגישה, כל דפדפן שולח את המצלמה שלו פעם אחת לשרתי מדיה, שמעבירים אותה לכל השאר (איך שרתי מדיה עובדים). החיבורים שלהם נשארים פתוחים לאורך כל הפגישה, ופונקציית serverless לא יכולה להחזיק את זה (למה, ומה עושים עם זה).
- מי רשאי להצטרף, ומי מנהל. כלל בשרת שלכם, עם הנתונים שלכם: חברי הצוות מצטרפים, ראש הצוות מארח, ואף אחד אחר לא נכנס.
- חדר ישיבות בתוך הדף. המצלמה והמסך של כל אחד, הפקדים, ופגישה שנמשכת בזמן שאנשים עוברים בין הדפים של האפליקציה שלכם.
- הכניסה. כפתור שמתחיל את הפגישה או מצטרף אליה, ודף שמכניס אתכם ישר פנימה בזמן שהפגישה מתקיימת.
- הכלים של המארח. להשתיק מישהו, או להוציא אותו.
- לדעת שהיא התחילה. הודעה לצוות, ורשימות של הפגישות שמתקיימות כרגע שמתעדכנות מעצמן.
אפשר לבנות כל אחד מהחלקים האלה בעצמכם, על WebRTC ושרתי מדיה משלכם. או לתת לענן זמן אמת להריץ את המדיה ואת מסך הפגישה, בזמן שהשרת שלכם שומר את החלק היחיד שבאמת שלכם: הכלל. זה מה ש-Team Space עושה, דרך WordPlus Cloud.
הדוגמה: אינטראנט לצוותים
העמיתים עובדים בצוותים, ולכל צוות יש ראש צוות. לכל צוות יש דף משלו: חדר הישיבות שלו, הערוצים שלו, ומי בצוות, כשהמחוברים מופיעים ראשונים. זו אפליקציית Next.js עם App Router, Better Auth ו-Postgres, וחלק זמן האמת שלה הוא כמה קבצים. חמישה צעדים יוצרים את הפגישות שלה.
1. מי רשאי להצטרף, ומי מארח
לכל צוות יש חדר ישיבות, שיחה קבוצתית שנקראת לפי המספר של הצוות: meeting:3. האתר מצהיר עליהם פעם אחת, לפי התבנית הזאת, עם הכלל:
realtime.groupCalls('meeting:{id}', async (user, { id }) => {
if (!(await isMember(id, user))) return false;
const team = await teamOf(id);
return team?.lead === String(user) ? { admin: true } : true;
});חבר בצוות נכנס, וראש הצוות נכנס עם admin: true, שהופך אותו למארח. כל השאר מקבלים false, ודף הצוות שואל את אותו isMember, כך שהדף והפגישה אף פעם לא חלוקים. כשדף מבקש להצטרף, הוא שואל קודם את השרת של האתר עצמו, ב-/api/realtime/calls: אותו route handler שדרכו עוברות השיחות של אתר ההיכרויות (איך מטמיעים שיחות וידאו ב-Next.js). הכלל רץ עם הסשן של האתר עצמו, והדף מקבל אישור לפגישה, חתום בסוד של האפליקציה, או את הסיבה שלא.
2. חדר הישיבות בתוך הדף
הפגישה מופיעה בדף הצוות עצמו, במקום שהדף קובע לה, ובתוכה הכפתור שמתחיל אותה:
export function MeetingRoom({ room, team, people }: Props) {
const rt = useRealtime();
return (
<CallSpot rt={rt} call={room} className="h-[32rem] rounded-2xl">
<p>The {team} meeting room</p>
<GroupCallButton rt={rt} room={room} type="video" title={`${team} meeting`}>
{people.length > 0 ? 'Join the meeting' : 'Start the meeting'}
</GroupCallButton>
</CallSpot>
);
}לפני הפגישה, CallSpot מציג את מה שבתוכו: שם החדר, מי בפגישה עכשיו, והכפתור. ברגע שהעמית הזה בפנים, הפגישה באה במקום כל זה: המצלמות של כולם בתצוגת רשת, מסך משותף בגדול, והפקדים למיקרופון, למצלמה, למסך וליציאה. בדף אחר של האפליקציה, הפגישה נמשכת בחלון בפינה, וחוזרת לכאן כשדף הצוות נפתח שוב. יציאה מהאתר, או טעינה מחדש של הדף, מבקשות קודם אישור.
3. ישר פנימה, ברגע שהדף נפתח
עמית שפותח את הדף בזמן שהפגישה מתקיימת לא אמור ללחוץ על שום דבר. הדף יודע מהשרת שלו אם מישהו בפגישה (צעד 4), ורק אז מעביר לרכיב את join:
const [join] = useState(people.length > 0 ? ('video' as const) : undefined);
<CallSpot rt={rt} call={room} join={join} className="h-[32rem] rounded-2xl">עם join, הרכיב מצטרף לפגישה ברגע שהדף נפתח, כמו שהכפתור היה עושה, והכלל מחליט כמו שהוא מחליט על לחיצה. ההחלטה מתקבלת פעם אחת, כשהדף נפתח, ונשמרת ב-state: מי שעוזב את הפגישה, או שראש הצוות מוציא אותו, נשאר בחוץ כל עוד הדף פתוח. כשאין אף אחד בפגישה, הדף לא מצטרף לשום דבר, והראשון שנכנס מתחיל אותה עם הכפתור.
העמית נכנס כשהמצלמה והמיקרופון כבויים: הוא רואה ושומע את הפגישה מיד, והדפדפן לא מבקש גישה לאף אחד מהם עד שהוא מדליק אותו מהפקדים, כך שפתיחת דף אף פעם לא מפעילה מצלמה בהפתעה. כשאנשים צריכים לדבר מיד כשהם נכנסים, joinWith="microphone" מצרף אותם עם מיקרופון דולק, ו-"microphone camera" עם שניהם. מי שלא רואים או לא שומעים אותו יכול לבדוק עם בדיקת מצלמה ובדיקת מיקרופון שלנו. מה לעשות כשהאתר חסום, כשהתמונה שחורה או כשמוצגת מצלמה לא נכונה מוסבר בפוסט שלנו על תיקון מצלמה.
4. מי בפנים
WordPlus Cloud יודע מי נמצא בכל פגישה, כך שהאתר לא מחזיק לזה שום טבלה:
export async function inMeeting(team: string): Promise<string[]> {
const { list } = await realtime.call(meetingOf(team)).get();
return list.flatMap((person) => (person.user ? [String(person.user)] : []));
}דף הצוות שואל את זה בזמן שהוא נבנה, ומציג את הפנים של מי שבפגישה עם „Mia and Omar are in the meeting”. רשימת הצוותים שואלת את realtime.listCalls() באותה דרך, על כל פגישה שמתקיימת עכשיו וכמה אנשים בכל אחת.
5. פגישה מתחילה, ומי שומע על זה
כשמישהו נכנס לפגישה, WordPlus Cloud שולח לאתר webhook. האתר אומר לכל דף שהפגישות השתנו, וכשזה הראשון שנכנס, הוא מודיע לשאר הצוות:
realtime.on('group.joined', async ({ call, user }) => {
const team = teamIn(call);
if (!team) return;
await realtime.to('meetings').emit('changed');
// The first one in starts it.
const { people } = await realtime.call(call).get();
if (people > 1) return;
const others = (await peopleIn(team)).map((person) => person.id).filter((id) => id !== String(user));
await realtime.toUser(others).emit('meeting', {
team,
name: (await teamOf(team))?.name,
by: await nameOf(String(user)),
});
});toUser() מגיע לכל דף שכל אחד מהם פתח, בכל מכשיר. ב-layout, הדפים שומעים את שניהם:
useUserEvent('meeting', (data: MeetingStarted) => {
if (path === `/teams/${data.team}`) return; // its page shows it already
show(`${data.by} started the ${data.name} meeting`, `/teams/${data.team}`);
});
useRoom('meetings', { changed: () => router.refresh() });הראשון מציג הודעה שפותחת את דף הצוות: „Leo started the Engineering meeting”. השני גורם לכל דף לבקש שוב מהשרת את הרשימות שלו, בלי לטעון מחדש, כך שהדפים תמיד מראים מי באמת נמצא בכל פגישה. גם ה-webhook group.left שולח changed, כשמישהו עוזב.
המארח, בלי קוד שלכם
admin: true בכלל הוא כל מה שהמארח צריך. במסך של ראש הצוות, לכל חלונית של משתתף אחר יש השתקה והוצאה, ומסך השיחה מבקש אותן מ-WordPlus Cloud דרך אותו נתיב, ושם הן מתקבלות רק ממארח. עמית שהושתק יכול להדליק שוב את המיקרופון, ומי שהוצא יוצא מיד. כדי שיישאר בחוץ, הכלל אומר לא.
מה מגיע עם זה
- שיתוף מסך, עם הקול שלו, מהפקדים.
- גם שיחות בין שניים. ב-Team Space, להתכתבות עם עמית יש שיחה משלה, שמוצגת לצד ההודעות, כמו באתר ההיכרויות.
- שמות ופנים מהאפליקציה שלכם. כל חלונית מציגה את השם והתמונה של העמית כפי ש-
profileשל האתר נותן אותם, בלי שום רשימת משתמשים שנשמרת ב-WordPlus Cloud. - שלילת גישה. כשמישהו עוזב צוות, האתר מוציא אותו מיד מהפגישה של הצוות עם
realtime.call(name).remove(user), ומאז הכלל אומר לא.
נסו, ואז בנו משלכם
בהדגמה החיה, העמיתים והצוותים שייכים רק לכם למשך יום, כך שמה שלא תכתבו שם ועם מי שלא תיפגשו, אף אחד אחר לא רואה, ופגישה מסתיימת מעצמה אחרי 10 דקות. בתחתית כל דף, How this page works מראה את הקוד שמפעיל אותו, צעד אחר צעד, עם הערכים של הדף שפתוח אצלכם.
המדריך לאינטראנט הצוותים בונה את כל האתר, עם כל קובץ של צד זמן האמת שלו במלואו, ו-שיחות ב-Next.js מציג כל דרך להכניס שיחה או פגישה לאפליקציה שלכם.
WordPlus Cloud for Apps מתומחר לפי חיבורים בו-זמניים, החל מ-1,000, בחיוב חודשי או שנתי. עם 1,000 חיבורים, שיחות קבוצתיות אינן נמדדות עד 32 אנשים בווידאו בו-זמנית, כשאדם באודיו נספר כחצי, וכל 1,000 חיבורים נוספים מוסיפים 12. מעבר לזה, כל אדם נוסף בווידאו צורך קרדיט לדקה, ושיחות בין שני אנשים לא צורכות אף קרדיט. ראו שיחות וידאו לאפליקציות, או את המחירים לאפליקציות. שאלות על האינטגרציה שלכם? כתבו לנו.