אפליקציות שפועלות כל הזמן ומצב רגישות של המערכת

מילות מפתח: wear,ambient,alwayson

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

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

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

הגדרת הפרויקט

כדי לתמוך במצב אווירה:

1. יוצרים או מעדכנים את הפרויקט על סמך ההגדרות בדף יצירה והפעלה של אפליקציה ללבישה.
2. מוסיפים את ההרשאה WAKE_LOCK לקובץ המניפסט של Android:

<uses-permission android:name="android.permission.WAKE_LOCK" />

הפעלת מצב תמיד מופעל

כדי להשתמש בכיתה AmbientLifecycleObserver:

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

   Kotlin

   val ambientCallback = object : AmbientLifecycleObserver.AmbientLifecycleCallback {
       override fun onEnterAmbient(ambientDetails: AmbientLifecycleObserver.AmbientDetails) {
       // ... Called when moving from interactive mode into ambient mode.
       }
   
       override fun onExitAmbient() {
       // ... Called when leaving ambient mode, back into interactive mode.
       }
   
       override fun onUpdateAmbient() {
       // ... Called by the system in order to allow the app to periodically
       // update the display while in ambient mode. Typically the system will
       // call this every 60 seconds.
       }
   }

2. יוצרים AmbientLifecycleObserver ומירשם את הצופה. בדרך כלל, משתמשים ב-onCreate() או ב-composable ברמה העליונה אם משתמשים ב-Compose ל-Wear OS, כדי לאפשר הפעלה של ההתנהגות 'תמיד פועל' לאורך מחזור החיים של הפעילות.

   Kotlin

   private val ambientObserver = AmbientLifecycleObserver(activity, callback)
   
   override fun onCreate(savedInstanceState: Bundle) {
     super.onCreate(savedInstanceState)
     lifecycle.addObserver(observer)
   
     // ...
   }

3. כשאין יותר צורך בהתנהגות 'תמיד פועל', צריך להסיר את הצופה באמצעות קריאה ל-removeObserver(). לדוגמה, אפשר להפעיל את השיטה הזו ב-method‏ onDestroy() של הפעילות.

אפליקציות שפועלות תמיד יכולות לעבור לרקע

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

אם באפליקציה שפועלת כל הזמן מוצג מידע על משימה שהמשתמש מבצע, כמו הפעלת מוזיקה או סשן אימון, כדאי להשאיר את הפעילות המתמשכת גלויה עד שהמשימה תסתיים. כדי לעשות זאת, משתמשים ב-Ongoing Activity API כדי לפרסם התראה מתמשכת שמקושרת לפעילות שלכם שפועלת כל הזמן.

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

// Create a pending intent that point to your always-on activity
val touchIntent =
    PendingIntent.getActivity(
        context,
        0,
        Intent(context, MyAlwaysOnActivity::class.java),
        PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
    )

val notificationBuilder =
    NotificationCompat.Builder(this, CHANNEL_ID)
    // ...
    .setOngoing(true)

val ongoingActivity =
    OngoingActivity.Builder(
        applicationContext, NOTIFICATION_ID, notificationBuilder
    )
    // ...
    .setTouchIntent(touchIntent)
    .build()

ongoingActivity.apply(applicationContext)

notificationManager.notify(
    NOTIFICATION_ID,
    notificationBuilder.build()
)

שינוי המראה החזותי במצב רגיש לסביבה

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

כדי לחסוך בחשמל, כדאי לבצע את הפעולות הבאות:

• להאיר פחות פיקסלים ולהשאיר את רוב המסך שחור. מומלץ להציג רק מידע קריטי במצב אווירה, ולספק פרטים נוספים כשהמשתמש עובר למצב אינטראקטיבי.
• לשנות את התוכן כך שיהיה צורך לעדכן אותו בתדירות נמוכה יותר. לדוגמה, הצגת טיימרים עד לדקה הקרובה ביותר במקום לשנייה הקרובה ביותר.
• באובייקט AmbientDetails שמועבר אל onEnterAmbient():
  • אם הערך של deviceHasLowBitAmbient מוגדר, משביתים את סינון הרעשי התמונה (anti-aliasing) במידת האפשר.
  • אם הערך של burnInProtectionRequired מוגדר, כדאי להזיז את התצוגה החזותית מדי פעם ולהימנע מאזורים לבנים מוצקים.

כשמשתמשים ב-Compose ל-Wear OS, מומלץ להשתמש בשיטות החזרה (callbacks) האלה כדי לעדכן את המצב, וכך לאפשר למערכת ליצור מחדש את ממשק המשתמש באופן מתאים.

דוגמה לאופן שבו אפשר לעשות זאת מופיעה ב דוגמה לתרגיל שמבוססת על compose ב-GitHub, שמשתמשת ב-AmbientAware הניתן ליצירה מתוך הספרייה Horologist.