מתן פעילויות שקשורות להגדרות ב-Wear OS

חלק מתצוגות השעון תומכות בפרמטרים של הגדרה כדי לאפשר למשתמשים להתאים אישית את האופן שבו תצוגת השעון נראה ומתנהג. לדוגמה, חלק מתצוגות השעון מאפשרות למשתמשים לבחור צבע רקע בהתאמה אישית. המלצות אחרות תצוגות שעון שמסבירות מה השעה בשני אזורי זמן שונים מאפשרות למשתמשים לבחור באילו אזורי זמן שמעניינים אותם.

תצוגות שעון שתומכות בפרמטרים של הגדרות, מאפשרות למשתמשים להתאים אישית את תצוגת השעון באמצעות פעילות. המשתמשים יכולים להתחיל את פעילות ההגדרה של הלביש במכשיר הלביש. הן יכולות גם להתחיל את פעילות ההגדרה הנלווית מהאפליקציה הידנית, אם היא הותקנה. בנוסף, המשתמשים יכולים להגדיר את תצוגת השעון באפליקציה הנלווית של המכשיר ל-Wear OS 3 מכשירים.

הערה: ההגדרה באפליקציה הנלווית של המכשיר זמינה מכשירים שמטרגטים רמת API 30 ומעלה. ההגדרה של אפליקציה להחזקה ביד זמינה בכל מכשירים.

שימוש בסשן העריכה

מומלץ מאוד לתמוך בהגדרות האישיות בשעון החכם כדי המשתמשים יכולים להתאים אישית את תצוגת השעון בלי צורך במכשיר נלווה.

לשם כך, תצוגת שעון יכולה לספק הגדרה אישית Activity ולאפשר המשתמש משנה את ההגדרות באמצעות EditorSession שמוחזר מ- EditorSession.createOnWatchEditorSession. כשהמשתמש מבצע שינויים, הוא מתקשר EditorSession.renderWatchFaceToBitmap מספקת תצוגה מקדימה בזמן אמת של תצוגת השעון בעורך Activity.

ציון Intent לפעילויות של הגדרה

אם תצוגת השעון כוללת פעילויות שקשורות להגדרה, והגדרת את תצוגת השעון מהאפליקציה הנלווית של המכשיר, מוסיפים את רשומות המטא-נתונים הבאות להצהרת השירות ב: קובץ המניפסט של האפליקציה הלבישה:

<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>

פעילויות הגדרה רושמות מסנני Intent עבור ה-Intent הזה, והמערכת מפעילה את ה-Intent הזה כוונה כשמשתמשים רוצים להגדיר את תצוגת השעון.

אם תצוגת השעון כוללת רק פעילות נלווית או הגדרה לבישה, צריכים לכלול את רשומת המטא-נתונים המתאימה מהדוגמה הקודמת.

יצירת פעילות הגדרה של גאדג'ט לביש

פעילויות הגדרה של גאדג'טים לבישים מספקות קבוצה מוגבלת של אפשרויות להתאמה אישית תצוגת השעון, מפני שקשה לנווט בתפריטים מורכבים במסכים קטנים. בגאדג'ט הלביש פעילות של הגדרות אישיות, לספק אפשרויות בינאריות ורק כמה אפשרויות להתאמה אישית את ההיבטים העיקריים של תצוגת השעון.

כדי ליצור פעילות הגדרה של גאדג'ט לביש, צריך להוסיף פעילות חדשה למודול האפליקציה הלבישה ולהצהיר על מסנן ה-Intent הבא בקובץ המניפסט של האפליקציה הלבישה:

<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>

שם הפעולה במסנן Intent הזה חייב להיות androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR

בפעילות ההגדרות האישיות, בונים ממשק משתמש פשוט שמספק למשתמשים אפשרויות בחירה להתאים אישית את תצוגת השעון.

יצירת פעילות הגדרה נלווית

פעילויות הגדרה נלוות מעניקות למשתמשים גישה לקבוצה המלאה של אפשרויות הגדרה לתצוגת השעון, כי קל יותר לבצע אינטראקציה עם תפריטים מורכבים במסך הגדול של מכשיר להחזקה ביד. לדוגמה, פעילות תצורה במכשיר נישא מאפשרת לך להציג למשתמשים בוחרי צבעים מורכבים כדי לבחור את צבע הרקע של תצוגת השעון.

הערה: אפשר לכתוב פעילויות הגדרה רק למכשירים ניידים מכשירים שפועלת בהם מערכת Android, כמו טלפונים, טאבלטים ומכשירים מתקפלים.

כדי ליצור פעילות הגדרה נלווית, צריך להוסיף פעילות חדשה למודול האפליקציה הידנית להצהיר על מסנן ה-Intent הבא בקובץ המניפסט של האפליקציה להחזקה ביד:

<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 כדי להעביר את שינוי ההגדרה לפעילות של תצוגת השעון.

כדאי לעיין במקורות המידע שקשורים לנושא: