Wytyczne dla programistów

Poniższe wskazówki pomogą Ci tworzyć wysokiej jakości aplikacje za pomocą interfejsów Nearby Messages API oraz Nearby Connections API.

Szanuj prywatność użytkowników

  • Pomóż użytkownikowi zrozumieć, jakie dane będzie widoczna dla użytkowników w pobliżu.

  • Nie publikuj informacji poufnych, takich jak hasła czy numery kart kredytowych. Zamiast tego przekazuj tokeny autoryzacji lub identyfikatory transakcji.

Wymagaj wyraźnego działania inicjowanego przez użytkownika, aby rozpocząć w pobliżu

  • Nie zaskakuj użytkownika. Wymagaj od użytkownika wykonania wyraźnego działania (kliknięcia przycisku, przejścia do sekcji aplikacji, specjalnego przełącznika itp.), aby aktywować go w pobliżu.

  • Na urządzeniach z iOS i Androidem pierwsze wywołanie funkcji W pobliżu spowoduje otwarcie okna uprawnień z funkcji W pobliżu. Oczekiwanie na jawne działanie użytkownika przed wywołaniem funkcji W pobliżu ułatwi użytkownikowi określenie kontekstu w oknie dialogowym i powiązanie go z funkcją bliskości aplikacji.

Zwracaj uwagę na zużycie baterii

Korzystanie z radia i czujników w pobliżu sprawi, że aplikacja będzie zużywać baterię w przedziale normalnym 2,5–3,5 raza. Aby zmniejszyć zużycie baterii, postępuj zgodnie z tymi zaleceniami.

  • Na urządzeniach z Androidem podczas publikowania i subskrybowania urządzeń z rozszerzeniem innym niż BLE wywoływaj tylko interfejs Nearby Messages API z poziomu aktywności, zachowując aktywność tylko wtedy, gdy ekran jest włączony, a aplikacja działa na pierwszym planie. Aby to zrobić, przekaż aktywność jako argument do parametru Context Nearby.getMessagesClient(). Wywołanie funkcji W pobliżu z usługi jest obsługiwane tylko podczas subskrybowania obrazów typu beacon Bluetooth Energy.

  • Na urządzeniu z Androidem w wywołaniu zwrotnym Activity.onStop() wywołaj Nearby.getMessagesClient(Activity).unpublish() i Nearby.getMessagesClient(Activity).unsubscribe() przy aktywnych publikacjach lub subskrypcjach. Na urządzeniach z iOS nie musisz nic robić, ponieważ obsługa jest automatyczna.

  • Ułatw użytkownikowi zatrzymywanie aktywnych publikacji i subskrypcji.

  • Nie publikuj ani nie subskrybuj w tle bez wiedzy użytkownika.

Używanie odpowiedniej marki

  • Udostępniamy zestaw standardowych zasobów, których możesz używać do reprezentowania funkcji W pobliżu w aplikacji. Gdy korzystasz z funkcji W pobliżu, używaj tylko tych zatwierdzonych ikon.

  • Zasoby PNG

  • Zasoby SVG