Руководство для разработчиков

Следующие рекомендации помогут вам создавать высококачественные приложения с использованием API Nearby Messages и API Nearby Connections.

Уважайте конфиденциальность пользователей

  • Помогите пользователю понять, какие данные ваше приложение предоставит находящимся поблизости пользователям.

  • Не публикуйте конфиденциальную информацию, такую как пароли и номера кредитных карт. Вместо этого передавайте токены авторизации или идентификаторы транзакций.

Требовать явного действия пользователя для запуска Nearby

  • Не удивляйте пользователя. Требуйте от него выполнения явного действия (нажатия кнопки, перехода в раздел приложения, нажатия специальной кнопки и т. д.) для активации функции «Рядом».

  • Как на iOS, так и на Android при первом вызове Nearby отобразится диалоговое окно с запросом разрешения. Ожидание явного действия пользователя перед вызовом Nearby поможет пользователю контекстуализировать диалоговое окно и связать его с функцией определения близости вашего приложения.

Будьте внимательны к расходу заряда батареи

Использование радиоустройств и датчиков поблизости может привести к тому, что ваше приложение будет расходовать заряд батареи в 2,5–3,5 раза больше обычного. Чтобы снизить расход заряда батареи, следуйте следующим рекомендациям.

  • На Android при публикации или подписке с устройств без поддержки BLE вызывайте API Nearby Messages только из Activity и поддерживайте эту Activity запущенной только при включённом экране и активном приложении. Для этого передайте Activity в качестве аргумента параметру Context метода Nearby.getMessagesClient() . Вызов Nearby из Service поддерживается только при подписке на сообщения маяка Bluetooth Low Energy (BLE) .

  • На Android в обратном вызове Activity.onStop() вашего приложения вызовите Nearby.getMessagesClient(Activity).unpublish() и Nearby.getMessagesClient(Activity).unsubscribe() для всех активных публикаций и подписок. На iOS никаких действий не требуется, так как это происходит автоматически.

  • Сделайте так, чтобы пользователю было легко останавливать активные публикации и подписки.

  • Не публикуйте и не подписывайтесь в фоновом режиме без ведома пользователя.

Используйте правильный брендинг

  • Мы предоставили набор стандартных элементов, которые вы можете использовать для обозначения объектов «Рядом» в своём приложении. Используйте только следующие утверждённые значки для обозначения объектов «Рядом».

  • Активы PNG

  • SVG-активы