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

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

از قالب واچ فیس استفاده کنید

عنصر Complication به شما امکان می‌دهد تا هشت پیچیدگی را در یک صفحه ساعت تعریف کنید. این عنصر همچنین به شما امکان می‌دهد محل نمایش هر پیچیدگی را در صفحه ساعت تعیین کنید.

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

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

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





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

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

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

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

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

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

  • هیچ منبعی انتخاب نشده است
  • کاربر برای یک اسلات، گزینه "خالی" را انتخاب کرده است.
  • منبعی داده‌ای برای ارسال ندارد

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

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

نمی‌تواند توسط منابع ارسال شود.

TYPE_EMPTY وقتی یک عارضه فعال می‌شود و کاربر به جای منبع، «خالی» را انتخاب می‌کند، یا وقتی صفحه ساعت هیچ منبعی را انتخاب نمی‌کند و این نوع عارضه را به عنوان پیش‌فرض انتخاب می‌کند، توسط سیستم ارسال می‌شود.

نمی‌تواند توسط منابع ارسال شود.

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

اگر منابع داده‌ی واقعی برای ارسال نداشته باشند، می‌توانند توسط آنها ارسال شوند.

در برخی دستگاه‌ها، واچ فیس‌ها و کامپلیکیشن‌ها باید از فرمت واچ فیس استفاده کنند.

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

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

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

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

{% کلمه به کلمه %} {% فعل کمکی %} {% کلمه به کلمه %} {% فعل کمکی %}