개발자 가이드라인

다음 가이드라인은 Nearby Messages API 및 Nearby Connections API를 사용하여 고품질 애플리케이션을 빌드하는 데 도움이 됩니다.

사용자 개인 정보 보호

  • 앱에서 주변 사용자에게 어떤 데이터를 노출하는지 사용자에게 알립니다.

  • 비밀번호, 신용카드 번호와 같은 민감한 정보는 게시하지 마세요. 대신 승인 토큰 또는 거래 식별자를 전달하세요.

근처 기기를 시작하려면 명시적인 사용자 시작 작업이 필요함

  • 사용자를 놀라게 하지 마세요. 사용자가 명시적 작업 (버튼 탭, 앱의 섹션으로 이동, 특수 스위치 등)을 실행해야 Nearby가 활성화되도록 합니다.

  • iOS와 Android 모두에서 처음으로 Nearby를 호출하면 Nearby에서 권한 대화상자가 트리거됩니다. Nearby를 호출하기 전에 명시적인 사용자 작업을 기다리면 사용자가 대화상자를 맥락화하고 앱의 근접성 기반 기능과 연결하는 데 도움이 됩니다.

배터리 소모에 유의하기

Nearby에서 무선 및 센서를 사용하면 앱이 평소보다 2.5~3.5배 빠르게 배터리를 소모합니다. 배터리 사용량을 줄이려면 다음 권장사항을 따르세요.

  • Android에서 BLE가 아닌 기기로 게시하거나 구독할 때는 활동에서만 Nearby Messages API를 호출하고 화면이 켜져 있고 앱이 포그라운드에 있을 때만 해당 활동을 실행 상태로 유지하세요. 이렇게 하려면 Nearby.getMessagesClient()Context 매개변수에 활동을 인수로 전달합니다. 서비스에서 Nearby를 호출하는 것은 블루투스 저전력 (BLE) 비콘 메시지를 구독하는 경우에만 지원됩니다.

  • Android에서 앱의 Activity.onStop() 콜백에서 활성 게시 또는 구독에 대해 Nearby.getMessagesClient(Activity).unpublish()Nearby.getMessagesClient(Activity).unsubscribe()을 호출합니다. iOS에서는 자동으로 처리되므로 별도의 조치가 필요하지 않습니다.

  • 사용자가 활성 게시 및 구독을 쉽게 중지할 수 있도록 합니다.

  • 사용자가 모르는 상태에서 백그라운드에서 게시하거나 구독하지 마세요.

올바른 브랜딩 사용

  • 앱에서 Nearby를 나타내는 데 사용할 수 있는 표준 애셋이 제공됩니다. Nearby를 언급할 때는 승인된 다음 아이콘만 사용하세요.

  • PNG 애셋

  • SVG 애셋