למפתחי תוכנה ומשחקים

BioSignals Real-Time Developer Interface

קריאת נתוני פסיכופיזיולוגיה בזמן אמת דרך Localhost:8080

מבוא

מערכת BioSignals מאפשרת למפתחי תוכנה, מפתחי משחקים, מפתחי VR/XR, חוקרים ומפתחי אפליקציות לקרוא בזמן אמת מידע פסיכופיזיולוגי של המשתמש באמצעות ממשק מקומי פשוט.

האפליקציה של BioSignals רצה ברקע על המכשיר, מפעילה שרת WebSocket מקומי, ומשדרת נתונים דרך:

ws://localhost:8080

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

המטרה היא לאפשר למפתחים לבדוק את הטכנולוגיה של BioSignals גם ללא רכישת חומרה, באמצעות מצב Demo Signals המובנה באפליקציות.

למי מיועד הממשק?

הממשק מיועד ל:

  • מפתחי משחקים
  • מפתחי Unity
  • מפתחי Unreal Engine
  • מפתחי VR ו-XR
  • מפתחי Meta Quest
  • מפתחי Android
  • מפתחי iPhone / iOS
  • חוקרי ביופידבק
  • חוקרי פסיכופיזיולוגיה
  • חברות Digital Health
  • מפתחי אפליקציות מדיטציה, סטרס, נשימה ואימון אישי
  • מפתחי AI Agents ו־AI Coaches

באמצעות הממשק ניתן לבנות אפליקציות המגיבות בזמן אמת למצב הפיזיולוגי של המשתמש.

לדוגמה:

  • משחק אימה שמשנה עוצמה לפי דופק וסטרס.
  • אפליקציית מדיטציה שמתאימה את ההנחיות לפי נשימה ו-HRV.
  • סביבת VR טיפולית שמשתנה לפי רמת הרגיעה.
  • מאמן כושר שמגיב לעומס פיזיולוגי.
  • AI Companion שמבין טוב יותר את מצבו של המשתמש.
  • סימולטור אימון שמעלה או מוריד קושי לפי תגובת הגוף.

עיקרון הפעולה

הארכיטקטורה פשוטה:

BioSignals App

     │

     │  Demo signals or real sensor data

     ▼

Local WebSocket Server

     │

     │  ws://localhost:8080

     ▼

Developer App / Game / VR Experience

האפליקציה של BioSignals אחראית על:

  • התחברות למשתמש.
  • הפעלת מצב דמו או מצב חיישנים אמיתי.
  • קריאת אותות פיזיולוגיים.
  • עיבוד ראשוני של הנתונים.
  • שידור רציף של הנתונים ל־localhost:8080.

האפליקציה של המפתח אחראית על:

  • התחברות ל־WebSocket.
  • קריאת הודעות JSON.
  • פירוש הנתונים.
  • שימוש בנתונים לצורך שינוי חוויית המשתמש.

הורדת אפליקציות    BioSignals

ניתן לבדוק את הטכנולוגיה בחמש סביבות מרכזיות:

Android

Google Play:

https://play.google.com/store/apps/details?id=com.biosignals.bio2

iPhone / iOS

Apple App Store:

https://apps.apple.com/us/app/biosignals-personal-trainer/id6523415317

Meta Quest

Meta Quest Store:

https://www.meta.com/experiences/biosignals/25477115675295682/

מחשב PC - הורדת תוכנת מחשב - אין נתוני דמו - רק עם חיישן אמיתי

מחשב MAC - הורדת תוכנת MAC - אין נתוני דמו - רק עם חיישן אמיתי

פרטי התחברות לדמו

לאחר התקנת האפליקציה יש להתחבר באמצעות פרטי הדמו:

Email: demo@demo.com

Password: 1

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

  מהו מצב Demo Signals

מצב Demo Signals מאפשר למפתח לבדוק את האינטגרציה ללא חומרת BioSignals.

