toggle and button only to iOS; the user places them
The banner needs a running Live Activity, so it follows the rules in
Live Activity and Dynamic Island: "liveActivity": true (or live.activity.start), 4 KB of state per
update, 8 hours per session. Its scene is drawn with the same tiles as everywhere
else (Glance Surfaces), in the app's Glass look.
Banner
The banner is wider and taller than the island's bottom region, so a scene of two or
three rows fits. Interactive tiles (toggle, button, step) show only for
controls the author declared in glance.controls[], so declare the ones you want to
press from the banner; auto-derived controls stay pick-list-only.
If you leave lockScreen out, the banner repeats island.expanded.bottom. Write it
when the banner should show more than the island can.
Accessory widgets
Accessory families are small and drawn in the system's monochrome, so a gauge arc
reads as a smudge where a number reads as a number. The re-flow rules, applied when
you give no override:
accessoryRectangular: the first row, non-interactive tiles drawn as values.
accessoryCircular: the first gauge or ring, else the first bound value.
accessoryInline: "label value" of the first bound tile.
Give an override ("accessoryCircular": { "rows": <span class="wikibroken" title="unresolved: …">…</span> } inside the widget) to
choose the tile yourself.
Constraints
The frontmatter constraints block lists, as JSON, the banner's limits, the three
accessory families with their tile limits and allowed tiles, and the corner-control
kinds. Interactive tiles are not offered on accessories: iOS shows no controls in
those slots.
Generated from ControlDocs/lock-screen.md. Something unclear or missing? Tell me.