SC2 WebAPI Differences

Originally published at: SC2 WebAPI Differences – RICOH THETA Developer Community

This is a community document based on contributions of informal test results from the 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.

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.
previewFormat width and height not working. SC2 only has one preview format and one fps.
_shootingMethod for MySetting
_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+


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.

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.

1 Like