Skip to content

Latest commit

 

History

History
75 lines (52 loc) · 3.85 KB

camera.start_capture.md

File metadata and controls

75 lines (52 loc) · 3.85 KB
Raw

camera.startCapture

Overview

Starts continuously shoots.
The shooting method changes according to the shooting mode (captureMode) and _mode settings.

In the still image shooting mode, interval shooting, interval composite shooting, multi bracket shooting, time shift shooting, burst shooting and continuous shooting is started depending on the _mode setting.
In the movie shooting mode, movie shooting is started.

If exposureDelay is enabled, self-timer shooting is started. Time shift shooting ignores self-timer.

For movie shooting or interval shooting with no shot count specified, "state" for Commands/Execute and Commands/Status changes to "done" immediately.
For interval shooting with the shot count specified, interval composite shooting, multi bracket shooting, time shift shooting, or continuous shooting, progress information can be acquired from the progress object of Commands/Execute and Commands/Status. Also, "state" changes to "done" when shooting of the specified number of shots or shooting of the specified period of time has been finished.

For RICOH THETA X, it is necessary to switch the shooting method using _shootingMethod before executing this API.

Support model

_mode Shooting mode X Z1 V SC S
interval Interval shooting All All All All v01.62 or later
bracket Multi bracket shooting All All All v1.10 or later v01.82 or later
composite Interval composite shooting --- All --- v1.10 or later v01.82 or later
timeShift Time shift shooting All All v3.00.1 or later --- ---
Movie shooting All All All All v01.62 or later
moveInterval Interval shooting (optimized *1, Tripod stabilization Off) --- v1.50.1 or later v3.40.1 or later --- ---
fixInterval Interval shooting (optimized *1, Tripod stabilization On) --- v1.50.1 or later v3.40.1 or later --- ---
burst Burst shooting --- v2.10.1 or later --- --- ---
continuous Continuous shooting All --- --- --- ---

*1 Top/bottom correction and stitching conditions are optimized.

Parameters

Name Type Description
_mode String Continuously shoots in the still image shooting mode.
Please refer to *2 the behavior when _mode is not set.
This parameter cannot be specified in the movie shooting mode.

*2 For THETA X, capture will be started as the method set by _shootingMethod option. For other than THETA X, Interval shooting will be started.

Results

"Results" value when "state" of Commands/Execute and Commands/Status is "done".
Depends on the shooting method.

For movie shooting or interval shooting with no shot count specified

None.

For interval shooting with the shot count specified, interval composite shooting, multi bracket shooting, time shift shooting, burst shooting or continuous shooting.

Name Type Description
fileUrls String Array List of file URLs

Remark

For movie shooting, the response includes _fileUrls information at the timing of camera.startCapture.
This feature is available with THETA X firmware v2.61.0 or later.

{
    "_fileUrls": [
        "http://192.168.1.1/files/100RICOH/R0011234.MP4"
    ],
    "id": "1234",
    "name": "camera.startCapture",
    "state": "done"
}

Restriction

Some commands cannot be run while shooting a movie.