اضافه کردن عوارض به صفحه ساعت

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

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

عنصر Complication به شما امکان می دهد تا حداکثر هشت عارضه را در یک صفحه ساعت تعریف کنید. این عنصر همچنین به شما امکان می دهد تا مشخص کنید هر عارضه در کجای صفحه ساعت ظاهر می شود.

برای اطلاعات بیشتر، نمونه WatchFaceFormat را در GitHub بررسی کنید.

انواع و فیلدها

جدول زیر انواع و فیلدهای شی ComplicationData را توضیح می دهد. اگر نمای ساعت فیلدی را درخواست کند که برای یک نوع پیچیده نامعتبر است، یک مقدار پیش‌فرض برای فیلد برگردانده می‌شود. برای مثال، اگر صفحه ساعت سعی کند به یک فیلد LONG_TEXT در نوع SHORT_TEXT دسترسی پیدا کند، مقدار پیش‌فرض فیلد LONG_TEXT ، null، برگردانده می‌شود. توجه داشته باشید که فیلدهای اختیاری تضمینی برای نمایش داده نمی شوند.





تایپ کنید فیلدهای مورد نیاز فیلدهای اختیاری یادداشت ها
SHORT_TEXT متن کوتاه نماد
نماد محافظت در برابر سوختگی
عنوان کوتاه
توضیحات محتوا

 اگر یکی یا هر دو ارائه شده باشد، فقط یک نماد یا عنوان کوتاه را نشان می دهد.
MONOCHROMATIC_IMAGE تصویر تک رنگ
 نماد محافظت در برابر سوختگی
توضیحات محتوا

 زمانی استفاده می شود که متن مورد نیاز نباشد. انتظار می رود این نماد تک رنگ باشد و ممکن است توسط صفحه ساعت رنگ آمیزی شود.
RANGED_VALUE ارزش
حداقل مقدار
حداکثر مقدار
 تصویر تک رنگ
نماد محافظت در برابر سوختگی
متن کوتاه
عنوان کوتاه
سطح شیب دار رنگی
ارزش دینامیکی
توضیحات محتوا

 اگر می خواهید نوار پیشرفت خود را ترسیم کنید، می توانید از متد isRangedValueProgressHidden() برای مخفی کردن نوار پیشرفت ارائه شده توسط کلاس ComplicationDrawable استفاده کنید.
GOAL_PROGRESS ارزش
ارزش هدف
 تصویر تک رنگ
نماد محافظت در برابر سوختگی
متن کوتاه
عنوان کوتاه
سطح شیب دار رنگی
ارزش دینامیکی
توضیحات محتوا

 GOAL_PROGRESS برای مواردی مانند شمارش گام ها در نظر گرفته شده است که در آن مقدار از صفر شروع می شود و مجاز است از مقدار هدف عبور کند.
LONG_TEXT متن طولانی
 عنوان طولانی
تصویر تک رنگ
نماد محافظت در برابر سوختگی
تصویر کوچک
توضیحات محتوا
 عنوان طولانی را در صورت ارائه نشان می دهد.
SMALL_IMAGE تصویر کوچک
 توضیحات محتوا
 یک تصویر کوچک دارای یکی از دو سبک است: سبک عکس یا سبک نماد . سبک عکس به این معنی است که انتظار می رود فضا را پر کند و بتوان آن را برش داد. سبک آیکون به این معنی است که نمی توان آن را برش داد و می توان آن را پد کرد. تغییرپذیری تصویر می‌تواند منجر به یک تصویر نامناسب برای نمایش در حالت محیطی در دستگاه‌های دارای محافظ سوختگی یا با حالت محیطی کم بیت شود. وقتی محافظ سوختگی یا حالت محیطی کم بیت فعال است، صفحه ساعت ممکن است از تصویر کوچک محافظ سوختگی استفاده کند زیرا ایمن است. در غیر این صورت، از آنجایی که تشخیص مناسب بودن برای صفحه ساعت سخت است، تصویری نمایش داده نمی شود.
