← All message topics · schema ProximityBlockInteraction/proximity_block_interaction_event_message.json

header

Field	Type	Required	Allowed values	Description
timestamp	string	✓
message_type	string	✓	`event`
version	string	✓		The message format version

msg

Field	Type	Required	Allowed values
experiment_id	string	✓
trial_id	string
timestamp	string	✓
source	string	✓
sub_type	string	✓	`Event:ProximityBlockInteraction`
version	string	✓
replay_parent_type	string\|null		`TRIAL` `REPLAY` `null`
replay_parent_id	string\|null
replay_id	string\|null

data

Field	Type	Required	Allowed values
mission_timer	string	✓
elapsed_milliseconds	number	✓
participant_id	string	✓
playername	string
action_type	string	✓	`ENTERED_RANGE` `LEFT_RANGE` `TRIAGE_ERROR`
players_in_range	number	✓
victim_x	number	✓
victim_y	number	✓
victim_z	number	✓
victim_id	number	✓
awake	boolean	✓

Example message

{
	"header": {
		"timestamp": "2019-12-26T12:47:23.1234Z",
		"message_type": "event",
		"version": "0.6"
	},
	"msg": { 
		"experiment_id": "563e4567-e89b-12d3-a456-426655440000",
		"trial_id": "123e4567-e89b-12d3-a456-426655440000",
		"timestamp": "2019-12-26T14:05:02.1412Z",
		"source": "simulator",
		"sub_type": "Event:ProximityBlockInteraction",
		"version": "2.1"
	},
	"data": {
		"mission_timer":"8 : 36",
		"participant_id": "E000231",
		"action_type": "ENTERED_RANGE",
		"elapsed_milliseconds": 15113,
		"players_in_range":2,
		"awake":false,
		"victim_x": -2185,
		"victim_y":28,
		"victim_z":198,
		"victim_id":33
	}
}

Raw JSON Schema (resolved)

