API reference - Ricoh Theta

Command camera.startCapture

Starts continuously shoots. If exposureDelay option is enabled, self-timer shooting starts. Time shift shooting ignores self-timer.

After receiving an “inProgress” response, call /osc/commands/status API to know the completion of shooting and get a successful completion response.

HTTP method: POST
Request URL path: /osc/commands/execute
Request body: JSON
Response
- On successful completion (including the response of /osc/commands/status API)
  - HTTP status code: 200
  - Response body: JSON
- On execution in progress
  - HTTP status code: 200
  - Response body: JSON
- On error
  - HTTP status code: 4XX or 5XX
  - Response body: JSON

The shooting method changes according to captureMode option and _mode parameter settings. For Theta X, it is necessary to switch the shooting method using _shootingMethod option before executing this command.

In the still image shooting mode, one of the following shootings is started depending on the _mode parameter setting.

Burst shooting: Theta Z1 only
Continuous shooting: Theta X only
Interval composite shooting: Theta Z1 only
Interval shooting
Multi bracket shooting
Time shift shooting

In the movie shooting mode, _mode parameter cannot be specified.

For movie shooting or interval shooting with no shot count specified, state property of the response gets to “done” immediately. For movie shooting of Theta X, _fileUrls, an array of a file name going to be generated on shooting completed, is included in the response.

In one of the following shooting, progress information can be acquired from the response of /osc/commands/execute API and /osc/commands/status API. Also, state property of the response changes to done when shooting of the specified number of shots or shooting of the specified period has been finished.

Interval shooting with the shot count specified
Interval composite shooting
Multi bracket shooting
Time shift shooting
Continuous shooting

Some commands cannot be run while shooting a movie.