Compatibility between SC and SC2 APIs

Sary · December 8, 2020, 7:29pm

Hello. We want to build an integration for the Theta SC2 camera. We might have our hands on the older SC model. Can we use it for development for what would be rolled out later for use with SC2’s? Or the API differs between the two models?

craig · December 8, 2020, 7:36pm

The API is slightly different

github.com

ricohapi/theta-api-specs/blob/main/theta-web-api-v2.1/getting_started.md

# Getting Started

RICOH THETA S and later models send and receive data over HTTP connection, dissimilarly to RICOH THETA and RICOH THETA m15.

This section explains the following flow from shooting a still image through acquiring the stored file.

1. [Specify the API version](#1-specify-the-api-version)
1. [Acquire status before shooting](#2-acquire-status-before-shooting)
1. [Acquire and set properties](#3-acquire-and-set-properties)
1. [Shoot a still image](#4-shoot-a-still-image)
1. [Check for file saving](#5-check-for-file-saving)
1. [Acquire the file](#6-acquire-the-file)

### 1. Specify the API version

For RICOH THETA V or later, start from "2. Acquire status before shooting" since its API version is set to RICOH THETA API v2.1 by default.

For RICOH THETA S and RICOH THETA SC, since the API version is set to RICOH THETA API v2.0 when connection is established via wireless LAN, you need to use [clientVersion](../theta-web-api-v2.0/options/client_version.md) to set the API version of the camera to v2.1.

API v2.0 requires a session to start before running command. Use [camera.startSession](../theta-web-api-v2.0/commands/camera.start_session.md) to start a session and [camera.setOptions](../theta-web-api-v2.0/commands/camera.set_options.md) to set the camera and shooting properties.

This file has been truncated. show original

For the SC, you will need to specify the sessionId.

You can check the API version of the camera with state.

Your mobile app will need to first read in the state and then adjust the commands if it is _apiVersion 2 (SC2) or _apiVersion 1 (SC).

The SC does not have an OLED screen or presets.

The basic commands such as take picture are the same.

SC: theta-api-specs/README.md at main · ricohapi/theta-api-specs · GitHub
SC2: theta-api-specs/README.md at main · ricohapi/theta-api-specs · GitHub

the method to get the image from the camera to your mobile app is different, but it is straightforward.
SC: theta-api-specs/README.md at main · ricohapi/theta-api-specs · GitHub
SC2: it is a GET command to the fileUri, which you can get from listFiles or state (for the last image)

Additional information.

Protocol specification for models:

Sary · December 8, 2020, 9:45pm

Clear. Thank you very much for the support.