פיתוח פרטי | לייק ודיסלייק בהשמעת קבצים 👍/👎

CUBASE

שלום לכולם!

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

מה החידושים והיתרונות של המודול?

שיטת דירוג עדכנית: במקום מערכת הדירוג המובנית והישנה של 1 עד 5 כוכבים, המאזינים שלכם יכולים לפרגן בלייק או דיסלייק בצורה פשוטה, אינטראקטיבית ומוכרת.
הקראה טבעית וחכמה: המערכת יודעת לדבר נכון! אם יש רק לייק אחד, היא תגיד "לייק אחד". אם יש רק דיסלייקים – היא תשמיע רק אותם. ואם יש גם וגם, היא תדע לחבר ביניהם בטבעיות עם האות "ו...".
דירוג לפני ההשמעה: פיצ'ר חדש! ניתן להגדיר שהמאזין ישמע את הדירוג של הקובץ עוד לפני שההשמעה מתחילה.
מבנה תפריט חדש וחכם: כשמאזין נכנס לדירוג, המערכת תגיד לו קודם כל מה ההצבעה הנוכחית שלו, וכעת יש לו גם אפשרות לבטל את ההצבעה.
מניעת הצבעות כפולות ומניפולציות: המערכת חכמה! מאזין לא יכול להצביע לקובץ שהוא עצמו העלה, ולא ניתן לדרג ללא זיהוי טלפוני.
מנגנון חכם לאיפוס דירוג: ברגע שאתם מוחקים קובץ ומעלים חדש במקומו, הדירוג מתאפס אוטומטית ולא "נדבק" לקובץ החדש.
מדבר בעצמו (TTS): כברירת מחדל, המערכת משתמשת בהקראת טקסט אוטומטית (ניתן גם להעלות קבצי שמע שלכם למי שרוצה - פירוט בהמשך).

️ שלב 1: הגדרות הבסיס (חובה)

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

api_link=https://moduls.smartel.workers.dev/ratingPlayfile.php
api_add_0=token=טוקן

️ שלב 2: בחירת מקש ההפעלה

כעת, בחרו אחת מהאפשרויות הבאות כדי לקבוע באיזה שלב המאזין יוכל לדרג את הקובץ, והוסיפו את השורה לשלוחה:

אפשרות 1 - מקש ישיר תוך כדי השמעה (לדוגמה מקש 7):
control_play7=send_api
אפשרות 2 - דרך תפריט "אפשרויות נוספות" (לדוגמה הקשת *8):
control_play_moreA8=send_api
אפשרות 3 - מעבר אוטומטי מיד לאחר סיום שמיעת הקובץ:
after_play=send_to_api

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

️ שלב 3: שדרוגים והתאמות אישיות (רשות)

רוצים להתאים את המודול בדיוק לצרכים שלכם? הוסיפו את השורות הבאות.
(שימו לב: יש להחליף את ה-X במספרים רצים בהתאם להגדרות שלכם).

רוצים שהמאזינים ישמעו את הדירוג לפני תחילת ההשמעה?
(המודול יעדכן אוטומטית את קובץ ה-TitleVoice בכל פעם שתהיה הצבעה). חובה להוסיף את שתי השורות הבאות:

api_add_X=say_rating_first=yes
say_title_voice=yes

רוצים לאפשר רק פרגונים? (הצבעת "לייק" בלבד, ללא דיסלייק):

api_add_X=like_only=yes

חסימת שינוי הצבעה (לייק/דיסלייק אחד בלבד למאזין):

api_add_X=allow_change_vote=no

הסתרת כמות הדיסלייקים מהמאזינים:

api_add_X=say_dislikes=no

🤫 הסתרת כל נתוני הדירוג מהמאזינים (הצבעה שקטה):

api_add_X=say_rating=no

️ ביטול ההקראה האוטומטית (TTS) ושימוש בקבצי שמע שלכם:

api_add_X=say_tts=no

(אם הוספתם את השורה הזו - חובה לעבור לשלב 4).

שלב 4: העלאת קבצי שמע (רק למי שהגדיר `say_tts=no`)

אם בחרתם להשתמש בקול שלכם, עליכם להעלות את קבצי השמע הבאים לתיקייה ייעודית בנתיב הראשי של המערכת:
/Smartel/Messages/
(אם התיקייה לא קיימת במערכת שלכם, פשוט צרו אותה).

רשימת הקבצים המעודכנת הנדרשת:

S1000 לייקים
S1001 דיסלייקים
S1002 להשמעה זו יש דירוג של...
S1003 ההצבעה שלכם היא...
S1004 לייק
S1005 דיסלייק
S1006 עדיין לא הצבעתם
S1007 להצבעת לייק הקישו 1, להצבעת דיסלייק הקישו 2, לביטול ההצבעה הקישו 3
S1008 להצבעת לייק הקישו 1, לביטול ההצבעה הקישו 2 (למי שהגדיר לייק בלבד)
S1009 לחזרה להשמעה הקישו כוכבית
S1100 קובץ זה עדיין לא דורג
S1101 לא ניתן להצביע לקובץ שהעליתם בעצמכם
S1102 לדירוג הקישו 1, לשמיעת הדירוגים הקישו 2, להמשך הקישו 3 או המתינו
S1103 אין זיהוי טלפוני. לא ניתן לדרג
S1104 על פי רישומי המערכת כבר דירגתם את ההשמעה הזו
S1105 ההצבעה התקבלה בהצלחה

להורדת קבצי השמע המוכנים

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