درباره چیدمان‌ها

ویژگی اضافی هر ویژگی‌ای است که علاوه‌بر زمان روی صفحه ساعت نمایش داده می‌شود. برای مثال، نشانگر باتری یک افزونه است. Complications API هم برای صفحه‌های ساعت و هم برای برنامه‌های منبع داده است.

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

منبع داده‌های پیچیدگی

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

نمودار زیر نشان می‌دهد که Wear OS by Google چگونه جریان داده‌ها را از منابع به صفحه‌های ساعت منتقل می‌کند.

جریان داده‌های پیچیدگی‌ها
شکل ۱. جریان داده‌های پیچیدگی.

عملکردهای اضافی در صفحه‌های ساعت

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

برای آشنایی با نحوه افزودن عملکردهای اضافی به صفحه ساعت، به افزودن عملکردهای اضافی به صفحه ساعت مراجعه کنید.

انواع عملکرد اضافی

انواع پیچیدگی مشخص می‌کنند چه نوع داده‌هایی را می‌توان در پیچیدگی نشان داد یا توسط منبع داده ارائه کرد. برای مثال، وقتی داده‌ها عمدتاً از رشته‌ای کوتاه تشکیل شده است، از نوع SHORT_TEXT استفاده کنید. یک ComplicationData شیء همیشه یک نوع پیچیدگی دارد که فیلدهای الزامی و اختیاری را تعریف می‌کند. فیلد الزامی نشان‌دهنده بخش اصلی داده است؛ اکثر انواع نامشان را از فیلد الزامی می‌گیرند.

منابع داده از انواع افزونه‌ها به‌طور متفاوتی نسبت‌به صفحه‌های ساعت استفاده می‌کنند:

  • منبع داده انواع داده‌های پیچیدگی را برای ارائه انتخاب می‌کند، ازجمله اینکه کدام فیلدهای اختیاری از آن نوع ارائه شود، و چند نوع مختلف می‌تواند پشتیبانی شود. برای مثال، منبع تعداد قدم‌ها ممکن است از انواع RANGED_VALUE و SHORT_TEXT پشتیبانی کند و منبع جلسه بعدی ممکن است از انواع SHORT_TEXT و LONG_TEXT پشتیبانی کند.
  • می‌توانید انتخاب کنید چه تعداد چیدمان در صفحه ساعتتان گنجانده شود و چه نوع چیدمان‌هایی پشتیبانی شود. برای مثال، یک تلفیق شماره‌گیری در صفحه ساعت ممکن است از انواع SHORT_TEXT، SMALL_IMAGE، و RANGED_VALUE پشتیبانی کند. سنجه‌ای در صفحه ساعت ممکن است فقط از نوع RANGED_VALUE پشتیبانی کند.

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