Files
VibemakerSandbox/app/src/platform/loader/robot.schema.json
T

471 lines
11 KiB
JSON

{
"type": "object",
"additionalProperties": false,
"required": [
"schema",
"id",
"name",
"family",
"adapter",
"model",
"assets",
"base",
"sim",
"joints",
"observations",
"actions",
"actuation",
"commands",
"skills",
"input",
"render",
"presentation",
"termination",
"license"
],
"properties": {
"schema": {
"const": 1
},
"id": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"name": {
"type": "string"
},
"family": {
"type": "string"
},
"adapter": {
"enum": ["generic", "microduck"]
},
"model": {
"type": "string"
},
"assets": {
"type": "array",
"items": {
"type": "object",
"required": ["path", "vfs"],
"additionalProperties": false,
"properties": {
"path": {
"type": "string"
},
"vfs": {
"type": "string",
"pattern": "^(?!/)(?!.*\\.\\.)[^\\\\]+$"
}
}
}
},
"dimensions": {
"type": "object",
"required": ["height"],
"additionalProperties": false,
"properties": {
"height": { "type": "number", "exclusiveMinimum": 0 }
}
},
"base": {
"type": "object",
"required": ["type", "root_body", "freejoint", "spawn"],
"additionalProperties": false,
"properties": {
"type": {
"const": "floating"
},
"root_body": {
"type": "string"
},
"freejoint": {
"type": "string"
},
"spawn": {
"type": "object",
"required": ["pos", "yaw"],
"additionalProperties": false,
"properties": {
"pos": {
"type": "array",
"items": {
"type": "number"
},
"minItems": 3,
"maxItems": 3
},
"yaw": {
"type": "number"
}
}
},
"initial": {
"type": "object",
"additionalProperties": {
"type": "number"
}
}
}
},
"sim": {
"type": "object",
"required": ["timestep", "decimation"],
"additionalProperties": false,
"properties": {
"timestep": {
"type": "number",
"exclusiveMinimum": 0
},
"decimation": {
"type": "integer",
"minimum": 1
}
}
},
"joints": {
"type": "object",
"required": ["groups", "defaults"],
"additionalProperties": false,
"properties": {
"source": {
"const": "onnx_metadata"
},
"groups": {
"type": "object",
"required": ["policy"],
"properties": {
"policy": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
}
},
"defaults": {
"type": "object",
"additionalProperties": {
"type": "number"
}
}
}
},
"observations": {
"type": "object",
"minProperties": 1,
"additionalProperties": {
"type": "object",
"required": ["terms"],
"additionalProperties": false,
"properties": {
"history": { "type": "integer", "minimum": 1, "maximum": 64 },
"layout": { "enum": ["frame_major", "term_major"] },
"terms": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["type"],
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"gyro",
"projected_gravity",
"joint_pos_rel",
"joint_vel",
"last_action",
"motion_command",
"command"
]
},
"sensor": {
"type": "string"
},
"body": {
"type": "string"
},
"group": {
"type": "string"
},
"size": {
"type": "integer",
"minimum": 1
}
}
}
}
}
}
},
"actions": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["type", "group", "scale", "offset"],
"additionalProperties": false,
"properties": {
"type": {
"const": "joint_position"
},
"group": {
"type": "string"
},
"scale": {
"type": "number"
},
"offset": {
"const": "default"
}
}
}
},
"actuation": {
"type": "object",
"required": ["type"],
"additionalProperties": false,
"properties": {
"type": {
"enum": ["native_position", "joint_pd"]
},
"kp": {
"type": "number",
"minimum": 0
},
"kd": {
"type": "number",
"minimum": 0
},
"torque_limit": {
"type": "number",
"exclusiveMinimum": 0
},
"joints": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": false,
"properties": {
"kp": { "type": "number", "minimum": 0 },
"kd": { "type": "number", "minimum": 0 },
"torque_limit": { "type": "number", "exclusiveMinimum": 0 },
"velocity_limit": { "type": "number", "exclusiveMinimum": 0 },
"keep_velocity": { "type": "number", "exclusiveMinimum": 0 }
}
}
}
}
},
"commands": {
"type": "object",
"required": ["size", "limits"],
"additionalProperties": false,
"properties": {
"size": {
"type": "integer",
"minimum": 3
},
"limits": {
"type": "array",
"items": {
"type": "number"
},
"minItems": 3,
"maxItems": 3
}
}
},
"skills": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["id", "kind", "owns", "controller"],
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": ["primary", "overlay", "episodic", "recovery"]
},
"owns": {
"type": "string"
},
"available": { "type": "boolean" },
"duration": { "type": "number", "exclusiveMinimum": 0 },
"blend": { "type": "number", "exclusiveMinimum": 0 },
"observations": { "$ref": "#/properties/observations" },
"actions": { "$ref": "#/properties/actions" },
"defaults": { "$ref": "#/properties/joints/properties/defaults" },
"reference": { "type": "string", "minLength": 1 },
"controller": {
"type": "object",
"required": ["type"],
"additionalProperties": false,
"properties": {
"type": {
"enum": ["onnx", "oscillator"]
},
"policy": {
"type": "string"
},
"frequency": {
"type": "number",
"exclusiveMinimum": 0
},
"amplitude": {
"type": "number",
"minimum": 0
},
"blend": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
}
}
},
"input": {
"type": "object",
"required": ["bindings"],
"additionalProperties": false,
"properties": {
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": ["action", "codes", "label"],
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"codes": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"label": {
"type": "string"
},
"disabled": { "type": "boolean" }
}
}
}
}
},
"render": {
"type": "object",
"required": ["source", "camera"],
"additionalProperties": false,
"properties": {
"source": {
"enum": ["glb", "mjcf_visual"]
},
"body_visuals": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["body", "path"],
"additionalProperties": false,
"properties": {
"body": { "type": "string", "minLength": 1 },
"path": {
"type": "string",
"pattern": "^(?!/)(?!.*\\.\\.)[^\\\\:?#]+\\.glb$"
},
"position": {
"type": "array",
"minItems": 3,
"maxItems": 3,
"items": { "type": "number" }
},
"quaternion": {
"type": "array",
"minItems": 4,
"maxItems": 4,
"items": { "type": "number" }
}
}
}
},
"groups": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0
}
},
"camera": {
"type": "object",
"required": ["distance"],
"additionalProperties": false,
"properties": {
"distance": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
}
},
"presentation": {
"type": "object",
"required": ["theme"],
"additionalProperties": false,
"properties": {
"world": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"theme": {
"enum": ["comic", "neutral"]
}
}
},
"termination": {
"type": "object",
"required": ["tilt_z", "min_height", "on_fall"],
"additionalProperties": false,
"properties": {
"tilt_z": {
"type": "number",
"minimum": -1,
"maximum": 1
},
"min_height": {
"type": "number"
},
"on_fall": {
"enum": ["recovery", "hold"]
}
}
},
"legacy": {
"type": "object"
},
"license": {
"type": "string",
"minLength": 1
}
}
}