Tổng quan

Nearby Connections (API kết nối lân cận) là một API mạng ngang hàng cho phép các ứng dụng dễ dàng khám phá, kết nối và trao đổi dữ liệu với các thiết bị ở gần theo thời gian thực, bất kể kết nối mạng là gì.

Một số ví dụ về trường hợp sử dụng:

  • Bảng trắng cộng tác: Ghi lại ý tưởng với những người tham gia ở gần trên bảng trắng ảo dùng chung.
  • Trò chơi nhiều người chơi trên máy: Thiết lập trò chơi nhiều người chơi và mời những người dùng khác gần đó tham gia.
  • Chơi trò chơi trên nhiều màn hình: Sử dụng điện thoại hoặc máy tính bảng làm tay điều khiển trò chơi để chơi các trò chơi hiển thị trên thiết bị Android màn hình lớn gần đó, chẳng hạn như Android TV.
  • Truyền tệp ngoại tuyến: Chia sẻ ảnh, video hoặc bất kỳ loại dữ liệu nào khác một cách nhanh chóng mà không cần kết nối mạng.

Giới thiệu

Kết nối lân cận cho phép quảng cáo, khám phá và kết nối giữa các thiết bị ở gần theo cách ngang hàng hoàn toàn ngoại tuyến. Kết nối giữa các thiết bị là băng thông cao, độ trễ thấp và được mã hóa đầy đủ để cho phép truyền dữ liệu nhanh chóng và an toàn.

Mục tiêu chính của API này là cung cấp một nền tảng đơn giản, đáng tin cậy và hiệu quả. Về cơ bản, API sử dụng kết hợp các công nghệ Bluetooth, BLE và Wi-Fi, tận dụng sức mạnh của từng công nghệ trong khi tránh được những điểm yếu tương ứng. Tính năng này tóm tắt hiệu quả sự mơ hồ của Bluetooth và Wi-Fi trên nhiều nền tảng và phiên bản hệ điều hành, cho phép nhà phát triển tập trung vào các tính năng quan trọng với người dùng của họ.

Tổng quan về API

Việc sử dụng API bao gồm hai giai đoạn: trước khi kết nối và sau khi kết nối.

Trong giai đoạn trước khi kết nối, Nhà quảng cáo sẽ tự quảng cáo, trong khi Người khám phá khám phá các Nhà quảng cáo lân cận và gửi yêu cầu kết nối. Yêu cầu kết nối từ Trình khám phá với Nhà quảng cáo sẽ bắt đầu quy trình xác thực đối xứng, dẫn đến cả hai bên chấp nhận độc lập (hoặc từ chối) yêu cầu kết nối.

Sau khi cả hai bên chấp nhận yêu cầu kết nối, kết nối được coi là đã được thiết lập và các thiết bị bước vào giai đoạn sau khi kết nối, cả hai bên đều có thể trao đổi dữ liệu.

Quảng cáo và khám phá

Nhà quảng cáo sẽ nhìn thấy các nhà quảng cáo khác và những người khám phá sẽ được thông báo khi nhà quảng cáo mới được tìm thấy hoặc đã bị mất.

Đang thiết lập kết nối

Khi người khám phá muốn kết nối với một nhà quảng cáo gần đó, người khám phá có thể yêu cầu kết nối.

Cả hai bên sẽ được thông báo về quy trình khởi tạo kết nối và cả hai bên sẽ có cơ hội chấp nhận hoặc từ chối kết nối.

Khi cả hai bên đã phản hồi, mỗi bên sẽ được thông báo về kết quả. Nếu cả hai bên đều chấp nhận kết nối, thì kết nối được coi là đã thiết lập xong và sau đó quá trình truyền dữ liệu có thể bắt đầu.

Đang trao đổi dữ liệu

Sau khi kết nối được thiết lập, việc sử dụng API sẽ mang tính đối xứng, vì vậy, không còn sự khác biệt giữa Nhà quảng cáo và Người khám phá.

Hai bên hiện có thể trao đổi dữ liệu. Có 3 loại trọng tải được hỗ trợ:

  • Byte: Mảng byte được giới hạn ở 32k; phù hợp để gửi những nội dung như siêu dữ liệu hoặc thông báo kiểm soát.
  • Tệp: Tệp có kích thước bất kỳ; các tệp này được chuyển từ ứng dụng sang giao diện mạng với mức sao chép tối thiểu trên các ranh giới của quy trình.
  • Luồng:Một luồng dữ liệu được tạo ngay lập tức, như trường hợp âm thanh/video đã ghi, không có kích thước cuối cùng được biết trước.

Người nhận sẽ được thông báo về dữ liệu mới và mọi tiến trình cập nhật, huỷ hoặc lỗi.

Các mối liên kết được thiết lập hoàn toàn song song, nghĩa là nhà quảng cáo và người khám phá có thể đồng thời gửi và nhận dữ liệu.

Thu thập dữ liệu

Khi sử dụng SDK lân cận của Dịch vụ Google Play, các bản phân tích về mức sử dụng sẽ được thu thập để cải thiện trải nghiệm.

  • Chỉ số về hiệu suất: Độ trễ của hoạt động khám phá và kết nối, độ tin cậy và thông lượng được thu thập khi quét tìm và kết nối với thiết bị bằng SDK Lân cận.
  • Thông tin thiết bị: Mẫu thiết bị, quốc gia, phiên bản bản dựng và tên gói ứng dụng sẽ được thu thập và liên kết với các chỉ số hiệu suất để xác định các phần theo khu vực và thiết bị cụ thể.

Người dùng cuối có thể cho phép hoặc từ chối bộ sưu tập này bằng cách chuyển đến phần Cài đặt > Google > Thông tin sử dụng và chẩn đoán.