Skip to main content

Push_start

Push_Start​

This call will instantly start a new push of "STREAMNAME" to the given "URI".

The possible values for "URI" can be gathered from the capabilities of the output protocols, and is in the "push_urls" field, which may be either a string or array of strings. It is also possible to use various variables inside the URI, as detailed in variable substitution , and there are also URL parameters as detailed in url parameters.

The "STREAMNAME" may take any of three forms, representing a full stream name, a partial wildcard stream name, or a full wildcard streamname:

  • foo --- Only the stream named "foo", without a wildcard.

  • foo+ --- All streams named "foo" that have a wildcard behind them, but not without wildcard.

  • foo+bar --- Only the stream named "foo" with a wildcard value of "bar".

It is requested as follows:

//Either...
{
  "push_start":{
    "stream": "STREAMNAME",
    "target": "URI",
  }
}
//Or...
{
  "push_start":["STREAMNAME", "URI"]
}

There is no response to this call.