יצירת שאלות מסרטון Stream ב-Moodle

מדריך למרצים ולמעצבי קורסים: מתי מופיע בלוק „יצירת שאלה מתוך סרטון Stream”, אילו סוגי שאלות נתמכים, ואיך הם מתחברים ל־Web Service של Stream (video-subtitle-questions) כולל סוג נכון/לא נכון (true_false).

מתי נראה הפיצ’ר?

הפיצ’ר מופיע בטופס יצירת שאלה חדשה רק כשסוג השאלה הוא אחד מהבאים:

סוג השאלה במודל	שם טכני
רב־ברירה	`multichoice`
תשובה קצרה	`shortanswer`
אמת / שקר	`truefalse`

כשפותחים את אחד מסוגי השאלה האלה, מתווספת לטופס הקטע „יצירת שאלה מתוך סרטון Stream” (מזהה טכני בדף: questionfromstreamheader) – עם רשת סרטונים וכפתור ליצירה אוטומטית.

טופס יצירת שאלה במודל: הקטע „יצירת שאלה מתוך סרטון STREAM” עם רשת סרטונים, הנחיה לבחור סרטון וכפתור יצירת שאלה אוטומטית — דוגמה לממשק: רשת סרטונים (כותרת, משך, מזהה), הנחיה „בחר סרטון מהרשימה…” וכפתור **יצירת שאלה אוטומטית** מתחת לרשת.

חשוב: סוגי שאלות אחרים (חיבור, מאמר, חישוב וכו’) לא יקבלו את הבלוק הזה.

תנאים מוקדמים

הגדרות האתר: צריכות להיות מוגדרות כתובת Stream ו־מפתח API. אם חסר – תופיע התראה בהתאמה.
פרופיל משתמש: לרוב נדרשת כתובת דוא״ל בפרופיל, כדי שהמערכת תטעין את רשימת הסרטונים מהשירות (כפי שמתואר בהודעות השגיאה המובנות).
סרטונים עם כתוביות: ברשימה יופיעו סרטונים הרלוונטיים לחשבון / האימות שלך ב־Stream, ובתנאי שיש בסיס ליצירת שאלות מהכתוביות.

שלבי שימוש (לכל סוג שאלה נתמך)

צרו שאלה חדשה ובחרו את סוג השאלה הרצוי מתוך שלושת הסוגים למעלה.
במקטע „יצירת שאלה מתוך סרטון Stream” – אם יש הרבה סרטונים, ניתן לעבור דפים. במעבר דפים משתמשים בפרמטר ls_uvpage בשורת הכתובת.
בחרו סרטון מהרשימה (לחיצה על כרטיס מסמנת את הסרטון הנבחר).
לחצו על „יצירת שאלה אוטומטית”.
המערכת קוראת לשרת Stream (עם סוג השאלה המתאים), ופותחת במעבר (redirect) את טופס השאלה עם השדות הממולאים מראש.
בדקו וערכו את הניסוח, התשובות והציונים, ואז שמרו את השאלה כרגיל.

אם לא נבחר סרטון לפני הלחיצה – תוצג הודעה על צורך לבחור מהרשימה (מזהה טכני: questionfromstreamselectvideo).

מה נשלח ל־API לפי סוג השאלה?

קוד התוסף במודל ממפה את סוג טופס Moodle לפרמטר question_type בקריאה ל־Stream:

טופס במודל	`question_type` ל־API
רב־ברירה	`multichoice`
תשובה קצרה	`short_answer`
אמת / שקר	`true_false`

בנוסף נשלחים בדרך כלל videoid, count (כרגע 2 בעת הלחיצה מה־JavaScript), ופרמטרים של קטגוריה / קורס / מודול מהטופס – בהתאם להגדרות התוסף והטופס.

מה כל סוג מצפה לקבל מה־API (בקצרה)

שרת Stream מחזיר רשימת שאלות ב־JSON. התוסף בודק שהפריטים תואמים לסוג שנבחר במודל:

רב־ברירה: פריט עם type תואם לשאלת רב־ברירה (multiple_choice), כולל אפשרויות ותשובה נכונה – לפי המפרט של Stream.
תשובה קצרה: פריט short_answer עם טקסט שאלה ו־answer_key (ומקורות תשובה נוספים נתמכים במיפוי בתוסף).
אמת / שקר: פריט true_false עם question ו־correct_answer בוליאני (true או false).

אימות: אם התשובה מה־API לא תואמת את סוג השאלה שנבחר במודל – תוצג אחת מהודעות השגיאה המתאימות (למשל אין שאלת רב־ברירה / תשובה קצרה / אמת־שקר תקינה).

הערות נוספות

קישור למילוי מראש: הקישור הוא חד־פעמי וקצר בזמן (מבוסס טוקן ב־session). אם פג התוקף או ניסיתם לפתוח ידנית קישור לא תקף – חזרו לשלב בחירת הסרטון ויצרו שוב.
טיוטה: לאחר המילוי האוטומטי השאלה נשמרת כטיוטה שכדאי לעבור עליה לפני שמירה סופית.
כינויים ב־API: בקריאה ישירה ל־Web Service ניתן להשתמש גם בכינויים (למשל mc, short, tf) – בממשק Moodle נעשה שימוש בערכים הנורמליים למעלה.

למבנה המלא של נקודת הקצה והשדות ראו בתיעוד המפתחים בקובץ webservice/video_subtitle_questions.php בפרויקט Stream.