במצב זה האפליקציה מייצרת נתונים פיזיולוגיים מדומים, אך במבנה זהה או דומה לנתונים האמיתיים שמגיעים מהחיישנים.

המשמעות:

  • ניתן לבדוק קוד לפני רכישת חומרה.
  • ניתן לפתח משחקים ואפליקציות מראש.
  • ניתן לבדוק UI, גרפים, אנימציות ותגובות בזמן אמת.
  • ניתן לבצע הדגמות למשקיעים, לקוחות וצוותי פיתוח.
  • ניתן לבדוק חיבור ל־Unity, JavaScript, Python או כל שפה אחרת שתומכת ב־WebSocket.

 כתובת    WebSocket

כתובת ברירת המחדל:

ws://localhost:8080

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

במקרה של Meta Quest, אפליקציית Quest אחרת או סביבת Unity שרצה על המכשיר יכולה להתחבר לשרת המקומי.

במקרה של Android, אפליקציה מקומית או כלי פיתוח מתאים יכולים לקרוא את הנתונים.

במקרה של iPhone, יש לבדוק את מגבלות iOS לגבי גישה מקומית בין אפליקציות ולתעד את אופן העבודה המדויק לפי גרסת האפליקציה וההרשאות.

מבנה JSON כללי

json data description:

 

"srl":"serial_number"

"tmr":"transmission timer"

"bv" :"blood volume pulse"      BVP

"bpH":"blood pressure changes"  BPHEG

"gs" :"Galvanic Skin Response"  GSR

"re" : "SPO2"

"re2": "HR low resolution calculation"

 

 

 

each one sec this is the data arrive: (6 X 10 samples per second = total 60 times per second).

 

    {"err":"0","err_msg":"","srl":"1025","values":[

          {"tmr":"1030650","bv":"2552","gs":"0","re":"12615","re2":"9786","tmp":"2577","bpH":"4516","pr":"0","pr2":"0","sp2":"100"},

          {"tmr":"1030666","bv":"2524","gs":"0","re":"12615","re2":"9765","tmp":"2577","bpH":"4515","pr":"0","pr2":"0","sp2":"100"},

           {"tmr":"1030683","bv":"2492","gs":"0","re":"12615","re2":"9757","tmp":"2577","bpH":"4514","pr":"0","pr2":"0","sp2":"100"},

          {"tmr":"1030700","bv":"2448","gs":"0","re":"12616","re2":"9763","tmp":"2577","bpH":"4513","pr":"0","pr2":"0","sp2":"100"},

          {"tmr":"1030716","bv":"2404","gs":"0","re":"12616","re2":"9784","tmp":"2577","bpH":"4512","pr":"0","pr2":"0","sp2":"100"},

          {"tmr":"1030733","bv":"2356","gs":"0","re":"12616","re2":"9788","tmp":"2577","bpH":"4511","pr":"0","pr2":"0","sp2":"100"}]},

   

 

