Her zaman açık uygulamalar ve sistem ambiyans modu

anahtar kelimeler: wear,ambient,alwayson

Wear OS, kullanıcı kol saatini kullanmayı bıraktığında etkin bir uygulamanın düşük güç moduna geçmesini otomatik olarak yönetir. Buna sistem ortam modu denir. Kullanıcı belirli bir süre içinde kol saatiyle tekrar etkileşime geçerse Wear OS, kullanıcıyı uygulamada bıraktığı yere geri getirir.

Belirli kullanım alanları için (ör. koşu sırasında nabzı ve hızı görmek isteyen bir kullanıcı) düşük güç modunda nelerin gösterileceğini de kontrol edebilirsiniz. Hem ortam hem de etkileşimli modlarda çalışan Wear OS uygulamalarına her zaman açık uygulamalar denir.

Bir uygulamanın sürekli olarak görünür olmasını sağlamak pil ömrünü etkiler. Bu nedenle, bu özelliği uygulamanıza eklerken bu etkiyi göz önünde bulundurun.

Projenizi yapılandırma

Ambiyans modunu desteklemek için aşağıdaki adımları uygulayın:

  1. Giyilebilir uygulama oluşturma ve çalıştırma sayfasındaki yapılandırmalara göre projenizi oluşturun veya güncelleyin.
  2. WAKE_LOCK iznini AndroidManifest dosyasına ekleyin: 
<uses-permission android:name="android.permission.WAKE_LOCK" />

Her zaman açık modunu etkinleştirme

AmbientLifecycleObserver sınıfını kullanmak için aşağıdakileri yapın:

  1. Aşağıdaki örnekte gösterildiği gibi AmbientLifecycleObserver.AmbientLifecycleCallback arayüzünü uygulayın. Bu aşamada yöntemler boştur ancak rehberin ilerleyen bölümlerinde, ambiyans moduna girip çıkmak için görselleştirmede yapmanız gereken değişikliklerle ilgili ayrıntılar sağlanır.

    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. Bir AmbientLifecycleObserver oluşturun ve gözlemciyi kaydedin. Bu genellikle, etkinliğin yaşam döngüsü boyunca her zaman açık davranışının etkinleştirilmesine izin vermek için onCreate() veya Wear OS için Compose kullanılıyorsa üst düzey derlenebilir bileşende kullanılır.

    Kotlin

    private val ambientObserver = AmbientLifecycleObserver(activity, callback)

override fun onCreate(savedInstanceState: Bundle) {
  super.onCreate(savedInstanceState)
  lifecycle.addObserver(observer)

  // ...
}
  3. Her zaman açık davranışı artık gerekli olmadığında removeObserver()'ü çağırarak gözlemciyi kaldırın. Örneğin, bu yöntemi etkinliğinizin onDestroy() yönteminde çağırabilirsiniz.

Her zaman açık olan uygulamalar arka plana taşınabilir

Wear OS 5'ten itibaren sistem, belirli bir süre boyunca ambiyans modunda görünen her zaman açık uygulamaları arka plana taşır. Kullanıcılar, zaman aşımını sistem ayarlarından yapılandırabilir.

Her zaman açık uygulamanız, devam eden bir kullanıcı görevi (ör. müzik çalma veya antrenman oturumu) hakkında bilgi gösteriyorsa görev sona erene kadar devam eden etkinliği görünür durumda tutmak isteyebilirsiniz. Bunu yapmak için Devam Eden Etkinlik API'sini kullanarak her zaman açık etkinliğinizle bağlantılı bir devam eden bildirim yayınlayın.

Sistemin devam eden etkinliği tanıması için devam eden bildirimin dokunma amacı, aşağıdaki kod snippet'inde gösterildiği gibi her zaman açık etkinliğinizi işaret etmelidir:

// 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()
)

Ambiyans modunda görsel görünümü değiştirme

Varsayılan olarak, sürekli açık ekran özelliği uygulandığında saat ambiyans moduna girdiğinde ekranın görünümü değişmez. AmbientLifecycleCallback içindeki yöntemleri geçersiz kılarak bu davranışı değiştirebilirsiniz.

Güç tasarrufu yapmak için aşağıdakileri yapın:

  • Daha az pikseli aydınlatın ve ekranın büyük bir kısmını siyah bırakın. Ambiyans modunda yalnızca önemli bilgileri göstermeyi ve kullanıcı etkileşimli moda girdiğinde daha fazla ayrıntı sunmayı düşünün.
  • İçerikleri daha seyrek güncellemeler için ayarlayın. Örneğin, zamanlayıcıları en yakın saniyeye değil, en yakın dakikaya göre gösterin.
  • onEnterAmbient() yöntemine iletilen AmbientDetails nesnesinde:
    • deviceHasLowBitAmbient ayarlanmışsa mümkün olduğunda kenar yumuşatma özelliğini devre dışı bırakın.
    • burnInProtectionRequired ayarlanmışsa görselleştirmeyi düzenli aralıklarla değiştirin ve tamamen beyaz alanlar kullanmaktan kaçının.

Wear OS için Compose'u kullanırken durumu güncellemek için bu geri çağırma yöntemlerini kullanmanızı öneririz. Bu yöntemler, sistemin kullanıcı arayüzünüzü uygun şekilde yeniden oluşturmasına olanak tanır.

Bunun nasıl yapılacağına dair bir örnek için GitHub'daki, Horologist kitaplığındaki AmbientAware bileşenini kullanan, derleme tabanlı eğitim örneğine göz atın.