برای بهروزرسانیها و اطلاعیههای مربوط به Nearby به
فهرست پستی ما بپیوندید.
شروع به کار
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
آخرین نسخه Xcode را نصب کنید
برای استفاده از Nearby Connection در پروژه خود، Xcode 13.0 یا جدیدتر مورد نیاز است.
بسته Nearby Connections را به پروژه خود اضافه کنید
Xcode با یک مدیریت بسته داخلی ارائه می شود. برای افزودن Nearby Connections به پروژه Xcode خود، File > Add Packages… را انتخاب کنید و google/nearby را جستجو کنید. سپس روی Add Package کلیک کنید و منتظر بمانید تا فرآیند تکمیل شود (ممکن است چند دقیقه طول بکشد).
درخواست دسترسی به منابع محافظت شده
Nearby Connections برای تبلیغ، کشف، ایجاد اتصالات و انتقال داده نیاز به دسترسی به بلوتوث و شبکه محلی دارد. در Info.plist برنامه خود، شرح استفاده برای هر منبع مورد نیاز ارائه دهید. اگر این کار را نکنید، تلاش برای دسترسی به منبع ناموفق خواهد بود و حتی ممکن است باعث از کار افتادن برنامه شما شود.
کلیدهای شرح استفاده مورد نیاز:
-
NSBluetoothAlwaysUsageDescription -
NSLocalNetworkUsageDescription
علاوه بر کلیدهای توصیف استفاده، یک کلید NSBonjourServices با لیستی از انواع سرویس‌هایی که توسط برنامه مرور می‌شوند نیز باید اضافه شود. تنها نوع سرویسی که باید اضافه شود را می توان با گرفتن 12 بایت اول هش SHA-256 شناسه سرویس برنامه شما ایجاد کرد.
می توانید از ابزار زیر برای ایجاد خودکار این مقدار برای شما استفاده کنید:
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Get started\n\nInstall the latest version of Xcode\n-----------------------------------\n\nTo use Nearby Connection in your project,\n[Xcode](https://developer.apple.com/xcode/) **13.0 or later** is required.\n\nAdd the Nearby Connections package to your project\n--------------------------------------------------\n\nXcode comes with a built-in package manager. To add Nearby Connections to your\nXcode project, select **File** \\\u003e **Add Packages...** and search for\n`google/nearby`. Then click **Add Package** and wait for the process to complete\n(this may take a few minutes).\n\nRequest access to protected resources\n-------------------------------------\n\nNearby Connections needs access to both Bluetooth and the local network to\nadvertise, discover, make connections, and transfer data. Provide a usage\ndescription for each resource needed, in your app's `Info.plist`. If you don't,\nattempts to access the resource will fail, and might even cause your app to\ncrash.\n\nRequired usage description keys:\n\n- `NSBluetoothAlwaysUsageDescription`\n- `NSLocalNetworkUsageDescription`\n\nIn addition to usage description keys, an `NSBonjourServices` key with a list of\nthe service types that will be browsed by the app, will also need to be added.\nThe only service type that must be added can be generated by taking the first 12\nbytes of the `SHA-256` hash of your app's service ID.\n\nYou can use the following tool to automatically generate this value for you: \nService ID\nGenerate\n\n```\n\n```"]]
