Bắt đầu

Cài đặt phiên bản Xcode mới nhất

Để sử dụng tính năng Kết nối lân cận trong dự án, bạn cần sử dụng Xcode 13.0 trở lên.

Thêm gói Nearby Connections (Kết nối lân cận) vào dự án

Xcode đi kèm với trình quản lý gói tích hợp sẵn. Để thêm tính năng Kết nối lân cận vào dự án Xcode, hãy chọn File (Tệp) > Add Packages... (Thêm gói...) rồi tìm google/nearby. Sau đó, hãy nhấp vào Add Package (Thêm Gói) rồi chờ quá trình này hoàn tất (quá trình này có thể mất vài phút).

Yêu cầu quyền truy cập vào các tài nguyên được bảo vệ

Tính năng Kết nối lân cận cần có quyền truy cập vào cả Bluetooth và mạng cục bộ để quảng cáo, khám phá, tạo kết nối và chuyển dữ liệu. Cung cấp thông tin mô tả mức sử dụng cho từng tài nguyên cần thiết trong Info.plist của ứng dụng. Nếu không, nỗ lực truy cập tài nguyên sẽ không thành công và thậm chí có thể khiến ứng dụng của bạn gặp sự cố.

Khóa mô tả mức sử dụng bắt buộc:

  • NSBluetoothAlwaysUsageDescription
  • NSLocalNetworkUsageDescription

Ngoài các khoá mô tả việc sử dụng, bạn cũng cần thêm một khoá NSBonjourServices có danh sách các loại dịch vụ mà ứng dụng sẽ duyệt xem. Bạn chỉ có thể tạo loại dịch vụ duy nhất bằng cách lấy 12 byte đầu tiên của hàm băm SHA-256 cho mã dịch vụ của ứng dụng.

Bạn có thể sử dụng công cụ sau để tự động tạo giá trị này cho bạn: