Categories
WebAPI

SC2 WebAPI Differences

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 Functionality of SC2 WebAPI on SC2 and SC2B

Limited APIExplanation
commands/statusOnly 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.startCaptureSC2 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.stopCapturewhen 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.listFilesSC2 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.deletePrior 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._getMetadatadoes not return correct information. Workaround is to download the file to your mobile device and then extract the metadata locally after download.
camera._getMySettingMay 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 SC2 WebAPI by SC2 and SC2B

Unsupported APIExplanation
GET /pluginSC2 does not support plug-ins
camera._convertVideoFormatsSC2 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._cancelVideoConvertSC2 cannot perform video conversions
camera._listAccessPointsSC2 does not support client mode connections and thus cannot connect to external Wi-Fi access points
camera._setAccessPointSet access point in client mode. SC2 only supports access point mode.
camera._deleteAccessPointSC2 does not support client mode Wi-Fi and thus cannot save external Wi-Fi access point information inside the camera.
camera._listPluginsSC2 does not support plug-ins
camera._setPluginsSC2 does not support plug-ins
camera._pluginControlSC2 does not support plug-ins
camera._getPluginLicenseSC2 does not support plug-ins
camera._getPluginOrdersSC2 does not support plug-ins
camera._setPluginOrdersSC2 does not support plug-ins
camera._deleteMySettingdoes 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.
apertureOnly Z1 has an adjustable aperture
_authenticationSC2 does not support client mode and thus cannot disable digest authentication for client mode.
_bluetoothPowerDoes not appear to work on the SC2, but you can turn on bluetooth manually with the button on the side of the camera.
_compositeShootingOutputIntervalOnly Z1 support interval composite shooting
_compositeShootingTimeOnly Z1 support interval composite shooting
_HDMIresoNo HDMI output on Z1.
_imageStitchingSC2 cannot control image stitching
_languagenot supported on SC2. even on the Z1, it’s not clear what impact this setting has.
_microphone
_microphoneChannel
_networkType
_password
previewFormatwidth and height not working. SC2 only has one preview format and one fps.
_shootingMethodfor MySetting
_topBottomCorrection
videoStitching
_visibilityReductionreduce size of tripod at bottom of image
_usernamename for client mode digest authentication. SC2 does not support client mode Wi-Fi connections
_wlanFrequencySC2 only supported 2.4GHz. Z1 supports 2.4GHz and 5GHz

Unique SC2 WebAPI

APIExplanation
cameraMode presetsSC2 has unique presets for face mode, night view mode, lens-by-lens exposure. SC2B also has room mode

Z1 Surprising Behavior

APIExplanation
camera.resetoffDelay 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.

Just in case…

Notable Replies

  1. 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.

Continue the discussion at community.theta360.guide

Participants