פיתוח פרטי |🎙️ עריכת פרטי קובץ ישירות מהטלפון ובשלוחות השמעה

[CUBASE]

שלום לכולם!

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

המטרה של המודול היא לתת מענה מלא למצבים שבהם רוצים לעדכן נתונים של קובץ (כמו מספר הטלפון של המקליט, מספר המערכת, תאריך ושעה, זיהוי או שם מקליט) מבלי להיות תלויים בשום אמצעי חיצוני - אלא מתוך השיחה הטלפונית עצמה!

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

---

אופן הפעולה ואפשרויות השילוב

המודול תומך בשני אופני שימוש עיקריים:

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

---

️ אפשרות א': הטמעה בתוך שלוחת השמעת קבצים (מומלץ ונוח ביותר)

כאשר מטמיעים את המודול בשלוחת השמעת קבצים, אין צורך להגדיר את הפרמטר what – שלוחת ההשמעה מעבירה אוטומטית ל-API את הקובץ המושמע באותו רגע.

אם מגדירים מראש ערך קבוע (כמו בדוגמה למטה), המודול יבצע את הפעולה ישירות ברקע ללא שום תפריט או שאלות!

הגדרת חובה בסיסית בהשמעת קבצים:

api_link=https://file-details-editor.smartel.workers.dev

; טוקן המערכת
api_add_0=token=מפתח API (מומלץ) או מספר מערכת:סיסמה

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

באפשרותכם להחליט כיצד המאזין יפעיל את העדכון מתוך שלוחת ההשמעה:

הפעלה במקש ישיר בעת ההשמעה (לדוגמה מקש 4):

; הפעלת ה-API בלחיצה על מקש 4 במהלך ההשמעה
control_play4=send_api

הפעלה במקש מתפריט אפשרויות נוספות (בד"כ *) :

; הפעלת ה-API מתפריט אפשרויות נוספות
control_play_moreA8=send_api

הפעלה אוטומטית בסיום השמעת הקובץ:

; הפעלת ה-API מיד עם סיום השמעת הקובץ
after_play=send_to_api

---

️ אפשרות ב': הגדרה כשלוחת API עצמאית

אם ברצונכם להגדיר שלוחה ייעודית שתפקידה לערוך קבצים, הגדירו את השלוחה כ-API:

; הגדרת סוג שלוחה
type=api

; קישור למודול
api_link=https://file-details-editor.smartel.workers.dev

; טוקן המערכת
api_add_0=token=מפתח API (מומלץ) או מספר מערכת:סיסמה

; נתיב השלוחה שבה נמצאים הקבצים
api_add_1=what=/1/2

בחירת הקובץ לעריכה בשלוחה עצמאית:

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

• הקובץ האחרון בשלוחה:

; עריכת הקובץ האחרון שהוקלט בשלוחה
api_add_2=file=last

• הקובץ האחרון של המטלפן הנוכחי:

; עריכת ההקלטה האחרונה של המטלפן בשלוחה זו
api_add_2=file=last_for_caller

• קובץ ספציפי קבוע מראש (שימו לב ששם ההגדרה שונה):

; ציון נתיב ישיר לקובץ
api_add_1=what=/1/2/001.wav

---

️ שיטות לעדכון נתוני הקובץ

המודול גמיש מאוד ומאפשר לעדכן את השדות במגוון דרכים:

1. תפריט בחירה קולי

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

1. מספר מערכת (CustomerDID)
2. מספר טלפון של המקליט (Phone) (הערה: אם זיהוי ה-enter_id זהה למספר הטלפון, הוא יסונכרן ויתעדכן אוטומטית למספר החדש)
3. תאריך ושעת ההקלטה (Date)
4. זיהוי מקליט ההודעה (EnterID)
5. שם המקליט בהקלדה (ValName)

2. בקשת הקשה מהמאזין עבור שדה מסוים (type)

אם תרצו לדלג על התפריט ולבקש מהמאזין להקיש ישירות ערך חדש, הגדירו את הערך כ-type:

; בקשה מהמאזין להקיש מספר טלפון חדש
api_add_3=Phone=type

שרשור ערכים: ניתן להגדיר type על כמה שדות במקביל! במצב כזה, המערכת תבקש מהמאזין להקיש אותם אחד אחרי השני ברצף:

; בקשת מספר טלפון ומיד לאחר מכן בקשת שם
api_add_3=Phone=type
api_add_4=ValName=type

3. קביעת ערך קבוע מראש

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

; עדכון אוטומטי של מספר המערכת
api_add_3=Phone=0501234567

4. מחיקת נתון

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

; מחיקת שם המקליט מהקובץ
api_add_3=ValName=

---

השתקת הודעות ושמע

• בסיום פעולה מוצלחת, המערכת משמיעה כברירת מחדל את הודעה M2573 ("הפעולה בוצעה בהצלחה").
• אם ברצונכם להשתיק את ההודעה כדי שהפעולה תסתיים בשקט מוחלט (למשל ברקע בהשמעת קבצים):

; השתקת הודעת סיום
muted_M2573=yes

---

מוזמנים להטמיע במערכות שלכם, לבדוק ולשתף כאן בתגובות איך זה עובד לכם!