סקירה כללית

"קישור למכשירים בקרבת מקום" הוא ממשק API לרשתות מסוג P2P שמאפשר לאפליקציות לגלות מכשירים בקרבת מקום, להתחבר אליהם ולהחליף איתם נתונים בקלות ובזמן אמת, בלי קשר לחיבור לרשת.

דוגמאות לתרחישי שימוש:

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

מבוא

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

אחת מהמטרות העיקריות של ה-API הזה היא לספק פלטפורמה פשוטה, אמינה ובעלת ביצועים טובים. מאחורי הקלעים, ה-API משתמש בשילוב של טכנולוגיות Bluetooth,‏ BLE ו-Wi-Fi, תוך ניצול היתרונות של כל אחת מהן ועקיפת החולשות שלהן. ה-API הזה מסתיר את המורכבות של Bluetooth ו-Wi-Fi במגוון פלטפורמות וגרסאות של מערכות הפעלה, ומאפשר למפתחים להתמקד בתכונות שחשובות למשתמשים שלהם.

סקירה כללית על ממשקי API

השימוש ב-API מתחלק לשני שלבים: לפני החיבור ואחרי החיבור.

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

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

פרסום וגילוי

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

יצירת קשרים

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

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

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

החלפת נתונים

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

עכשיו שני הצדדים יכולים להחליף נתונים. יש 3 סוגים של מטענים ייעודיים נתמכים:

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

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

החיבורים שנוצרים הם מסוג full-duplex, כלומר המפרסמים והמגלים יכולים לשלוח ולקבל נתונים בו-זמנית.

איסוף נתונים

כשמשתמשים ב-Nearby SDK של Google Play Services, נאספים נתוני ניתוח שימוש כדי לשפר את חוויית השימוש.

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

משתמשי הקצה יכולים לאשר או לדחות את האיסוף הזה דרך "הגדרות" > Google > "דפוסי שימוש וביצועים".