Keeping the display awake during hands-free auto-scroll in a watchOS reading app

I develop Folito, a free watchOS app for reading EPUB books on Apple Watch. We added an auto-scroll mode: the text scrolls continuously at a speed the user sets with the Digital Crown, so they can read hands-free with their wrist raised.

The display dims after the wake timeout because auto-scroll isn't user interaction, so the text becomes hard to read after 15–70 seconds while the user is still reading.

What we've considered

  • Pausing on isLuminanceReduced and resuming on tap. This works, but it needs a touch every minute.
  • Continuing in Always On (luminance reduced) with ~1 Hz line-by-line updates. This is our current plan, but the text is dimmed and SE models have no Always On.
  • WKExtendedRuntimeSession. None of the session types (self care, mindfulness, physical therapy, smart alarm, workout) describes reading, and we don't want to misuse one.
  • HKWorkoutSession. Not appropriate, because it would record fake workouts.

Questions

  1. Is there a supported way for a frontmost app to keep the display at normal brightness while showing continuously changing content the user is reading, without touch input?
  2. Would a WKExtendedRuntimeSession started only while auto-scroll runs (and ended as soon as it pauses or stops) be acceptable for this, and if so, which type?
  3. In Always On, what's the recommended way to keep text content advancing (for example, updating a ScrollView position via ScrollViewReader about once per second)?

I found thread 720495 (iOS, isIdleTimerDisabled) and thread 122753 (Always On, 2019), but neither covers a watchOS app that needs the display awake while content advances on its own.

Deployment target: watchOS 10, SwiftUI. Thanks!

There is no API that can prevent the Apple Watch from getting dimmed over time, and that is intentional due to the limited battery resource on the device.

The best I can see is that you use TimelineView to refresh the screen when your app runs in the frontmost + Always On mode. Even that, watchOS might use a cadence that’s slower than once per second when the screen is dimmed, which doesn't support your target of doing ~1 Hz line-by-line updates. You might want to re-design your app based on this reality.

Best,
——
Ziqiao Chen
 Worldwide Developer Relations.