API reference - Ricoh Theta

Notify State

	Definitions
Type	object

Description: Notify the Theta state change

Service UUID	b6ac7a7e-8c01-4a52-b188-68d53df53ea2
Characteristic UUID	8881ce4e-96fc-4c6c-8103-5dda0ad138fb
Value format	UTF-8 string (JSON)
Enabled to read	false
Enabled to write	false
Enabled to notify	true

Example:

{
    "_batteryTemp": 28,
    "_boardTemp": 27
}

Property	Type	Required	Description
_batterylnsert	boolean	no	Is a battery inserted or not. Theta X only
batteryLevel	number	no	Battery level from 0.0 to 1.0. When using an external power source, 1.0
_batteryState	enum (of string)	no	Charging state: charging On charge charged Charging completed disconnect Not charging
_batteryTemp	integer	no	Battery temperature
_boardTemp	integer	no	Camera main board temperature
_cameraError	array of enum (of string)	no	Current error information of Theta
_capturedPictures	integer	no	Number of still images captured during continuous shooting
_captureStatus	enum (of string)	no	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)	no	Shooting function status: normal selfTimer Theta Z1 only mySetting
_latestFileUrl	string	no	URL of the last saved file. DNG format files are not displayed. For burst shooting, files in the DNG format are displayed
_recordableTime	integer	no	Remaining time of movie (seconds)
_recordedTime	integer	no	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)

	Restrictions
Minimum	≥ 0

_recordedTime

	Definitions
Type	integer

Description: Shooting time of movie (seconds)

	Restrictions
Minimum	≥ 0

---