{
  "$id": "http://asist.aptima.com/schemas/event_state.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {},
  "properties": {
    "data": {
      "$id": "#/properties/message/properties/data",
      "properties": {
        "action_type": {
          "$id": "#/properties/data/properties/triage_state",
          "enum": [
            "ENTERED_RANGE",
            "LEFT_RANGE",
            "TRIAGE_ERROR"
          ],
          "examples": [
            "IN_PROGRESS"
          ],
          "pattern": "^(.*)$",
          "title": "The Triage State Schema",
          "type": "string"
        },
        "awake": {
          "$id": "#/properties/data/properties/awake",
          "examples": [
            true,
            false
          ],
          "title": "The Awake Schema",
          "type": "boolean"
        },
        "elapsed_milliseconds": {
          "$id": "#/properties/event/state/elapsed_milliseconds",
          "examples": [
            5000,
            77459,
            689457
          ],
          "pattern": "^[0-9]+$",
          "title": "The Elapsed Milliseconds Schema",
          "type": "number"
        },
        "mission_timer": {
          "$id": "#/properties/event/state/mission_timer",
          "examples": [
            "8 : 36"
          ],
          "pattern": "^(.*)$",
          "title": "The Mission Timer Schema",
          "type": "string"
        },
        "participant_id": {
          "$id": "#/properties/data/properties/paticipant_id",
          "examples": [
            "E000231"
          ],
          "pattern": "^(.*)$",
          "title": "The Participant id Schema",
          "type": "string"
        },
        "playername": {
          "$id": "#/properties/data/properties/playername",
          "examples": [
            "Aptiminer1"
          ],
          "pattern": "^(.*)$",
          "title": "The Playername Schema",
          "type": "string"
        },
        "players_in_range": {
          "$id": "#/properties/event/state/players_in_range",
          "examples": [
            0,
            1,
            2,
            3
          ],
          "pattern": "^[0-9]$",
          "title": "The Players In Range Schema",
          "type": "number"
        },
        "victim_id": {
          "$id": "#/properties/data/properties/victim_id",
          "examples": [
            1,
            33,
            55
          ],
          "pattern": "^([0-9]+?)$",
          "title": "The Victim Id Schema",
          "type": "number"
        },
        "victim_x": {
          "$id": "#/properties/data/properties/victim_x",
          "examples": [
            -2185
          ],
          "pattern": "^([0-9]+?)$",
          "title": "The Victim_X Schema",
          "type": "number"
        },
        "victim_y": {
          "$id": "#/properties/data/properties/victim_y",
          "examples": [
            52
          ],
          "pattern": "^([0-9]+?)$",
          "title": "The Victim_Y Schema",
          "type": "number"
        },
        "victim_z": {
          "$id": "#/properties/data/properties/victim_z",
          "examples": [
            194
          ],
          "pattern": "^([0-9]+?)$",
          "title": "The Victim_Z Schema",
          "type": "number"
        }
      },
      "required": [
        "mission_timer",
        "elapsed_milliseconds",
        "participant_id",
        "action_type",
        "players_in_range",
        "victim_x",
        "victim_y",
        "victim_z",
        "victim_id",
        "awake"
      ],
      "title": "The proximity block interaction Event Data Schema",
      "type": "object"
    },
    "header": {
      "$id": "http://asist.aptima.com/schemas/common_header.json",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "definitions": {},
      "properties": {
        "message_type": {
          "$id": "#/properties/message_type",
          "const": "event",
          "enum": [
            "control",
            "observation",
            "chat",
            "status",
            "trial",
            "event",
            "groundtruth",
            "experiment",
            "metadata",
            "agent"
          ],
          "examples": [
            "observation"
          ],
          "pattern": "^([a-z_]*?)$",
          "title": "The Message_type Schema",
          "type": "string"
        },
        "timestamp": {
          "$id": "#/properties/timestamp",
          "examples": [
            "2019-12-26T12:47:23.1234Z"
          ],
          "pattern": "[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}[.]?[0-9]{0,}?Z",
          "title": "The Timestamp Schema",
          "type": "string"
        },
        "version": {
          "$id": "#/properties/version",
          "examples": [
            "1.0",
            "2.3.1"
          ],
          "pattern": "^([0-9]+\\.)?([0-9]+\\.)?([0-9]+)$",
          "title": "The message format version",
          "type": "string"
        }
      },
      "required": [
        "timestamp",
        "message_type",
        "version"
      ],
      "title": "ASIST message common header Schema",
      "type": "object",
      "version": "0.3"
    },
    "msg": {
      "$id": "http://asist.aptima.com/schemas/event_message.json",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "definitions": {},
      "properties": {
        "experiment_id": {
          "$id": "#/properties/experiment_id",
          "default": "",
          "examples": [
            "123e4567-e89b-12d3-a456-426655440000"
          ],
          "pattern": "(([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})|Not Set|Null|null)",
          "title": "The Experiment Id Schema",
          "type": "string"
        },
        "replay_id": {
          "$id": "#/properties/replay_id",
          "default": "",
          "examples": [
            "123e4567-e89b-12d3-a456-426655440000"
          ],
          "pattern": "(([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})|Not Set|null|Null)",
          "title": "The Replay Id Schema",
          "type": [
            "string",
            "null"
          ]
        },
        "replay_parent_id": {
          "$id": "#/properties/replay_parent_id",
          "default": "",
          "examples": [
            "123e4567-e89b-12d3-a456-426655440000"
          ],
          "pattern": "(([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})|Not Set|null|Null)",
          "title": "The Replay Parent Id Schema",
          "type": [
            "string",
            "null"
          ]
        },
        "replay_parent_type": {
          "$id": "#/properties/replay_parent_type",
          "enum": [
            "TRIAL",
            "REPLAY",
            null
          ],
          "title": "The Replay Parent Type Schema",
          "type": [
            "string",
            "null"
          ]
        },
        "source": {
          "$id": "#/properties/source",
          "default": "",
          "examples": [
            "simulator"
          ],
          "pattern": "^(.*)$",
          "title": "The Source Schema",
          "type": "string"
        },
        "sub_type": {
          "$id": "#/properties/sub_type",
          "const": "Event:ProximityBlockInteraction",
          "default": "",
          "examples": [
            "equip",
            "triage"
          ],
          "pattern": "^([a-zA-Z0-9_:]*?)$",
          "title": "The Sub Type Schema",
          "type": "string"
        },
        "timestamp": {
          "$id": "#/properties/timestamp",
          "default": "",
          "examples": [
            "2019-12-26T14:05:02.3412Z"
          ],
          "pattern": "[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}[.]?[0-9]{0,}?Z",
          "title": "The Timestamp Schema",
          "type": "string"
        },
        "trial_id": {
          "$id": "#/properties/trial_id",
          "default": "",
          "examples": [
            "123e4567-e89b-12d3-a456-426655440000"
          ],
          "pattern": "(([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})|Not Set|null|Null)",
          "title": "The Trial Id Schema",
          "type": "string"
        },
        "version": {
          "$id": "#/properties/version",
          "default": "",
          "examples": [
            "0.1",
            "1.0.1"
          ],
          "pattern": "^([.]*)|(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
          "title": "The Version Schema",
          "type": "string"
        }
      },
      "required": [
        "experiment_id",
        "timestamp",
        "source",
        "sub_type",
        "version"
      ],
      "title": "The Event Message Schema",
      "type": "object",
      "version": "0.5"
    }
  },
  "required": [
    "header",
    "msg",
    "data"
  ],
  "title": "The Proximity Block Interaction Schema",
  "type": "object",
  "version": "2.1"
}

