איתור מכשירים ברשת באמצעות ממשקי API של שכבת נתונים

המכשירים יכולים להתחבר לאינטרנט ישירות באמצעות Wi-Fi או חיבור לרשת סלולרית, או באופן עקיף באמצעות מכשיר Bluetooth מותאם.

צמתים נגישים ובקרבת מקום

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

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

פעילויות שמשפיעות על משך הזמן של החיבור מחדש

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

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

גילוי כל המכשירים באמצעות לקוח צומת

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

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

כדי להירשם לאירועים של חיבור וניתוק של מכשירים, אתם יכולים להשתמש במחלקה DataLayerAppHelper של Horologist. הוא מספק connectedAndInstalledNodes Flow כדי לבחון את מצב החיבור. בנוסף, השיטה connectedNodes() מחזירה רשימה של מכשירים מחוברים, ומשלבת מידע מ-NodeClient ומ-CapabilityClient לאובייקט אחד.

חיפוש מכשירים ספציפיים באמצעות לקוח יכולת

אובייקט CapabilityClient מספק מידע על המכשירים ברשת Wear OS שתומכים ביכולות ספציפיות של האפליקציה. יכולת היא תכונה שהאפליקציה מגדירה בזמן ה-build או מגדירה באופן דינמי בזמן הריצה.

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

כדי להגדיר יכולות בזמן ה-build, צריך להצהיר על משאב string-array בשם android_wear_capabilities ב-res/values/wear.xml, כמו שמוצג בקטע ציון שמות של יכולות לזיהוי האפליקציות. כדי למנוע מכיווץ מקורות המידע להסיר את android_wear_capabilities כלא בשימוש, צריך לציין את tools:keep="@array/android_wear_capabilities" בקובץ שמירה נפרד בספרייה res/raw/ (לדוגמה, res/raw/keep.xml) במקום ב-res/values/wear.xml. במאמר התאמה אישית של המשאבים שרוצים לשמור מוסבר על התחביר של קובץ השמירה.

איך בודקים את היכולות החדשות של האפליקציה

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

איך בודקים אם מכשיר Wear OS הוא היחיד ברשת

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