Aplikasi yang selalu aktif dan mode standby sistem

keywords: wear,ambient,alwayson

Wear OS otomatis menangani peralihan ke mode daya rendah untuk aplikasi yang aktif saat pengguna tidak lagi menggunakan smartwatch. Hal ini disebut mode standby sistem. Jika pengguna berinteraksi lagi dengan smartwatch dalam jangka waktu tertentu, Wear OS akan mengembalikan pengguna ke aplikasi yang sebelumnya mereka tinggalkan.

Untuk kasus penggunaan tertentu—misalnya, pengguna yang ingin melihat detak jantung dan kecepatan selama berlari—Anda juga dapat mengontrol apa yang ditampilkan dalam mode standby daya rendah. Aplikasi Wear OS yang berjalan dalam mode interaktif dan mode standby disebut aplikasi yang selalu aktif.

Membuat aplikasi terus terlihat akan memengaruhi masa pakai baterai, jadi pertimbangkan dampak tersebut saat menambahkan fitur ini ke aplikasi Anda.

Mengonfigurasi project

Untuk mendukung mode standby, ikuti langkah-langkah berikut:

1. Buat atau update project Anda berdasarkan konfigurasi pada halaman Membuat dan menjalankan aplikasi wearable.
2. Tambahkan izin WAKE_LOCK ke file Manifes Android:

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

Mengaktifkan mode selalu aktif

Untuk menggunakan class AmbientLifecycleObserver, lakukan hal berikut:

1. Terapkan antarmuka AmbientLifecycleObserver.AmbientLifecycleCallback, seperti dalam contoh berikut. Pada tahap ini, metode akan kosong, tetapi selanjutnya panduan ini akan memberikan detail perubahan apa saja yang harus dilakukan untuk membuat visualisasi masuk dan keluar dari mode standby.

   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. Buat AmbientLifecycleObserver dan daftarkan observer. Biasanya, langkah ini akan digunakan di onCreate() atau composable tingkat atas jika menggunakan Compose untuk Wear OS, agar perilaku selalu aktif diaktifkan selama siklus proses aktivitas.

   Kotlin

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

3. Hapus observer dengan memanggil removeObserver(), jika perilaku selalu aktif tidak lagi diperlukan. Misalnya, Anda dapat memanggil metode ini dalam metode onDestroy() aktivitas Anda.

Aplikasi always-on dapat berpindah ke latar belakang

Mulai Wear OS 5, sistem akan memindahkan aplikasi yang selalu aktif ke latar belakang setelah aplikasi terlihat dalam mode standby selama jangka waktu tertentu. Pengguna dapat mengonfigurasi waktu tunggu di setelan sistem.

Jika aplikasi yang selalu aktif menampilkan informasi tentang tugas pengguna yang sedang berlangsung—seperti pemutaran musik atau sesi olahraga—Anda mungkin ingin aktivitas yang sedang berlangsung tetap terlihat hingga tugas berakhir. Untuk melakukannya, gunakan Ongoing Activity API untuk memposting notifikasi berkelanjutan yang ditautkan ke aktivitas selalu aktif Anda.

Catatan: Jika media diputar di perangkat Wear OS, aktivitas yang sedang berlangsung sudah berlangsung. Dalam hal ini, Anda tidak perlu membuat aktivitas lain yang sedang berlangsung.

Agar sistem dapat mengenali aktivitas yang sedang berlangsung, intent sentuh notifikasi yang sedang berlangsung harus mengarah ke aktivitas yang selalu aktif, seperti yang ditunjukkan dalam cuplikan kode berikut:

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

Mengubah tampilan visual dalam mode standby

Secara default, saat mengimplementasikan mode selalu aktif, layar tidak akan mengubah tampilannya saat smartwatch masuk ke mode standby. Anda dapat mengubah perilaku ini dengan mengganti metode di AmbientLifecycleCallback.

Untuk membantu menghemat daya, lakukan hal berikut:

• Terangi lebih sedikit piksel, dan buat sebagian besar layar tetap hitam. Sebaiknya hanya tampilkan informasi penting dalam mode standby, dan berikan detail selengkapnya saat pengguna masuk ke mode interaktif.
• Sesuaikan konten untuk update yang lebih jarang. Misalnya, tampilkan timer ke menit terdekat, bukan detik terdekat.
• Dalam objek AmbientDetails yang diteruskan ke onEnterAmbient():
  • Jika deviceHasLowBitAmbient disetel, nonaktifkan anti-aliasing jika memungkinkan.
  • Jika burnInProtectionRequired disetel, ubah visualisasi secara berkala, dan hindari area putih yang menyala terus.

Saat menggunakan Compose untuk Wear OS, sebaiknya gunakan metode callback ini untuk memperbarui status, yang memungkinkan sistem merekomposisi UI dengan tepat.

Untuk contoh cara melakukannya, lihat contoh Olahraga berbasis compose di GitHub, yang menggunakan composable AmbientAware dari library Horologist.