Upstream spec documentation

Data Subtype: Event Message Format

This data message subtype is used to communicate event data for both the world and the player.

TOPIC

observations/events/player/proximity_block

Message Fields

Field Name	Type	Description
header	object	From Common Header Format section
msg	object	From the Common Event Message Format section
data.mission_timer	string	the mission time of the event
data.elapsed_milliseconds	number	the number of elapsed milliseconds since mission start
data.action_type	string enum	ENTERED_RANGE - players has entered triage range, LEFT_RANGE - player has left triage range, TRIAGE_ERROR - player has attempted triage before all required players have assembled
data.participant_id	string	the participant id of the player being reported
data.playername	string	[Deprecated]The name of the entity that changed state
players_in_range	number	the number of players that are within range of the victim
data.victim_x	integer	the x location of the entity
data.victim_y	integer	the y location of the entity
data.victim_z	integer	the z location of the entity
data.color	string	the color of the victim being triaged
data.triage_state	string	the new state of the triage event - IN_PROGRESS on MOUSEDOWN, UNSUCCESSFUL on MOUSEUP if victim not yet fully triaged, SUCCESSFUL on full triage
data.victim_id	integer	the unique id identifying the victim

Message Example

{
    "header": {
        "timestamp": "2019-12-26T12:47:23.1234Z",
        "message_type": "event",
        "version": "0.6"
    },
    "msg": { 
        "experiment_id": "563e4567-e89b-12d3-a456-426655440000",
        "trial_id": "123e4567-e89b-12d3-a456-426655440000",
        "timestamp": "2019-12-26T14:05:02.1412Z",
        "source": "simulator",
        "sub_type": "Event:ProximityBlockInteraction",
        "version": "2.1"
    },
    "data": {
        "mission_timer":"8 : 36",
        "participant_id": "E000231",
        "action_type": "ENTERED_RANGE",
        "elapsed_milliseconds": 15113,
        "players_in_range":2,
        "awake":false,
        "victim_x": -2185,
        "victim_y":28,
        "victim_z":198,
        "victim_id":33
    }
}

CHANGE HISTORY

VERSION | DATE | DETAILS | --- | --- | --- | 2.1 | 3/04/2022 | Added "awake" key to data. Will be true when the victim wakes up due to 1 medic and + n required teammates present 2.0 | 12/20/2021 | Changed Event:ProximityVictimInteraction to Event:ProximityBlockInteraction and topic to "observations/events/player/proximity_block" 1.2 | 8/12/2021 | deprecated playername and added participant_id 1.1 | 4/27/2021 | Added victim_id field 1.0 | 3/1/2021 | Initial Creation