LARGE_IMAGE تصویر بزرگ
 توضیحات محتوا
 انتظار می رود این تصویر به اندازه ای بزرگ باشد که صفحه ساعت را پر کند. تغییرپذیری تصویر می‌تواند منجر به یک تصویر نامناسب برای نمایش در حالت محیطی در دستگاه‌های دارای محافظ سوختگی یا با حالت محیطی کم بیت شود. از آنجایی که تشخیص مناسب بودن صفحه ساعت برای صفحه سخت است، اگر محافظ سوختگی یا محیط کم بیت فعال باشد، صفحه ساعت تصویری را در حالت محیطی نمایش نمی دهد.
WEIGHTED_ELEMENTS لیست عناصر
 تصویر تک رنگ
نماد محافظت در برابر سوختگی
متن کوتاه
عنوان کوتاه
توضیحات محتوا
 هر عنصر از یک رنگ و یک وزن (بزرگتر از صفر) تشکیل شده است. اندازه عنصر هنگام رندر باید متناسب با وزن آن باشد. وزنها لازم نیست به مقدار خاصی جمع شوند. توجه داشته باشید که چهره های ساعت مجاز به رنگ آمیزی مجدد WEIGHTED_ELEMENTS هستند.

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

  • هیچ منبعی انتخاب نشد
  • کاربر «خالی» را برای یک شکاف انتخاب کرده است
  • منبع هیچ داده ای برای ارسال ندارد

منابع نمی‌توانند TYPE_EMPTY در پاسخ به درخواست‌های به‌روزرسانی ارسال کنند. به جای آن TYPE_NO_DATA ارسال کنید.

نوع عارضه توضیحات
TYPE_NOT_CONFIGURED هنگامی که یک عارضه فعال می شود اما کاربر منبعی را انتخاب نکرده و هیچ پیش فرضی تنظیم نشده است توسط سیستم ارسال می شود.

توسط منابع قابل ارسال نیست

TYPE_EMPTY هنگامی که یک عارضه فعال می شود و کاربر به جای منبع، "خالی" را انتخاب می کند یا زمانی که صفحه ساعت بدون منبع و این نوع عارضه را به عنوان پیش فرض انتخاب می کند، توسط سیستم ارسال می شود.

توسط منابع قابل ارسال نیست

TYPE_NO_DATA هنگامی که یک عارضه دارای منبع فعال می شود تا قبل از دریافت داده های واقعی از منبع، عارضه را پاک کند، توسط سیستم ارسال می شود.

در صورتی که منبعی اطلاعات واقعی برای ارسال نداشته باشد، می تواند توسط منابع ارسال شود.

در برخی از دستگاه‌ها، چهره‌های ساعت و عوارض باید از فرمت Watch Face استفاده کنند

اگر صفحه ساعت موجود شما از کتابخانه Jetpack Watch Face یا کتابخانه پشتیبانی پوشیدنی استفاده می‌کند، کاربران همچنان داده‌ها را از تمام منابع داده در پیچیدگی‌های صفحه ساعت در دستگاه‌های زیر مشاهده می‌کنند:

  • دستگاه‌هایی که Wear OS 4 یا پیش‌تر را اجرا می‌کنند.
  • دستگاه‌هایی که به‌روزرسانی OTA به Wear OS 5 دریافت می‌کنند.

علاوه بر این، اگر صفحه ساعت موجود شما از کتابخانه Jetpack Watch Face یا کتابخانه پشتیبانی پوشیدنی استفاده می‌کند و روی یکی از این دستگاه‌ها نصب شده است، صفحه ساعت می‌تواند همچنان به‌روزرسانی‌ها را دریافت کند.

با این حال، در ساعت‌های جدیدی که با Wear OS 5 عرضه می‌شوند، چهره‌های ساعت باید از فرمت Watch Face استفاده کنند. به همین دلیل، توصیه می کنیم به استفاده از فرمت Watch Face مهاجرت کنید.

{% کلمه به کلمه %} {% آخر کلمه %} {% کلمه به کلمه %} {% آخر کلمه %}