פלטפורמת Android כוללת תמיכה במקבץ הרשת (network stack) של Bluetooth, שמאפשר למכשיר להחליף נתונים באופן אלחוטי עם מכשירי Bluetooth אחרים. מסגרת האפליקציה מספקת גישה לפונקציונליות של Bluetooth דרך ממשקי API של Bluetooth. ממשקי ה-API האלה מאפשרים לאפליקציות להתחבר למכשירי Bluetooth אחרים, וכך להפעיל תכונות אלחוטיות של נקודה לנקודה ושל ריבוי נקודות.
באמצעות ממשקי ה-API של Bluetooth, אפליקציה יכולה לבצע את הפעולות הבאות:
- סורקים לאיתור מכשירי Bluetooth אחרים.
- שליחת שאילתה למתאם ה-Bluetooth המקומי כדי למצוא מכשירי Bluetooth מותאמים.
- ליצור ערוצי RFCOMM.
- להתחבר למכשירים אחרים באמצעות זיהוי שירותים.
- להעביר נתונים ממכשירים אחרים ואליהם.
- לנהל כמה חיבורים.
המסמך הזה מתמקד ב-Classic Bluetooth. Classic Bluetooth מתאים לפעולות שצורכות יותר סוללה, כמו סטרימינג ותקשורת בין מכשירים. במכשירי Bluetooth עם דרישות הספק נמוכות, כדאי להשתמש בחיבורי Bluetooth עם צריכת אנרגיה נמוכה (BLE).
במסמך הזה מתוארים פרופילים שונים של Bluetooth ומוסבר איך להשתמש בממשקי ה-API של Bluetooth כדי לבצע את ארבע המשימות העיקריות שנדרשות לתקשורת באמצעות Bluetooth:
- הגדרת Bluetooth.
- חיפוש מכשירים מותאמים או זמינים באזור המקומי.
- המכשירים מתחברים.
- העברת נתונים בין מכשירים.
העקרונות הבסיסיים
כדי שמכשירים עם Bluetooth יוכלו להעביר נתונים ביניהם, הם צריכים קודם ליצור ערוץ תקשורת באמצעות תהליך התאמה. מכשיר אחד, שניתן לגלות אותו, הופך את עצמו לזמין לבקשות חיבור נכנסות. מכשיר אחר מוצא את המכשיר שניתן לגלות באמצעות תהליך של זיהוי שירותים. אחרי שהמכשיר הגלוי מאשר את בקשת ההתאמה, שני המכשירים משלימים תהליך קישור שבו הם מחליפים מפתחות אבטחה. המכשירים שומרים את המפתחות האלה במטמון לשימוש מאוחר יותר.
אחרי שתהליכי ההתאמה והקישור מסתיימים, שני המכשירים מחליפים מידע. כשהסשן מסתיים, המכשיר שיזם את בקשת ההתאמה משחרר את הערוץ שקישר אותו למכשיר שניתן לגלות. עם זאת, שני המכשירים נשארים מקושרים, כך שהם יכולים להתחבר מחדש באופן אוטומטי במהלך סשן עתידי, כל עוד הם נמצאים בטווח אחד של השני ואף אחד מהמכשירים לא הסיר את הקישור.
כדי להשתמש בממשקי ה-API של Bluetooth, צריך להצהיר על כמה הרשאות בקובץ המניפסט. אחר כך, נכנסים אל BluetoothAdapter ובודקים אם Bluetooth זמין במכשיר. אם יש Bluetooth, פועלים לפי שלושת השלבים הבאים:
- למצוא מכשירי Bluetooth בקרבת מקום, גם מכשירים שכבר הותאמו וגם מכשירים חדשים.
- להתחבר למכשיר Bluetooth.
- העברת נתונים באמצעות המכשיר המחובר.
מכשירים מסוימים משתמשים בפרופיל Bluetooth ספציפי שמצהיר על הנתונים שהוא מספק.
ממשקים ומחלקות עיקריים
כל ממשקי ה-API של Bluetooth זמינים בחבילה android.bluetooth.
אלה המחלקות והממשקים שצריך כדי ליצור חיבורי Bluetooth:
BluetoothAdapter- מייצג את מתאם ה-Bluetooth המקומי (רדיו Bluetooth).
BluetoothAdapterהיא נקודת הכניסה לכל האינטראקציות של Bluetooth. באמצעותה אפשר לגלות מכשירי Bluetooth אחרים, לשלוח שאילתה לרשימה של מכשירים מקושרים (מותאמים), ליצור מופע שלBluetoothDeviceבאמצעות כתובת MAC ידועה וליצורBluetoothServerSocketכדי להאזין לתקשורת ממכשירים אחרים. BluetoothDevice- מייצג מכשיר Bluetooth מרוחק. אפשר להשתמש במחלקה הזו כדי לבקש חיבור למכשיר שמחובר לרשת אחרת באמצעות
BluetoothSocketאו כדי לשלוח שאילתה לגבי מידע על המכשיר, כמו השם, הכתובת, המחלקה ומצב הקישור שלו. BluetoothSocket- מייצג את הממשק של שקע Bluetooth (בדומה ל-TCP
Socket). זוהי נקודת החיבור שמאפשרת לאפליקציה להחליף נתונים עם מכשיר Bluetooth אחר באמצעותInputStreamו-OutputStream. BluetoothServerSocket
- מייצג שקע שרת (server socket) פתוח שמאזין לבקשות נכנסות (בדומה ל-TCP
ServerSocket). כדי לחבר שני מכשירים, מכשיר אחד צריך לפתוח שקע שרת עם המחלקה הזו. כשמכשיר Bluetooth מרוחק שולח בקשת חיבור למכשיר הזה, המכשיר מאשר את החיבור ומחזירBluetoothSocketמחובר. BluetoothClass- מתאר את המאפיינים והיכולות הכלליים של מכשיר Bluetooth. זוהי קבוצת מאפיינים לקריאה בלבד שמגדירה את המחלקות והשירותים של המכשיר. למרות שהמידע הזה מספק רמז שימושי לגבי סוג המכשיר, המאפיינים של המחלקה הזו לא בהכרח מתארים את כל הפרופילים והשירותים של Bluetooth שהמכשיר תומך בהם.
BluetoothProfile- ממשק שמייצג פרופיל Bluetooth. פרופיל Bluetooth הוא מפרט של ממשק אלחוטי לתקשורת מבוססת-Bluetooth בין מכשירים. דוגמה לכך היא פרופיל הדיבורית. למידע נוסף על פרופילים, ראו פרופילי Bluetooth.
BluetoothHeadset- תמיכה באוזניות Bluetooth עם מיקרופון לשימוש בטלפונים ניידים. זה כולל גם את פרופיל אוזניות Bluetooth וגם את פרופיל הדיבורית (v1.5).
BluetoothA2dp- מגדיר איך אפשר להעביר אודיו באיכות גבוהה בסטרימינג ממכשיר אחד למכשיר אחר באמצעות חיבור Bluetooth, באמצעות פרופיל הפצת אודיו מתקדם (A2DP).
BluetoothHealth- מייצג שרת proxy של פרופיל מכשיר בריאות ששולט בשירות ה-Bluetooth.
BluetoothHealthCallback- מחלקה מופשטת שמשמשת להטמעת קריאות חוזרות (callback) של
BluetoothHealth. צריך להרחיב את המחלקה הזו ולהטמיע את שיטות הקריאה החוזרת כדי לקבל עדכונים על שינויים במצב הרישום של האפליקציה ובמצב של ערוץ ה-Bluetooth. BluetoothHealthAppConfiguration- מייצג הגדרת אפליקציה שאפליקציית צד שלישי של Bluetooth Health רושמת כדי לתקשר עם מכשיר Bluetooth Health מרוחק.
BluetoothProfile.ServiceListener- ממשק שמודיע ללקוחות של תקשורת בין תהליכים (IPC) ב-
BluetoothProfileכשהם מחוברים לשירות הפנימי שמפעיל פרופיל מסוים או מנותקים ממנו.