Nguyên tắc dành cho nhà phát triển

Các nguyên tắc sau sẽ giúp bạn xây dựng các ứng dụng chất lượng cao bằng Nearby Messages API và Nearby Connections API.

Tôn trọng quyền riêng tư của người dùng

  • Giúp người dùng hiểu được dữ liệu mà ứng dụng của bạn sẽ cung cấp cho những người dùng lân cận.

  • Đừng phát hành thông tin nhạy cảm như mật khẩu và số thẻ tín dụng. Thay vào đó, hãy chuyển mã thông báo uỷ quyền hoặc giá trị nhận dạng giao dịch.

Yêu cầu người dùng thực hiện một hành động tường minh để bắt đầu tính năng Lân cận

  • Đừng gây bất ngờ cho người dùng. Yêu cầu người dùng thực hiện một thao tác rõ ràng (nhấn vào một nút, chuyển đến một phần trong ứng dụng, công tắc đặc biệt, v.v.) để kích hoạt tính năng Lân cận.

  • Trên cả iOS và Android, lần đầu tiên việc gọi Lân cận sẽ kích hoạt hộp thoại cấp quyền từ Lân cận. Việc chờ một thao tác cụ thể của người dùng trước khi gọi tính năng Lân cận sẽ giúp người dùng nắm được ngữ cảnh của hộp thoại và liên kết hộp thoại đó với tính năng dựa trên khoảng cách của ứng dụng.

Lưu ý đến mức tiêu thụ pin

Việc sử dụng đài và cảm biến ở gần sẽ khiến ứng dụng của bạn tiêu thụ pin ở mức 2,5-3,5 lần tốc độ bình thường. Để giảm mức sử dụng pin, hãy quan sát các đề xuất sau.

  • Trên Android, khi phát hành hoặc đăng ký các thiết bị không phải BLE, chỉ cần gọi API Nearby Messages từ một Activity, và chỉ chạy Activity đó khi màn hình bật và ứng dụng đang chạy ở nền trước. Để thực hiện việc này, hãy chuyển Hoạt động làm đối số cho tham số Context của Nearby.getMessagesClient(). Tính năng gọi Lân cận từ một Dịch vụ chỉ được hỗ trợ khi đăng ký nhận thông báo báo hiệu Năng lượng thấp Bluetooth (BLE).

  • Trên Android, trong lệnh gọi lại Activity.onStop() của ứng dụng, hãy gọi Nearby.getMessagesClient(Activity).unpublish()Nearby.getMessagesClient(Activity).unsubscribe() trên bất kỳ bản phát hành hoặc gói thuê bao đang hoạt động nào. Trên iOS, bạn không cần làm gì cả vì quá trình này được xử lý tự động.

  • Giúp người dùng dễ dàng ngừng đăng và đăng ký đang hoạt động.

  • Không được phát hành hoặc đăng ký trong nền mà người dùng không biết.

Sử dụng đúng thương hiệu

  • Chúng tôi đã cung cấp một tập hợp nội dung chuẩn mà bạn có thể sử dụng để biểu thị Lân cận trong ứng dụng của bạn. Chỉ sử dụng các biểu tượng được phê duyệt sau đây khi tham chiếu đến Lân cận.

  • Thành phần PNG

  • Tài sản SVG