دستورالعمل های توسعه دهندگان

دستورالعمل‌های زیر به شما کمک می‌کند تا با استفاده از Nearby Messages API و Nearby Connections برنامه‌های کاربردی با کیفیت بالا بسازید.

به حریم خصوصی کاربر احترام بگذارید

  • به کاربر کمک کنید بفهمد برنامه شما چه داده هایی را در اختیار کاربران اطراف قرار می دهد.

  • اطلاعات حساس مانند رمز عبور و شماره کارت اعتباری را منتشر نکنید. در عوض، توکن‌های مجوز یا شناسه‌های تراکنش را ارسال کنید.

برای شروع Nearby به یک اقدام صریح توسط کاربر نیاز است

  • کاربر را غافلگیر نکنید. برای فعال کردن Nearby، کاربر را ملزم به انجام یک عمل صریح کنید (ضربه زدن دکمه، رفتن به بخشی در برنامه خود، سوئیچ ویژه و غیره).

  • در iOS و Android، تماس با Nearby برای اولین بار یک گفتگوی مجوز از Nearby را راه‌اندازی می‌کند. انتظار برای اقدام صریح کاربر قبل از فراخوانی Nearby به کاربر کمک می کند گفتگو را زمینه سازی کند و آن را با ویژگی مبتنی بر مجاورت برنامه شما مرتبط کند.

حواستان به مصرف باتری باشد

استفاده Nearby از رادیو و حسگر باعث می‌شود برنامه‌تان باتری را بین ۲.۵ تا ۳.۵ برابر معمول مصرف کند. برای کاهش مصرف باتری، توصیه های زیر را رعایت کنید.

  • در Android، هنگام انتشار یا اشتراک با دستگاه‌های غیر BLE، فقط API پیام‌های Nearby را از یک Activity فراخوانی کنید و فقط زمانی که صفحه روشن است و برنامه شما در پیش‌زمینه است، آن فعالیت را اجرا کنید. برای انجام این کار، Activity را به عنوان آرگومان به پارامتر Context Nearby.getMessagesClient() کنید. فراخوانی Nearby از یک سرویس تنها در صورت اشتراک در پیام‌های چراغ کم مصرف بلوتوث (BLE) پشتیبانی می‌شود.

  • در Android، در Activity.onStop() برنامه خود، با Nearby.getMessagesClient(Activity).unpublish() و Nearby.getMessagesClient(Activity).unsubscribe() در هر انتشار یا مشترک فعال تماس بگیرید. در iOS هیچ اقدامی لازم نیست زیرا به طور خودکار انجام می شود.

  • توقف انتشارات فعال و مشترک شدن را برای کاربر آسان کنید.

  • بدون اطلاع کاربر در پس‌زمینه منتشر یا مشترک نشوید.

از برندسازی مناسب استفاده کنید

  • مجموعه‌ای از دارایی‌های استاندارد را ارائه کرده‌ایم که می‌توانید از آنها برای نشان دادن Nearby در برنامه‌تان استفاده کنید. هنگام مراجعه به Nearby فقط از نمادهای تأیید شده زیر استفاده کنید.

  • دارایی های PNG

  • دارایی های SVG