فرمت چهره ساعت

توجه: فرمت Watch Face برای نصب چهره‌های ساعت در دستگاه‌هایی با Wear OS 5 یا جدیدتر و برای همه واچ‌فیس‌های جدید منتشر شده در Google Play لازم است.

از ژانویه 2026، فرمت Watch Face برای نصب واچ فیس در همه دستگاه‌های Wear OS ضروری خواهد بود.

در این مقاله مرکز راهنمایی درباره تغییرات کاربر بیشتر بیاموزید.

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

گزینه هایی برای ایجاد صفحه های ساعت

فرمت Watch Face (WFF) ساخت یک صفحه ساعت را آسانتر از همیشه می کند. فرمت واچ فیس که با مشارکت سامسونگ ایجاد شده است، یک فرمت XML برای پیکربندی ظاهر و رفتار صفحه‌های ساعت است. بر خلاف سایر APIهای Watch Face، که در آن APK شما باید کدی را برای ارائه صفحه ساعت داشته باشد، فرمت Watch Face فقط به منابع و دستورالعمل‌های اعلامی نیاز دارد. پلت فرم Wear OS منطق مورد نیاز برای رندر کردن صفحه ساعت را کنترل می کند تا بتوانید به جای بهینه سازی کد یا عملکرد باتری، روی ایده های خلاقانه خود تمرکز کنید.

ما چندین روش برای ایجاد صفحه ساعت ارائه می دهیم:

  • اگر ابزار سبک What-You-See-Is-What-You-Get را ترجیح می دهید که به شما امکان می دهد صفحه ساعت را مستقیماً طراحی کنید، از Watch Face Studio استفاده کنید که ما با مشارکت سامسونگ از آن پشتیبانی می کنیم.
  • اگر از استفاده از Figma به عنوان یک طراح راحت هستید، یا اگر به دنبال تسریع در چند مرحله اول ایجاد صفحه ساعت به عنوان یک توسعه دهنده هستید، از Watch Face Designer استفاده کنید، که با استفاده از یک افزونه در Figma به آن دسترسی دارید.
  • اگر ترجیح می‌دهید پیکربندی ساعت خود را به صورت دستی مدیریت کنید و در فروشگاه برنامه خود منتشر کنید، می‌توانید چهره‌های ساعت را با استفاده از XML تعریف کنید، سپس با استفاده از Watch Face Push منتشر کنید.

    Android Studio همچنین از ساخت و اجرای واچ فیس هایی که از فرمت Watch Face استفاده می کنند پشتیبانی می کند.

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

در مورد قالب

در قلب صفحه ساعت با فرمت واچ فیس (WFF) سندی وجود دارد که چیدمان و رفتار صفحه ساعت را تعریف می کند. این سند به زبان XML و مطابق با مشخصات WFF نوشته شده است.

سیستم Wear OS شامل یک جزء نمایشگر چهره ساعت است. این کامپوننت سند WFF XML شما را تجزیه می‌کند و یک واچ فیس را از آن رندر می‌کند. منابع دیگر، مانند تصاویر و فونت ها، در صورت لزوم وارد می شوند.

این رویکرد به این معنی است که شما فقط باید زمان خود را صرف توضیح نحوه ظاهر صفحه ساعت کنید و Wear OS همه کدهای طراحی صفحه ساعت را مدیریت می کند.

برای استقرار صفحه ساعت با فرمت Watch Face در دستگاه، سند XML را در یک بسته استاندارد AAB یا APK بسته بندی کنید.

نمودار زیر یک نمای کلی از رویکرد را نشان می دهد:

چگونه سیستم Wear OS یک صفحه ساعت را از a          سند XML با فرمت چهره را تماشا کنید.

نسخه در WFF

با تکامل WFF، ویژگی‌های اضافی اضافه می‌شوند که با عناصر، ویژگی‌ها و منابع داده بیشتری که همگی از فرمت Watch Face استفاده می‌کنند، نشان داده می‌شوند.

به عنوان مثال، WFF نسخه 2 پشتیبانی Weather را به عنوان منبع داده معرفی کرد که در نسخه 1 WFF موجود نیست.

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

هر نسخه از WFF با نسخه Wear OS هماهنگ است:

نسخه WFF نسخه Minimum Wear OS حداقل سطح API
1 4 33
2 5 34
3 5.1 35
4 6 36

این راهنما را برای پیکربندی مناسب فایل ساخت AndroidManifest.xml و Gradle خود ببینید .

بیشتر بدانید

در این راهنماها درباره قالب Watch Face بیشتر بدانید:

  • ویژگی‌های موجود : قابلیت‌های صفحه ساعت را که هر نسخه از فرمت Watch Face پشتیبانی می‌کند، کاوش کنید.
  • دستورالعمل‌های طراحی : بهترین روش‌ها را برای چیدمان صفحه ساعت و تجربه کاربری خود بیاموزید.
  • Watch Face Designer : یاد بگیرید که چگونه از پلاگین Figma برای ایجاد صفحه ساعت خود استفاده کنید.
  • راه‌اندازی : یک بسته برنامه Android را پیکربندی کنید که از فرمت Watch Face پشتیبانی می‌کند.
  • نمونه‌های GitHub : با ساختن نمونه‌های صفحه ساعت و استقرار آنها در شبیه‌ساز Wear OS یا دستگاه فیزیکی خود شروع کنید.
  • بهینه سازی استفاده از حافظه : یاد بگیرید چگونه صفحه ساعت خود را پیکربندی کنید تا سیستم تا حد ممکن حافظه کمتری را هنگام رندر کردن صفحه ساعت شما مصرف کند.
  • مرجع XML : عناصر فردی را که بخشی از فایل فرمت Watch Face هستند کاوش کنید. عنصر ریشه همیشه WatchFace است. توجه: برای مشاهده ویژگی‌ها از یک نسخه فرمت واچ فیس خاص در مرجع XML، بررسی کنید که دکمه نسخه مناسب در بالای صفحه مستندات انتخاب شده باشد.
  • راهنمای انتشار : نحوه انتشار و کسب درآمد از صفحه ساعت خود را از طریق فروشگاه Play و روش‌های جایگزین بیاموزید.
  • WFF و اعتبارسنجی حافظه : از این ابزارهای منبع باز استفاده کنید تا فایل فرمت Watch Face خود را برای وجود خطا بررسی کنید و قبل از ارسال به Google Play، میزان مصرف قابل قبول حافظه را تأیید کنید.