برنامه تلفن خود را برای Watch Face Push پیکربندی کنید

برای بازار متعارف، اپلیکیشن تلفن روش غالبی است که کاربر با آن در تعامل است.

یک صفحه ساعت تنظیم کنید

هنگامی که کاربر یک صفحه ساعت را در برنامه تلفن انتخاب می کند، دو بخش در جریان بعدی برای تنظیم صفحه ساعت وجود دارد:

  1. نصب: صفحه ساعت را با استفاده از Watch Face Push که از طریق MessageClient آغاز شده است، نصب کنید. این مرحله ساده است، با استفاده از addWatchFace یا updateWatchFace ، که با استفاده از MessageClient از تلفن به ساعت راه‌اندازی می‌شود.
  2. فعال سازی: صفحه ساعت نصب شده را فعال تنظیم کنید . این مرحله بسته به وضعیت مجوز چندین مسیر ممکن دارد:
    • ممکن است هیچ اقدامی لازم نباشد. بازار ممکن است از قبل کنترل صفحه ساعت فعال را داشته باشد.
    • ممکن است نیازی به مداخله کاربر نباشد . این برنامه مجوزهای لازم را برای تنظیم صفحه ساعت فعال دارد و می تواند مستقیماً با استفاده از setWatchFaceAsActive() این کار را انجام دهد.
    • ممکن است راهنمایی لازم باشد، یا در مورد نحوه پذیرش درخواست‌های مجوز، یا نحوه تنظیم دستی صفحه ساعت با استفاده از حرکت فشار طولانی یا از طریق یک برنامه همراه.

پاسخ نصب

برای تسهیل مرحله فعال سازی ، مرحله نصب باید اطلاعات زیر را از ساعت به گوشی برگرداند:

  • نتیجه تلاش برای نصب
  • نتیجه isWatchFaceActive() - برای تعیین اینکه آیا برنامه از قبل دارای صفحه ساعت فعال است یا خیر.
  • آیا setWatchFaceAsActive() قبلاً در گذشته فراخوانی شده است - برنامه Wear OS باید این اطلاعات را به صورت محلی ردیابی و حفظ کند. این تماس API فقط یک بار قابل استفاده است.

فعال سازی

پس از نصب، پاسخ ممکن است نشان دهد که برنامه از قبل دارای صفحه ساعت فعال است. اما اگر اینطور نباشد، برنامه ممکن است انتخاب کند که دکمه‌ای را برای تنظیم صفحه ساعت به عنوان فعال نشان دهد.

سناریوی 1: تمام تلاش ها برای تنظیم صفحه ساعت فعال تمام شده است

اگر پاسخ نصب نشان می‌دهد که setWatchFaceAsActive() قبلاً در گذشته فراخوانی شده است، دکمه باید به صفحه آموزشی روی تلفن منتهی شود که به کاربر نشان می‌دهد چگونه صفحه ساعت را لمس و نگه دارد تا به صورت دستی آن را به صفحه مورد نظر خود تنظیم کند.

سناریو 2 - سعی کنید صفحه ساعت فعال را تنظیم کنید

تلفن باید به ساعت دستور دهد تا مجوز لازم SET_PUSHED_WATCH_FACE_AS_ACTIVE بررسی کند:

  • اگر کاربر قبلاً آن را اعطا کرده است، به فراخوانی setWatchFaceAsActive() ادامه دهید.
  • اگر کاربر قبلاً مجوز را رد کرده باشد، ساعت باید آن را به تلفن بازگرداند، جایی که می‌توان یک صفحه آموزشی نشان داد که نیاز به مجوز و نحوه اعطای دستی آن را توضیح می‌دهد.

  • اگر قبلاً مجوز درخواست نشده است ، ساعت باید به تلفن دستور دهد که یک لحظه آموزشی را نشان دهد که کاربر را در مورد نحوه پذیرش مجوزها در ساعت راهنمایی می کند و ساعت باید درخواست مجوز را انجام دهد.

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