فعالیت های پیکربندی را در Wear OS ارائه دهید

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

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

توجه: پیکربندی در برنامه همراه دستگاه در دستگاه‌هایی که سطح API 30 و بالاتر را هدف قرار می‌دهند در دسترس است. پیکربندی در یک برنامه دستی در همه دستگاه ها در دسترس است.

از جلسه ویرایشگر استفاده کنید

ما قویاً توصیه می کنیم که از پیکربندی در ساعت هوشمند پشتیبانی کنید تا کاربر بتواند بدون نیاز به دستگاه همراه، صفحه ساعت خود را سفارشی کند.

برای پشتیبانی از این، یک واچ فیس می‌تواند یک Activity پیکربندی را ارائه دهد و به کاربر اجازه دهد تنظیمات را با استفاده از EditorSession برگردانده شده از EditorSession.createOnWatchEditorSession تغییر دهد. همانطور که کاربر تغییرات را انجام می دهد، فراخوانی EditorSession.renderWatchFaceToBitmap یک پیش نمایش زنده از صفحه ساعت در Activity ویرایشگر ارائه می دهد.

یک هدف برای فعالیت های پیکربندی مشخص کنید

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

<service>
    <meta-data
        android:name="com.google.android.wearable.watchface.wearableConfigurationAction"
        android:value="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
    <meta-data
        android:name="com.google.android.wearable.watchface.companionBuiltinConfigurationEnabled"
        android:value="true" />
</service>

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

اگر صفحه ساعت شما فقط شامل یک فعالیت پیکربندی همراه یا پوشیدنی است، فقط باید ورودی فوق داده مربوطه را از مثال قبلی وارد کنید.

یک فعالیت پیکربندی پوشیدنی ایجاد کنید

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

برای ایجاد یک فعالیت پیکربندی پوشیدنی، یک فعالیت جدید به ماژول برنامه پوشیدنی خود اضافه کنید و فیلتر هدف زیر را در فایل مانیفست برنامه پوشیدنی اعلام کنید:

<activity
    android:name=".DigitalWatchFaceWearableConfigActivity"
    android:label="@string/digital_config_name">
    <intent-filter>
        <action android:name="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
        <category android:name=
        "com.google.android.wearable.watchface.category.WEARABLE_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

نام عملکرد در این فیلتر هدف باید androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR باشد.

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

یک فعالیت پیکربندی همراه ایجاد کنید

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

توجه: فعالیت‌های پیکربندی را فقط می‌توان برای دستگاه‌های دستی دارای Android مانند تلفن‌ها، تبلت‌ها و تاشوها نوشت.

برای ایجاد یک فعالیت پیکربندی همراه، یک فعالیت جدید به ماژول برنامه دستی خود اضافه کنید و فیلتر هدف زیر را در فایل مانیفست برنامه دستی اعلام کنید:

<activity
    android:name=".DigitalWatchFaceCompanionConfigActivity"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name=
            "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
        <category android:name=
        "com.google.android.wearable.watchface.category.COMPANION_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

در فعالیت پیکربندی خود، یک رابط کاربری بسازید که گزینه هایی برای سفارشی کردن تمام عناصر قابل تنظیم صفحه ساعت شما ارائه می دهد. پس از انتخاب کاربران، از Wearable Data Layer API برای اطلاع رسانی تغییر پیکربندی به فعالیت چهره ساعت استفاده کنید.

به منابع مرتبط زیر مراجعه کنید: