Originally published at: SC2 WebAPI Differences – RICOH THETA Developer Community
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. As these are unofficial tips, the official RICOH THETA API may change unexpectedly and these techniques could stop working.
Limited Functionality on SC2 and SC2B
| 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 by SC2 and SC2B
| 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 |
Unique SC2 APIs
| API | Explanation |
| cameraMode presets | SC2 has unique presets for face mode, night view mode, lens-by-lens exposure. SC2B also has room mode |
Z1 Surprising Behavior
| API | Explanation |
| camera.reset | offDelay is set to 64800 (18 hours) on reset. For the SC2, the offDelay is reset to 600 (10 minutes). |
Other Interesting API Findings
Interval shooting
- SC2, minimum value is 8
- V, minimum value is 4
- Z1, minimum value is 6 for JPEG
- 10 for RAW+
mySetting
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.
- Both Z1 and SC2 mySetting settings survive reboot and sleep
- There is no My Settings icon on the SC2 (in fact, no OLED at all). Therefore, there is no way for the end user to change the settings without the mobile app.
- If you run camera.reset, the Z1 will give an error for the getMySetting command. This is expected behavior, since mySetting has no settings. However, using camera.reset with an SC2 will not reset the settings.
Time For Camera to Be Ready
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.