API reference - Ricoh Theta

Get State

	Definitions
Type	object

Description: Acquires the mutable Theta states.

Service UUID	b6ac7a7e-8c01-4a52-b188-68d53df53ea2
Characteristic UUID	083d92b0-21e0-4fb2-9503-7d8b2c2bb1d1
Value format	UTF-8 string (JSON)
Enabled to read	true
Enabled to write	false
Enabled to notify	false

Example:

{
    "_batteryInsert": true,
    "batteryLevel": 0.97,
    "_batteryState": "disconnect",
    "_cameraError": [
        "NO_DATE_SETTING"
    ],
    "_capturedPictures": 0,
    "_captureStatus": "idle",
    "_function": "normal",
    "_latestFileUrl": "",
    "_recordableTime": 3844,
    "_recordedTime": 0,
    "_batteryTemp": 29,
    "_boardTemp": 28
}

Property	Type	Required	Description
_batterylnsert	boolean	no	Is a battery inserted or not. Theta X only.
batteryLevel	number	yes	Battery level from 0.0 to 1.0. When using an external power source, 1.0
_batteryState	enum (of string)	yes	Charging state: charging On charge charged Charging completed disconnect Not charging
_batteryTemp	integer	yes	Battery temperature
_boardTemp	integer	yes	Camera main board temperature
_cameraError	array of enum (of string)	yes	Current error information of Theta
_capturedPictures	integer	yes	Number of still images captured during continuous shooting
_captureStatus	enum (of string)	yes	Continuously shoots state: idle In standby self-timer countdown Self-timer is operating bracket shooting Performing multi bracket shooting converting Converting post file timeShift shooting Performing timeShift shooting continuous shooting Performing continuous shooting. Theta X only retrospective image recording. Waiting for retrospective video. Theta X only
_function	enum (of string)	yes	Shooting function status: normal selfTimer Theta Z1 only mySetting
_latestFileUrl	string	yes	URL of the last saved file. DNG format files are not displayed. For burst shooting, files in the DNG format are displayed
_recordableTime	integer	yes	Remaining time of movie (seconds)
_recordedTime	integer	yes	Shooting time of movie (seconds)

_batterylnsert

	Definitions
Type	boolean

Description: Is a battery inserted or not. Theta X only.

batteryLevel

	Definitions
Type	number

Description: Battery level from 0.0 to 1.0.
When using an external power source, 1.0

	Restrictions
Minimum	≥ 0
Maximum	≤ 1

_batteryState

	Definitions
Type	enum (of string)

Description: Charging state:

charging

On charge

charged

Charging completed

disconnect

Not charging

Must be one of:

• “charging”
• “charged”
• “disconnect”

_batteryTemp

	Definitions
Type	integer

Description: Battery temperature

_boardTemp

	Definitions
Type	integer

Description: Camera main board temperature

_cameraError

	Definitions
Type	array of enum (of string)

Description: Current error information of Theta

	Array restrictions
Min items	0
Max items	N/A

Each item of this array must be	Description
_cameraError items	Error code. See _cameraError descriptions for the meaning.

_cameraError items

	Definitions
Type	enum (of string)

Description: Error code. See _cameraError descriptions for the meaning.

Must be one of:

• “BATTERY_CHARGE_FAIL”
• “BATTERY_HIGH_TEMPERATURE”
• “CANNOT_RECORDING”
• “CANNOT_RECORD_LOWBAT”
• “CAPTURE_HW_FAILED”
• “CAPTURE_SW_FAILED”
• “ELECTRONIC_COMPASS_CALIBRATION”
• “FILE_NUMBER_OVER”
• “HIGH_TEMPERATURE”
• “HIGH_TEMPERATURE_WARNING”
• “INTERNAL_MEM_ACCESS_FAIL”
• “INVALID_FILE”
• “IN_PROGRESS_ERROR”
• “MEDIA_NOT_READY”
• “NOT_ENOUGH_BATTERY”
• “NOT_SUPPORTED_FILE_SYSTEM”
• “NOT_SUPPORTED_MEDIA_TYPE”
• “NO_DATE_SETTING”
• “NO_MEMORY”
• “PLUGIN_BOOT_ERROR”
• “READ_ERROR”
• “UNEXPECTED_ERROR”

_capturedPictures

	Definitions
Type	integer

Description: Number of still images captured during continuous shooting

	Restrictions
Minimum	≥ 0

_captureStatus

	Definitions
Type	enum (of string)

Description: Continuously shoots state:

idle

In standby

self-timer countdown

Self-timer is operating

bracket shooting

Performing multi bracket shooting

converting

Converting post file

timeShift shooting

Performing timeShift shooting

continuous shooting

Performing continuous shooting. Theta X only

retrospective image recording.

Waiting for retrospective video. Theta X only

Must be one of:

• “shooting”
• “idle”
• “self-timer countdown”
• “bracket shooting”
• “converting”
• “timeShift shooting”
• “continuous shooting”
• “retrospective image recording”

_function

	Definitions
Type	enum (of string)

Description: Shooting function status:

normal

selfTimer

Theta Z1 only

mySetting

Must be one of:

• “normal”
• “selfTimer”
• “mySetting”

_latestFileUrl

	Definitions
Type	string

Description: URL of the last saved file.
DNG format files are not displayed. For burst shooting, files in the DNG format are displayed

_recordableTime

	Definitions
Type	integer

Description: Remaining time of movie (seconds)

_recordedTime

	Definitions
Type	integer

Description: Shooting time of movie (seconds)

---