This is a community document based on contributions of informal test results from the theta360.guide independent community. This is not an official RICOH document. For official information, please contact RICOH. You should confirm these community tips with your own tests prior to deployment in a business setting. These are unofficial tips about the SC2 WebAPI. The official RICOH THETA API may change unexpectedly, and these techniques could stop working.
| Limited API | Explanation |
| commands/status | Only works with SC2 for takePicture. Cannot be used with startCapture. To see when the interval or bracket shooting is finished when using startCapture, use osc/state and look for _captureState of the SC2 |
| camera.startCapture | SC2 does not support interval composite shooting. Additionally, only the SC2B supports time shift shooting. You will not be able to use time shift on the standard SC2 |
| camera.stopCapture | when interval shooting captureNumber is set to 0 (unlimited shots in interval shooting), the SC2 will not return the list of files when stopCapture is finished |
| camera.listFiles | SC2 will not show multiple thumbnails when maxThumbSize is set to 640. It will only return a single thumbnail. To get multiple thumbnails, get each thumbnail individually in a loop. You can also use GET to grab the thumbnail of each file as binary data by adding ?type=thumb to the URL |
| camera.delete | Prior to firmware 1.42, the SC2 could not delete more than one image or video file when specified as a list. It also didn’t support the“all” parameter to delete all files. |
| camera._getMetadata | does not return correct information. Workaround is to download the file to your mobile device and then extract the metadata locally after download. |
| camera._getMySetting | May not be returning correct results on the SC2. Note that the SC2 reverts to MySetting when the Wi-Fi connection is dropped or the camera is restarted or resumed from sleep. See the article below for more information.https://docs.google.com/document/d/e/2PACX-1vTPLBqVabuiic4uuSAy-h9PSCZOgtqY7mweDJnS5bXvpJuYwToVxlqpOtbGXfR279tN6nQRN7cqs2xX/pub |
| Unsupported API | Explanation |
| GET /plugin | SC2 does not support plug-ins |
| camera._convertVideoFormats | SC2 has fixed parameters for video. Also, it appears that topBottomCorrection may be applied after the file is downloaded versus applying topBottomCorrection inside the camera. |
| camera._cancelVideoConvert | SC2 cannot perform video conversions |
| camera._listAccessPoints | SC2 does not support client mode connections and thus cannot connect to external Wi-Fi access points |
| camera._setAccessPoint | Set access point in client mode. SC2 only supports access point mode. |
| camera._deleteAccessPoint | SC2 does not support client mode Wi-Fi and thus cannot save external Wi-Fi access point information inside the camera. |
| camera._listPlugins | SC2 does not support plug-ins |
| camera._setPlugins | SC2 does not support plug-ins |
| camera._pluginControl | SC2 does not support plug-ins |
| camera._getPluginLicense | SC2 does not support plug-ins |
| camera._getPluginOrders | SC2 does not support plug-ins |
| camera._setPluginOrders | SC2 does not support plug-ins |
| camera._deleteMySetting | does not appear to delete all the settings on the SC2. Suggest you overwrite the settings in MySetting. Also, it appears that camera.reset may not reset all the SC2 settings in MySetting. See the article link in the camera._getMySetting section. |
| aperture | Only Z1 has an adjustable aperture |
| _authentication | SC2 does not support client mode and thus cannot disable digest authentication for client mode. |
| _bluetoothPower | Does not appear to work on the SC2, but you can turn on bluetooth manually with the button on the side of the camera. |
| _compositeShootingOutputInterval | Only Z1 support interval composite shooting |
| _compositeShootingTime | Only Z1 support interval composite shooting |
| _HDMIreso | No HDMI output on Z1. |
| _imageStitching | SC2 cannot control image stitching |
| _language | not supported on SC2. even on the Z1, it’s not clear what impact this setting has. |
| _microphone | |
| _microphoneChannel | |
| _networkType | |
| _password | |
| previewFormat | width and height not working. SC2 only has one preview format and one fps. |
| _shootingMethod | for MySetting |
| _topBottomCorrection | |
| videoStitching | |
| _visibilityReduction | reduce size of tripod at bottom of image |
| _username | name for client mode digest authentication. SC2 does not support client mode Wi-Fi connections |
| _wlanFrequency | SC2 only supported 2.4GHz. Z1 supports 2.4GHz and 5GHz |
| API | Explanation |
| cameraMode presets | SC2 has unique presets for face mode, night view mode, lens-by-lens exposure. SC2B also has room mode |
| API | Explanation |
| camera.reset | offDelay is set to 64800 (18 hours) on reset. For the SC2, the offDelay is reset to 600 (10 minutes). |
THETA Z1 and SC2 can save shooting conditions set with a smartphone or the API. Shooting conditions registered in My Settings can be enabled by the end user by pressing and holding the Function (Fn) button on the THETA. The advantage is that you can save your shooting conditions and use them even while not connected to a smartphone.
The SC2 has a slower processor than the Z1. The SC2 takes approximately 8,181 milliseconds to be ready for the next picture versus 2,922 milliseconds for the Z1. This is based on polling the camera status every 100ms. So, if you poll it more frequently, you will get more accurate results.
The amount of time taken for the picture also varies with light conditions. If the image is darker, it will leave the shutter open longer.
Just emphasizing that making sure the camera is ready for the next API command will make your development work go much smoother. This is a key tip.