உள்ளடக்கத்திற்குச் செல்லவும்

Gauge Template

ஒரு வரம்பிற்குள் எண் மதிப்பைக் கண்காணியுங்கள்: அலகுடன் தற்போதைய அளவீடு, min/max முனைகள், மற்றும் server உங்களுக்காக நிரப்பும் முன்னேற்றப் பட்டை.

நேரடிச் செயல்பாட்டுச் செயல்விளக்கம்

Fields

FieldTypeDescription
templatestringRequired. Must be "gauge"
valuefloatRequired. Current value within the range. The server derives progress from (value - min_value) / (max_value - min_value) — don't send it
min_valuefloatRequired. Minimum value of the range
max_valuefloatRequired. Maximum value of the range. Must be greater than min_value
unitstringUnit label displayed after the value (e.g. "°C", "%", "rpm"). Max 32 characters
statestringStatus text (e.g. "Heating", "Ready")
iconstringSF Symbol name (e.g. "thermometer.medium") or MDI icon with mdi: prefix
subtitlestringSecondary descriptive text
accent_colorstringNamed color or hex. Default: orange
background_colorstringBackground color override
text_colorstringText color override
ஆப் பதிப்பு 1.14.0 இல் வருகிறது

On Lock Screen surfaces url_action and secondary_url_action render as buttons; the circular Dynamic Island variant has no inline buttons, so tap_action is the most useful field there. See Tap actions.

Example: Oven Preheating

Gauge புதுப்பிப்பு
{
  "state": "ongoing",
  "content": {
    "template": "gauge",
    "value": 125,
    "min_value": 0,
    "max_value": 250,
    "unit": "°C",
    "state": "Heating",
    "icon": "thermometer.medium",
    "accent_color": "orange"
  }
}

Example: Target Reached

Gauge முடிந்தது
{
  "state": "ended",
  "content": {
    "template": "gauge",
    "value": 250,
    "min_value": 0,
    "max_value": 250,
    "unit": "°C",
    "state": "Ready",
    "icon": "checkmark.circle.fill",
    "accent_color": "green"
  }
}

Use Cases

  • Smart home — oven temperature, thermostat setpoint, humidity sensors
  • 3D printing — hotend/bed temperature reaching target
  • Infrastructure — CPU temperature, disk fill percentage, memory usage
  • IoT — tank level, battery charge, signal strength