SHOW — Management and execution of drone shows

The messages in this section are used to get or set the configuration of both the drone show and the LED lights on the drones.

SHOW-ADAPT - Adapt the takeoff and RTH segments of a drone show or shift the net show vertically.

A client sends this request to the server to adapt the beginning (takeoff) and ending (RTH) segments of a drone show, leaving the net show segment in the middle intact. The client may specify new takeoff positions, RTH parameters, and optionally a vertical shift for the show segment.

The server response contains the adapted show file and the change in length of the takeoff and RTH segments in seconds.

Request fields

Name Required? Type Description

show

yes

string

Base64-encoded .skyc show file to adapt

transformations

yes

array of objects with type ("takeoff", "rth" or "shift") and parameters (TakeoffTransformationParameters, RthTransformationParameters or ShiftTransformationParameters accordingly)

List of transformations to apply to the show

environment

yes

object

A general object containing information about the environment of the show. It must contain a location object with the show geodetic origin (origin, GPSCoordinate) and orientation (orientation, float, orientation of the show coordinate system relative to true north, in degrees).

Response fields

Name Required? Type Description

show

yes

string

Base64-encoded .skyc show file with adapted takeoff and RTH segments

takeoffLengthChange

yes

float

Change in the length of the takeoff segment compared to the original show file, in seconds

rthLengthChange

yes

float

Change in the length of the RTH segment compared to the original show file, in seconds

reason

no

string

Explanation of why the show adaptation failed, if applicable

Example request

{
  "type": "SHOW-ADAPT",
  "show": "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",
  "transformations": [
    {
      "type": "takeoff",
      "parameters": {
        "positions": [[5, 5, 5], [6, 5, 5], [7, 5, 5], [8, 5, 5]],
        "method": "layered",
        "min_distance": 2,
        "velocity_xy": 4,
        "velocity_z": 2,
        "altitude": 10,
        "replace": true,
        "lights": {
          "type": "default",
          "brightness": 0.05
        }
      }
    },
    {
      "type": "rth",
      "parameters": {
        "method": "plain",
        "min_distance": 2,
        "velocity_xy": 4,
        "velocity_z": 2,
        "altitude": 10,
        "replace": true,
        "lights": {
          "type": "default",
          "brightness": 0.05
        }
      }
    }
  ],
  "environment": {
    "location": {
      "origin": [470000000, 190000000, 102000],
      "orientation": 180.2
    }
  }
}

Example response

{
  "type": "SHOW-ADAPT",
  "show": "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",
  "takeoffLengthChange": 6,
  "rthLengthChange": -1
}

SHOW-CFG - Retrieve the current configuration of the drone show

A client sends this request to the server to obtain information about the configuration of the drone show.

The server response contains an object of type DroneShowConfiguration, which for example can contain information about whether the show is authorized to start, the timestamp when the drone show should start, the identifier of the clock that the start time refers to and more.

Request fields

This request has no fields.

Response fields

Name Required? Type Description

configuration

yes

Object of type DroneShowConfiguration

Full configuration of a drone show

Example request

{
  "type": "SHOW-CFG"
}

Example response

{
  "type": "SHOW-CFG",
  "configuration": {
    "start": {
      "authorized": false,
      "authorizationScope": "lights",
      "clock": null,
      "time": 1581881192,
      "method": "auto",
      "uavIds": ["01", "42"]
    },
    "mapping": ["01", "02", null, "05", "42"],
    "duration": 294
  }
}

SHOW-CRTH-PLAN - Generate collective return-to-home plans for a drone show

A client sends a .skyc show file to the server and requests the generation of collective RTH (return-to-home) plans for it. These plans are alternative endings of a show at different timestamps that can be triggered adaptively on-site, allowing the operator to cancel the show mid-flight in an organized manner where drones return on collision-free paths.

Request fields

Name Required? Type Description

show

yes

string

Base64-encoded .skyc show file to generate collective RTH plans for

preferred_distance

no

float

Preferred distance between drones during collective RTH, in meters. If not specified, a default value of 5 meters will be used.

min_distance

no

float

Minimum distance between drones in collective RTH plans, in meters. If not specified, a default value of 3 meters will be used.

velocity_xy

no

float

Maximum horizontal velocity of drones during collective RTH, in m/s. If not specified, a default value of 4 m/s will be used.

velocity_z

no

float

Maximum vertical velocity of drones during collective RTH, in m/s. If not specified, a default value of 2 m/s will be used.

acceleration

no

float

Maximum acceleration of drones during collective RTH, in m/s². If not specified, a default value of 4 m/s² will be used.

time_resolution

no

integer

Time interval between start times of the generated collective RTH plans, in seconds. If not specified, a default value of 1 second will be used.

first_time

no

integer

Start time of the first collective RTH plan relative to show start, in seconds. If not specified, the start of the show will be used.

last_time

no

integer

Start time of the last collective RTH plan relative to show start, in seconds. If not specified, show segment end time will be used. If there is no show segment, the end of the show will be used.

Response fields

Name Required? Type Description

show

yes

string

Base64-encoded .skyc show file with the collective RTH plans appended

showDuration

yes

float

Total duration of the show including collective RTH and landing, in seconds

stats

yes

array of CollectiveRthPlanStatEntry

Statistics about each generated collective RTH plan

Example request

{
  "type": "SHOW-CRTH-PLAN",
  "show": "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",
  "preferred_distance": 3,
  "min_distance": 2,
  "time_resolution": 1,
  "first_time": 14,
  "last_time": 23
}

Example response