each time the app found a new heart beat, this data arrive:

    {"err":"0","err_msg":"","srl":"1025","values":[

          {"tmr":"1031250","h_p_e":"0.156000","h_p_t":"0.156000","h_po_e":"18.587852","h_p_nu_e":"34.815174","h_p_nu_t":"30.075554","h_p_p_e":"28.303576","h_p_p_t":"5.433447","h_p_t":"41.686947","hr":"0","l_d_hf_p_e":"1.872311","l_d_hf_p_t":"2.324960","l_p_e":"0.117000","l_p_t":"0.050700","l_p_e":"34.802238","l_p_nu_e":"65.184830","l_p_nu_t":"69.924446","l_p_p_e":"52.993092","l_p_p_t":"12.632545","l_p_t":"96.920464","m_r_e":"0.666204","m_r_t":"0.676072","n50_e":"5","n50_t":"12","p1":"780","p1_d":"0","p1_p":"0","p2":"224","rm_e":"0.028380","rm_t":"0.017235","s":"1856","sd_e":"0.042297","sd_t":"0.046535","sp2":"0","t1":"816","t2":"200","t3":"500","t4":"616","v":"80","v_p_e":"0.000000","v_p_t":"0.007800","v_p_e":"12.283069","v_p_p_e":"18.703331","v_p_t":"628.620972"},

 

 

 

 

 

"h_p_e" = hf_peak_epoch

"h_p_t" = hf_peak_total

"h_po_e" = hf_power_epoch

"h_p_nu_e" = hf_power_nu_epoch

"h_p_nu_t" = hf_power_nu_total

"h_p_p_e" = hf_power_prcnt_epoch

"h_p_p_t" = hf_power_prcnt_total

"h_p_t" = hf_power_total

"hr" = hr

"l_d_hf_p_e" = lf_div_hf_prcnt_epoch

"l_d_hf_p_t" = lf_div_hf_prcnt_total

"l_p_e" = lf_peak_epoch

"l_p_t" = lf_peak_total

"l_p_e" = lf_power_epoch

"l_p_nu_e" = lf_power_nu_epoch

"l_p_nu_t" = lf_power_nu_total

"l_p_p_e" = lf_power_prcnt_epoch

"l_p_p_t" = lf_power_prcnt_total

"l_p_t" = lf_power_total

"m_r_e" = mean_rr_epoch

"m_r_t" = mean_rr_total

"n50_e" = nn50_epoch

"n50_t" = nn50_total

"p1" = p1

"p2" = p2

"rm_e" = rmssd_epoch

"rm_t" = rmssd_total

"s" = s

"sd_e" = sdnn_epoch

"sd_t" = sdnn_total

"sp2" = spo2

"t1" = t1

"t2" = t2

"t3" = t3

"t4" = t4

"v" = v

"v_p_e" = vlf_peak_epoch

"v_p_t" = vlf_peak_total

"v_p_e" = vlf_power_epoch

"v_p_p_e" = vlf_power_prcnt_epoch

"v_p_t" = vlf_power_total

 

ניתן לראות נתונים חיים מוקרנים בזמן ריצה בכתובת הזו:

https://biosignals.co.il/training/Real_Time_live_parameters.html

 

מגבלות ואחריות

המידע המשודר מיועד לפיתוח, הדגמה, מחקר, ביופידבק, אימון אישי וחוויות אינטראקטיביות.

אין לראות במידע אבחון רפואי.

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

 תהליך בדיקה מומלץ למפתח

  1. התקן את אפליקציית BioSignals על Android, iPhone או Meta Quest
  2. התחבר עם:   demo@demo.com      password: 1
  1. הפעל Demo Signals
  2. ודא שהאפליקציה משדרת ל־localhost:8080.
  3. פתח את דף ה־ JavaScript Demo או את Unity Demo  
  4. התחבר לכתובת:  ws://localhost:8080
  1. ודא שמתקבל JSON בזמן אמת.
  2. חבר את הערכים לאובייקטים, גרפים, UI או מכניקת משחק.
  3. בדוק התנהגות כאשר איכות האות נמוכה או כאשר אין חיבור.
  4. לאחר בדיקה עם Demo Signals ניתן לעבור לחיישנים אמיתיים של BioSignals.

סיכום

 BioSignals  מאפשרת למפתחים להפוך נתונים פיזיולוגיים בזמן אמת לחלק פעיל מחוויית המשתמש.

באמצעות התקנת אפליקציית BioSignals, התחברות למשתמש הדמו וקריאה פשוטה מ־ localhost:8080,  ניתן לבנות דור חדש של אפליקציות ומשחקים המגיבים לדופק, סטרס, נשימה, HRV, מוליכות עור ומדדים נוספים.

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

 

השאירו פרטים ונחזור אליכם בהקדם

דלג לתוכן מרכזי