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

Các nguyên tắc sau đây 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 những dữ liệu mà ứng dụng của bạn sẽ hiển thị cho người dùng ở gần.

  • Đừng xuất bản thông tin nhạy cảm như mật khẩu và số thẻ tín dụng. Thay vào đó, hãy truyề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 rõ ràng để bắt đầu Nearby

  • Đừng làm người dùng bất 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 nút, chuyển đến một phần trong ứng dụng, một 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 gọi Nearby sẽ kích hoạt hộp thoại cấp quyền từ Nearby. Việc chờ đợi một hành động rõ ràng của người dùng trước khi gọi Nearby sẽ giúp người dùng hiểu rõ 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 Nearby sử dụng các thiết bị vô tuyến và cảm biến sẽ khiến ứng dụng của bạn tiêu thụ pin với tốc độ gấp 2,5 đến 3,5 lần tốc độ thông thường. Để giảm mức sử dụng pin, hãy làm theo các đề xuất sau.

  • Trên Android, khi xuất bản hoặc đăng ký bằng các thiết bị không phải BLE, bạn chỉ được gọi Nearby Messages API từ một Hoạt động và chỉ giữ Hoạt động đó chạy khi màn hình bật và ứng dụng của bạn ở nền trước. Để làm việc này, hãy truyền Hoạt động làm đối số cho tham số Context của Nearby.getMessagesClient(). Chỉ được phép gọi Nearby từ một Dịch vụ khi đăng ký nhận thông báo từ beacon Bluetooth năng lượng thấp (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 mọi hoạt động phát hành hoặc đăng ký đang hoạt động. Trên iOS, bạn không cần làm gì cả vì hệ thống sẽ tự động xử lý việc này.

  • Giúp người dùng dễ dàng dừng các hoạt động xuất bản và đăng ký đang diễn ra.

  • Không xuất bản hoặc đăng ký ở chế độ nền mà người dùng không biết.

Sử dụng thương hiệu phù hợp

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

  • Thành phần PNG

  • Tài sản SVG