{
  "type": "SHOW-CRTH-PLAN",
  "show": "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",
  "showDuration": 43.771,
  "stats": [
    {
      "duration": 0,
      "showDuration": 34,
      "time": 14
    },
    {
      "duration": 0,
      "showDuration": 35,
      "time": 15
    },
    {
      "duration": 0,
      "showDuration": 36,
      "time": 16
    },
    {
      "duration": 0,
      "showDuration": 37,
      "time": 17
    },
    {
      "duration": 0,
      "showDuration": 38,
      "time": 18
    },
    {
      "duration": 0,
      "showDuration": 39,
      "time": 19
    },
    {
      "duration": 0,
      "showDuration": 40,
      "time": 20
    },
    {
      "duration": 0,
      "showDuration": 41,
      "time": 21
    },
    {
      "duration": 0,
      "showDuration": 42,
      "time": 22
    },
    {
      "duration": 0,
      "showDuration": 43,
      "time": 23
    }
  ]
}

SHOW-CRTH-START - Start collective return-to-home for a drone show

A client sends this request to the server to start a collective RTH (return-to-home) operation for a drone show. The response contains the time axis schedule of the show after the collective RTH request was issued.

Request fields

This request has no fields.

Response fields

Name Required? Type Description

schedule

yes

array of TimeAxisScheduleSegment

Time axis schedule of the show after the collective RTH operation was initiated

Example request

{
  "type": "SHOW-CRTH-START"
}

Example response

{
  "type": "SHOW-CRTH-START",
  "schedule": [
    {
      "type": "preparation",
      "startMs": 1783232746643,
      "endMs": 1783232756643,
      "params": {}
    },
    {
      "type": "slowdown",
      "startMs": 1783232756643,
      "endMs": 1783232766643,
      "params": {}
    },
    {
      "type": "rth",
      "startMs": 1783232766643,
      "endMs": 1783232886643,
      "params": {}
    }
  ]
}

SHOW-LIGHTS - Retrieve the current configuration of the behaviour of the LED lights on the show drones

A client sends this request to the server to obtain information about the configuration of the behaviour of the LED lights on drones participating in the show.

The server response contains an object of type DroneLightsConfiguration, which can contain information about the type and the color of the light effect used. The type of the light effect can either be off or solid. The former means that the GCS is not controlling the LED lights on the drones, while the latter means that the GCS is asking the show drones to use a solid LED light.

Request fields

This request has no fields.

Response fields

Name Required? Type Description

configuration

yes

Object of type DroneLightsConfiguration

Full configuration of the behaviour of the LED lights on a drone during a drone show

Example request

{
  "type": "SHOW-LIGHTS"
}

Example response

{
  "type": "SHOW-LIGHTS",
  "configuration": {
    "color": [0, 128, 255],
    "effect": "solid"
  }
}

SHOW-RESUME - Resume a previously suspended drone show

A client sends this request to the server to resume a previously suspended drone show. The response contains the time axis schedule of the show after the resume was issued, typically starting with a preparation segment followed by a speedup segment to ramp the show back to normal execution.

Request fields

This request has no fields.

Response fields

Name Required? Type Description

schedule

yes

array of TimeAxisScheduleSegment

Time axis schedule of the show after the resume was initiated

Example request

{
  "type": "SHOW-RESUME"
}

Example response

{
  "type": "SHOW-RESUME",
  "schedule": [
    {
      "type": "preparation",
      "startMs": 1783232746643,
      "endMs": 1783232756643,
      "params": {}
    },
    {
      "type": "speedup",
      "startMs": 1783232756643,
      "endMs": 1783232761643,
      "params": {}
    }
  ]
}

SHOW-SETCFG - Set the current configuration of the drone show

A client sends this request to the server to set the configuration of the drone show.

The server responds either with an ACK-ACK or ACK-NACK message.

Request fields

Name Required? Type Description

configuration

yes

Object of type DroneShowConfiguration

Full configuration of a drone show

Response fields

This request has no fields.

Example request

{
  "type": "SHOW-SETCFG",
  "configuration": {
    "start": {
      "authorized": true,
      "clock": null,
      "time": 1581881192,
      "method": "auto",
      "uavIds": ["01", "42"]
    },
    "mapping": ["01", "02", null, "05", "42"],
    "duration": 294
  }
}

Example response

{
  "type": "ACK-ACK"
}

SHOW-SETLIGHTS - Set the behaviour of the LED lights on the show drones

A client sends this request to the server to set the LED lights behaviour on the drones participating in the show.

The server responds either with an ACK-ACK or ACK-NACK message.

Request fields

Name Required? Type Description

configuration

yes

Object of type DroneLightsConfiguration

Full configuration of the behaviour of the LED lights on a drone during a drone show

Response fields

This request has no fields.

Example request

{
  "type": "SHOW-SETLIGHTS",
  "configuration": {
    "color": [255, 128, 0],
    "effect": "solid"
  }
}

Example response

{
  "type": "ACK-ACK"
}

SHOW-SUSPEND - Suspend a drone show

A client sends this request to the server to suspend a running drone show. The response contains the time axis schedule of the show after the suspension was issued.

Request fields

This request has no fields.

Response fields

Name Required? Type Description

schedule

yes

array of TimeAxisScheduleSegment

Time axis schedule of the show after the suspension was initiated

Example request

{
  "type": "SHOW-SUSPEND"
}

Example response

{
  "type": "SHOW-SUSPEND",
  "schedule": [
    {
      "type": "preparation",
      "startMs": 1783232746643,
      "endMs": 1783232756643,
      "params": {}
    },
    {
      "type": "slowdown",
      "startMs": 1783232756643,
      "endMs": 1783232761643,
      "params": {}
    }
  ]
}