یک Complication هر ویژگی است که علاوه بر زمان، روی صفحه ساعت نمایش داده میشود. برای مثال، نشانگر باتری یک Complication است. API Complications هم برای صفحه ساعت و هم برای برنامههای منبع داده است.
بقیه این سند منابع داده، صفحه نمایش ساعت و انواع پیچیدگیها را شرح میدهد.
منبع دادههای عارضه
برنامههایی که دادههایی مانند سطح باتری، آب و هوا یا تعداد گامها را برای واچ فیسهای مربوط به کامپلیکیشنها ارائه میدهند ، منابع داده کامپلیکیشن نامیده میشوند. این منابع داده، دادههای خام را ارائه میدهند و مسئولیتی در کنترل نحوه نمایش دادههای خود در واچ فیس ندارند. برای کسب اطلاعات در مورد نوشتن برنامههایی که دادهها را برای واچ فیسها ارائه میدهند، به بخش «نمایش دادهها در کامپلیکیشنها» مراجعه کنید.
نمودار زیر نشان میدهد که چگونه Wear OS by Google واسطه جریان دادهها از منابع به صفحههای ساعت است.
عوارض روی صفحه ساعتها
واچ فیسها دادهها را از منابع داده مربوط به پیچیدگیها دریافت میکنند که به آنها اجازه میدهد بدون نیاز به کدنویسی برای دریافت دادههای زیربنایی، پیچیدگیها را اضافه کنند. واچ فیسها کنترل نحوه رندر دادهها را حفظ میکنند، بنابراین میتوانند دادهها را به طور طبیعی با طراحی خود ادغام کنند. برای اطلاعات بیشتر، به راهنمای طراحی در مورد پیچیدگیها مراجعه کنید.
برای یادگیری نحوه افزودن عوارض به صفحه ساعت، به افزودن عوارض به صفحه ساعت مراجعه کنید.
انواع عوارض
انواع پیچیدگی تعریف میکنند که چه نوع دادههایی میتوانند در یک پیچیدگی نمایش داده شوند یا توسط یک منبع داده ارائه شوند. برای مثال، وقتی دادهها عمدتاً از یک رشته کوتاه تشکیل شدهاند، از نوع SHORT_TEXT استفاده کنید. یک شیء ComplicationData همیشه یک نوع پیچیدگی واحد دارد که فیلدهای الزامی و اختیاری را تعریف میکند. یک فیلد الزامی نشان دهنده بخش اصلی داده است؛ اکثر انواع نام خود را از فیلد الزامی میگیرند.
منابع داده از انواع عوارض به طور متفاوتی نسبت به صفحه ساعت استفاده میکنند:
- یک منبع داده، انواع دادههای عارضهای که باید ارائه شوند، از جمله فیلدهای اختیاری که باید ارائه شوند و تعداد انواع مختلف قابل پشتیبانی را انتخاب میکند. برای مثال، یک منبع شمارش گام ممکن است از انواع
RANGED_VALUEوSHORT_TEXTپشتیبانی کند و یک منبع next-meeting ممکن است از انواعSHORT_TEXTوLONG_TEXTپشتیبانی کند. - شما میتوانید تعداد و نوع کامپلیکیشنهایی که میخواهید در صفحه ساعت خود داشته باشید را انتخاب کنید. برای مثال، یک کامپلیکیشن شمارهگیری روی صفحه ساعت ممکن است از انواع
SHORT_TEXT،SMALL_IMAGEوRANGED_VALUEپشتیبانی کند. یک گیج روی صفحه ساعت ممکن است فقط از نوعRANGED_VALUEپشتیبانی کند.
برای کسب اطلاعات بیشتر در مورد انواع مختلف پیچیدگیها و فیلدهای پشتیبانی شده توسط هر نوع، به انواع پیچیدگیها مراجعه کنید.