וידאו בשידור חי

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

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

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

המטרה העיקרית שלנו עם התכונה הזו היא לספק למשתמשים:

  • חוויית צפייה חלקה בסרטונים בשידור חי, ללא הרשאות מסובכות
  • חוויה עקבית לכל משתמשי Android

איך זה עובד

תרשים של זרימת הנתונים בשידור וידאו ב-ELS, שבו רואים איך שיחת חירום או הודעת טקסט ממשתמש Android מפעילות את ELS, כולל טוקן חדש של שידור וידאו בשידור חי. כאשר תוכנת קבלת השיחות מזהה את האסימון הזה ומעבירה אותו בחזרה למשתמש Android בהודעת SMS עם קישור לסטרימינג של וידאו בשידור חי ב-WebRTC, ‏ ELS יכולה לספק חוויית וידאו משולבת.

מדריך שילוב

1. תפיסות

אחרי שתעדכנו את הגדרת ה-ELS כדי להפעיל את הווידאו בזמן אמת, תתחילו לקבל את השדה live_video_token בהודעות ELS של HTTPS כשהטלפון של המשתמש תומך בתכונה. התכונה נתמכת במכשירים עם Android 8 Oreo ואילך.

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

  • 6 תווים אקראיים
  • אלפאנומרי
  • אותיות רישיות

2. הזמנה

כשמזהים את הטוקן, מעבירים אותו בכתובת ה-URL, למשל כפרמטר של כתובת ה-URL, בהודעת ה-SMS שמכילה את הקישור לשידור הווידאו, לדוגמה: https://example.com/live?token=AFZ791. ‫ELS יזהה הודעות SMS נכנסות במהלך שיחות או הודעות טקסט למקרה חירום, ויחפש את אסימון הווידאו התואם בשידור חי, במקרה הזה: AFZ791.

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

3. חוויית הצפייה בסרטונים בשידור חי

הקישור לשידור החי צריך לתמוך בשני סוגי חוויות:

א. חוויה מבוססת דפדפן אינטרנט:

לדוגמה, ממשק משתמש מותאם אישית משלכם:

  • כפתורים
  • בקשות מיקום
  • תיבות דו-שיח והסכמות

ב. חוויה משולבת:

כדי לעשות את זה, צריך:

  • הסרת כל הלחצנים כי אירועי מגע לא יעבדו
  • התחלת השידור ישירות בסטרימינג של הווידאו ללא תיבות דו-שיח

זיהוי

אפשר לזהות את המצב המשולב על ידי התבוננות בסוכן המשתמש שמכיל את המחרוזת Live.

דוגמה לסוכן משתמש בחוויית שימוש בדפדפן בנייד: Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Mobile Safari/537.36

דוגמה לסוכן משתמש בחוויית WebView משולבת: Mozilla/5.0 (Linux; Android 10; K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/125.000 Mobile Safari/537.36 Live/25.23.10

ב-JavaScript אפשר לעשות את זה באמצעות הקוד הבא:

if (navigator.userAgent.includes("Live")) {
    <!-- Render integrated experience -->
} else {
    <!-- Render your your own custom UI -->
}

הרשאות

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

תוכן מושך

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

שם הפונקציה חזרה תיאור
מצלמה switchCamera Promise<bool> בטעינה, מתחילים עם המצלמה האחורית (מצב צילום = סביבה) כי היא הכי שימושית במצבי חירום. החלפה בין המצלמות הזמינות בכל פעם שהפונקציה מופעלת. החזרה true אם המעבר למצלמה בוצע בהצלחה.
פנס toggleFlashlight Promise<bool> הפנס יופעל או יושבת בכל פעם שתתבצע קריאה לפונקציה. החזרת true אם ההחלפה של מצב הפנס הצליחה.
פנס isFlashlightAvailable bool הפונקציה מחזירה true או false בהתאם לזמינות של הפנס במצב המצלמה הנוכחי. אחרי קריאה ל-switchCamera, מניחים שערך ההחזרה משקף את מצב הזמינות המעודכן ברגע ש-Promise של switchCamera נפתר.
פנס isFlashlightOn bool הפונקציה מחזירה true אם הפנס פועל, ו-false אם הוא לא פועל. אחרי קריאה ל-toggleFlashlight, מניחים שערך ההחזרה משקף את המצב המעודכן של הפנס ברגע ש-toggleFlashlight's Promise נפתר