{ "$schema":                      "https://json-schema.org/draft/2020-12/schema",
  "$id":                          "https://schemas.mpai.community/OSD/V1.5/data/PerceptibleEntity.json",
  "title":                        "Perceptible Entity V1.5",
  "type":                         "object",
  "additionalProperties":         false,
  "required":                     [ "Header", "PerceptibleEntityID", "PerceptibleEntityData" ],
  "properties":                   {

    "Header":                     { "type": "string", "pattern": "^OSD-PCE-V[0-9]{1,2}[.][0-9]{1,2}$", "description": "Perceptible Entity Header – Standard OSD-PCE-Vx.y" },
    "MInstanceID":                { "type": "string", "description": "Identifier of the M-Instance (Virtual Space) where this Perceptible Entity is located." },
    "UEnvironmentID":             { "type": "string", "description": "Identifier of the U-Environment (Real Space) where this Perceptible Entity is located." },
    "PerceptibleEntityID":        { "type": "string", "description": "Unique identifier of this Perceptible Entity instance." },
    "PerceptibleEntityTime":      { "$ref": "https://schemas.mpai.community/OSD/V1.5/data/SimpleTime.json", "description": "Time this Perceptible Entity was produced." },

    "PerceptibleEntitySpaceTime": { "$ref": "https://schemas.mpai.community/OSD/V1.5/data/SimpleTime.json", "description": "Space/Time where/when this Perceptible Entity is located." },

    "PerceptibleEntityData":      { "type": "object", "additionalProperties": false, "description": "The content of the Perceptible Entity: one of Object, Scene Descriptors, or Event Descriptors.",
                                    "properties": {
      "Object":                   { "$ref": "https://schemas.mpai.community/OSD/V1.5/data/Object.json",
                                    "description": "One of the supported Object types: 3D Model, Audio, Audio-Visual, Speech, Text, or Visual Object." },
      "SceneDescriptors":         { "$ref": "https://schemas.mpai.community/OSD/V1.5/data/SceneDescriptors.json",
                                    "description": "One of the supported Scene Descriptor types: 3D Model, Audio, Audio-Visual, Speech, or Visual Scene." },
      "EventDescriptors":         { "$ref": "https://schemas.mpai.community/OSD/V1.5/data/EventDescriptors.json",
                                    "description": "One of the supported Event Descriptor types: 3D Model, Audio, Audio-Visual, Speech, or Visual Event." } } },

    "DataXMData":                 { "$ref": "https://schemas.mpai.community/PTF/V1.0/data/DataExchangeMetadata.json",
                                    "description": "MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this Perceptible Entity in a trusted data exchange context." },
    "DescrMetadata":              { "type": "string", "maxLength": 2048, "description": "Human-readable descriptive metadata of the Perceptible Entity (plain text, max 2048 characters)." } } }
