שנתחיל?

לפני שמתחילים

לפני שמתחילים לתכנת בעזרת ה-API של Connections:

• מתקינים את Google Play Services SDK.
• מורידים את דוגמאות ל-API של חיבורים בקרבת מקום ובודקים אותן.

בקשת הרשאות

לפני השימוש ב'חיבורים בקרבת מקום', האפליקציה שלכם צריכה לבקש את ההרשאות המתאימות. יש להוסיף את ההרשאות הבאות למכשיר AndroidManifest.xml:

<!-- Required for Nearby Connections -->
<uses-permission android:maxSdkVersion="31" android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:maxSdkVersion="31" android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:maxSdkVersion="30" android:name="android.permission.BLUETOOTH" />
<uses-permission android:maxSdkVersion="30" android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:maxSdkVersion="28" android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:minSdkVersion="29" android:maxSdkVersion="31" android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:minSdkVersion="32" android:name="android.permission.NEARBY_WIFI_DEVICES" />
<!-- Optional: only required for FILE payloads -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

מכיוון ש-ACCESS_FINE_LOCATION, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT, BLUETOOTH_SCAN ו- READ_EXTERNAL_STORAGE נחשבים כהרשאות מערכת מסוכנות, בנוסף להוספתן למניפסט שלך, עליך לבקש את ההרשאות האלה בעת הריצה, כפי שמתואר בריצה1

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