Schemas

Television

A networked television: power, a generic remote key vocabulary, volume and mute, and the optional input, app, and art-mode controls a product declares.

https://hometruth.ai/schemas/television · Television

Instances

No devices currently use this schema.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://hometruth.ai/schemas/television",
  "title": "Television",
  "description": "A networked television set: power, a generic remote key vocabulary, volume and mute, and — where the product has them — absolute volume, input selection, app launching, and an art/gallery idle mode.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "state": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "availability": {
          "enum": [
            "online",
            "offline",
            "degraded",
            "unknown"
          ]
        },
        "observedAt": {
          "type": "string",
          "format": "date-time"
        },
        "power": {
          "enum": [
            "on",
            "standby"
          ]
        },
        "input": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "required": [
            "id"
          ]
        },
        "app": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "required": [
            "id"
          ]
        },
        "volumePercent": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "muted": {
          "type": "boolean"
        },
        "artMode": {
          "enum": [
            "on",
            "off"
          ]
        }
      },
      "required": [
        "availability"
      ],
      "dependentRequired": {
        "power": [
          "observedAt"
        ]
      }
    },
    "actions": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "turnOn": {
          "type": "object",
          "additionalProperties": false,
          "properties": {}
        },
        "turnOff": {
          "type": "object",
          "additionalProperties": false,
          "properties": {}
        },
        "press": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "keys": {
              "type": "array",
              "minItems": 1,
              "maxItems": 64,
              "items": {
                "enum": [
                  "up",
                  "down",
                  "left",
                  "right",
                  "select",
                  "back",
                  "home",
                  "menu",
                  "info",
                  "exit",
                  "play",
                  "pause",
                  "stop",
                  "rewind",
                  "fastForward",
                  "channelUp",
                  "channelDown",
                  "source"
                ]
              }
            }
          },
          "required": [
            "keys"
          ]
        },
        "volumeUp": {
          "type": "object",
          "additionalProperties": false,
          "properties": {}
        },
        "volumeDown": {
          "type": "object",
          "additionalProperties": false,
          "properties": {}
        },
        "toggleMute": {
          "type": "object",
          "additionalProperties": false,
          "properties": {}
        },
        "setVolume": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "minimumPercent": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "maximumPercent": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "required": [
            "minimumPercent",
            "maximumPercent"
          ]
        },
        "setInput": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "inputs": {
              "type": "array",
              "minItems": 1,
              "maxItems": 32,
              "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "id"
                ]
              }
            }
          },
          "required": [
            "inputs"
          ]
        },
        "launchApp": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "apps": {
              "type": "array",
              "minItems": 1,
              "maxItems": 64,
              "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "id"
                ]
              }
            }
          },
          "required": [
            "apps"
          ]
        },
        "setArtMode": {
          "type": "object",
          "additionalProperties": false,
          "properties": {}
        },
        "getState": {
          "type": "object",
          "additionalProperties": false,
          "properties": {}
        }
      },
      "required": [
        "turnOn",
        "turnOff",
        "press",
        "volumeUp",
        "volumeDown",
        "toggleMute",
        "getState"
      ]
    }
  },
  "required": [
    "id",
    "state",
    "actions"
  ],
  "examples": [
    {
      "id": "living-room-tv",
      "state": {
        "availability": "online",
        "observedAt": "2026-09-18T20:00:00Z",
        "power": "on",
        "artMode": "off"
      },
      "actions": {
        "turnOn": {},
        "turnOff": {},
        "press": {
          "keys": [
            "up",
            "down",
            "left",
            "right",
            "select",
            "back",
            "home",
            "menu",
            "play",
            "pause"
          ]
        },
        "volumeUp": {},
        "volumeDown": {},
        "toggleMute": {},
        "setArtMode": {},
        "getState": {}
      }
    }
  ]
}