หน้านี้ได้รับการแปลโดย Cloud Translation API

แอปที่เปิดตลอดเวลาและโหมดแอมเบียนท์ของระบบ

Wear OS จะจัดการการเปลี่ยนแอปที่ใช้งานอยู่ไปยังโหมดพลังงานต่ำโดยอัตโนมัติเมื่อผู้ใช้ไม่ได้ใช้นาฬิกาแล้ว ซึ่งเรียกว่าโหมดแอมเบียนท์ของระบบ หากผู้ใช้โต้ตอบกับ แสดงอีกครั้งภายในกรอบเวลาที่กำหนด Wear OS จะนำผู้ใช้กลับไปยังแอปที่ สิ่งที่ทำค้างไว้

สำหรับกรณีการใช้งานที่เจาะจง เช่น ผู้ใช้ต้องการดูอัตราการเต้นของหัวใจและก้าวระหว่าง วิ่ง-คุณ ยังควบคุมสิ่งที่จะแสดงในโหมดแอมเบียนท์ที่ใช้พลังงานต่ำได้ด้วย แอป Wear OS ที่ทำงานทั้งในโหมดแอมเบียนท์และโหมดอินเทอร์แอกทีฟเรียกว่าแอปที่ทำงานอยู่เสมอ

การแสดงแอปให้เห็นอยู่ตลอดเวลาจะส่งผลต่ออายุการใช้งานแบตเตอรี่ ดังนั้นโปรดพิจารณาผลกระทบดังกล่าวเมื่อเพิ่มฟีเจอร์นี้ลงในแอป

กำหนดค่าโปรเจ็กต์

หากต้องการรองรับโหมดแอมเบียนท์ ให้ทำตามขั้นตอนต่อไปนี้

สร้างหรืออัปเดตโปรเจ็กต์ตามการกำหนดค่าในหน้าสร้างและเรียกใช้แอปที่สวมใส่ได้
เพิ่มสิทธิ์ WAKE_LOCK ลงในไฟล์ Android Manifest ดังนี้

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

เปิดใช้โหมดเปิดตลอดเวลา

หากต้องการใช้ AmbientLifecycleObserverแล้วทำดังนี้

ใช้อินเทอร์เฟซ 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.
    }
}

สร้าง AmbientLifecycleObserver และลงทะเบียนผู้สังเกตการณ์ โดยปกติแล้ว จะใช้ใน onCreate() หรือคอมโพสิเบิลระดับบนสุดหากใช้ Compose สำหรับ Wear OS เพื่อเปิดใช้ลักษณะการทำงานแบบเปิดอยู่ตลอดตลอดอายุการใช้งานของกิจกรรม
Kotlin
```
private val ambientObserver = AmbientLifecycleObserver(activity, callback)

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

  // ...
}
```
นำผู้สังเกตการณ์ออก โดยโทรหา removeObserver() เมื่อเปิดฟีเจอร์เปิดตลอดเวลา ไม่จำเป็นต้องมีลักษณะการทำงานอีกต่อไป เช่น คุณอาจเรียกใช้เมธอดนี้ในเมธอด onDestroy() ของกิจกรรม

แอปที่ทำงานอยู่เสมอจะย้ายไปอยู่เบื้องหลังได้

ตั้งแต่ Wear OS 5 เป็นต้นไป ระบบจะย้ายแอปที่ทำงานอยู่เสมอไปไว้เบื้องหลังหลังจากที่แอปปรากฏในโหมดแอมเบียนท์เป็นระยะเวลาหนึ่ง ผู้ใช้สามารถกำหนดค่าการหมดเวลาในการตั้งค่าระบบ

หากแอปที่ทำงานอยู่เสมอแสดงข้อมูลเกี่ยวกับงานที่ผู้ใช้กำลังทำอยู่ เช่น การเล่นเพลงหรือเซสชันการออกกําลังกาย คุณอาจต้องแสดงกิจกรรมที่ดำเนินอยู่จนกว่างานจะเสร็จสิ้น โดยใช้ 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 ไว้ ให้ปิดใช้การลบรอยหยัก หากทำได้
- หากตั้งค่า burnInProtectionRequired ให้เลื่อนการแสดงภาพไปรอบๆ เป็นระยะๆ และหลีกเลี่ยงพื้นที่สีขาวล้วน

เมื่อใช้ Compose สำหรับ Wear OS เราขอแนะนำให้ใช้เมธอดการเรียกกลับเหล่านี้เพื่ออัปเดตสถานะ ซึ่งจะช่วยให้ระบบจัดเรียง UI ของคุณใหม่ได้อย่างเหมาะสม

ดูตัวอย่างวิธีดำเนินการได้ที่ตัวอย่างแบบคอมโพสิทใน GitHub ซึ่งใช้ประโยชน์จาก AmbientAwarecomposable จากไลบรารี Horologist