در مورد عوارض

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

بقیه این سند منابع داده، چهره‌های ساعت و انواع عوارض را شرح می‌دهد.

منبع داده های عارضه

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

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

Complications data flow
شکل 1. جریان داده های عارضه.

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

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

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

انواع عوارض

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

منابع داده از انواع پیچیدگی متفاوت از واچ فیس استفاده می کنند:

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

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

،

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

بقیه این سند منابع داده، چهره‌های ساعت و انواع عوارض را شرح می‌دهد.

منبع داده های عارضه

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

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

Complications data flow
شکل 1. جریان داده های عارضه.

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

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

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

انواع عوارض

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

منابع داده از انواع پیچیدگی متفاوت از واچ فیس استفاده می کنند:

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

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

،

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

بقیه این سند منابع داده، چهره‌های ساعت و انواع عوارض را شرح می‌دهد.

منبع داده های عارضه

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

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

Complications data flow
شکل 1. جریان داده های عارضه.

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

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

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

انواع عوارض

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

منابع داده از انواع پیچیدگی متفاوت از واچ فیس استفاده می کنند:

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

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

،

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

بقیه این سند منابع داده، چهره‌های ساعت و انواع عوارض را شرح می‌دهد.

منبع داده های عارضه

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

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

Complications data flow
شکل 1. جریان داده های عارضه.

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

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

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

انواع عوارض

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

منابع داده از انواع پیچیدگی متفاوت از واچ فیس استفاده می کنند:

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

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