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

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

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

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

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

Требовать явного действия, инициируемого пользователем, для запуска функции «Рядом»

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

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

Помните о расходе батареи

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

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

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

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

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

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

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

  • Активы PNG

  • SVG-активы