API reference - Ricoh Theta

USB API Reference - Ricoh Theta

Ricoh Theta provides USB APIs.

The USB API conforms to Media Transfer Protocol v1.1 (MTP) with Ricoh Theta extensions.

Table of contents

1. Operations
2. Device properties
3. Events
4. Appendix A. Recent firmware change history

1. Operations

• 0x1001 GetDeviceInfo
• 0x1002 OpenSession
• 0x1003 CloseSession
• 0x1004 GetStorageIDs
• 0x1005 GetStorageInfo
• 0x1006 GetNumObjects
• 0x1007 GetObjectHandles
• 0x1008 GetObjectInfo
• 0x1009 GetObject
• 0x100A GetThumb
• 0x100B DeleteObject
• 0x100E InitiateCapture
• 0x1013 PowerDown
• 0x1014 GetDevicePropDesc
• 0x1015 GetDevicePropValue
• 0x1016 SetDevicePropValue
• 0x1017 ResetDevicePropValue
• 0x1018 TerminateOpenCapture
• 0x101B GetPartialObject
• 0x101C InitiateOpenCapture
• 0x99A2 StopSelfTimer
• 0x99A3 GetAccessPointHandles: Theta Z1 only
• 0x99A4 GetAccessPointInfo: Theta Z1 only
• 0x99A5 SetAccessPoint: Theta Z1 only
• 0x99A6 DeleteAccessPoint: Theta Z1 only
• 0x99A7 ConvertVideoFormats: Theta X and Z1 only
• 0x99A8 GetPluginHandles: Theta Z1 only
• 0x99A9 GetPluginInfo: Theta X and Z1 only
• 0x99AA SetPluginInfo: Theta X and Z1 only
• 0x99AB PluginControl: Theta X and Z1 only
• 0x99AD SetAccessPointPassword: Theta Z1 only
• 0x99AE CancelVideoConvert: Theta X and Z1 only
• 0x99AF Reboot
• 0x99B3 GetPluginLicense: Theta X and Z1 only
• 0x99B5 GetWlanMacAddress: Theta X and Z1 only
• 0x99B6 GetBluetoothMacAddress: Theta X and Z1 only.
• 0x99B7 SetPluginOrders: Theta X and Z1 only.
• 0x99B8 GetPluginOrders: Theta X and Z1 only.
• 0x99B9 GetPluginState: Theta X and Z1 only.
• 0x99BF GetAccessPointProxy: Theta Z1 only
• 0x99C0 SetAccessPointProxy: Theta Z1 only
• 0x99C1 SetAccessPointProxyPassword: Theta Z1 only
• 0x99C2 GetEthernetProxy: Theta Z1 only
• 0x99C3 SetEthernetProxy: Theta Z1 only
• 0x99C4 SetEthernetProxyPassword: Theta Z1 only

2. Device properties

Camera and shooting properties which can be acquired by the operation GetDevicePropValue and set by the operation SetDevicePropValue.

Use DevicePropChanged event to inform of change of device properties. However, change of a property set by the operation SetDevicePropValue is not informed.

• 0x5001 BatteryLevel
• 0x5002 FunctionalMode
• 0x5003 ImageSize
• 0x5005 WhiteBalance
• 0x5007 F-Number： Theta Z1 only
• 0x500E ExposureProgramMode
• 0x500F ExposureIndex
• 0x5010 ExposureBiasCompensation
• 0x5011 DateTime
• 0x5012 CaptureDelay
• 0x5013 StillCaptureMode
• 0x501A TimelapseNumber
• 0x501B TimelapseInterval
• 0x502C AudioVolume
• 0xD006 ErrorInfo
• 0xD00F ShutterSpeed
• 0xD407 PerceivedDeviceType
• 0xD801 GpsInfo
• 0xD803 SleepDelay
• 0xD806 Passphrase: Theta X and Z1 only
• 0xD808 CaptureStatus
• 0xD809 RecordingTime
• 0xD80A RemainingRecordingTime
• 0xD80B Filter
• 0xD80C BatteryStatus
• 0xD80D RemainingVideos
• 0xD80E SleepMode
• 0xD80F CompositeShootingTime: Theta Z1 only
• 0xD810 CompositeShootingOutputInterval: Theta Z1 only
• 0xD811 CompositeShootingElapsedTime: Theta Z1 only
• 0xD812 BracketParameters: Theta X and Z1 only
• 0xD813 ColorTemperature
• 0xD814 BluetoothPowerStatus: Theta X and Z1 only
• 0xD815 Username: Theta X and Z1 only
• 0xD816 Password: Theta X and Z1 only
• 0xD818 Video Stitching
• 0xD81A MicrophoneChannel
• 0xD81B AutoPowerOffDelaySec
• 0xD81C Microphone: Theta Z1 only
• 0xD81D NetworkType: Theta X and Z1 only
• 0xD81F Gain
• 0xD820 Language: Theta X and Z1 only
• 0xD821 Wlan Frequency: Theta X and Z1 only
• 0xD822 CapturedPictures
• 0xD823 MaxRecordableTime
• 0xD824 Function
• 0xD825 TopBottomCorrection
• 0xD826 IsoAutoHighLimit
• 0xD827 ImageFormat: Theta X and Z1 only
• 0xD829 Bitrate
• 0xD82C BluetoothRole: Theta Z1 only
• 0xD831 ConvertVideoFormatStatus: Theta X and Z1 only
• 0xD832 GPStagRecording: Theta A1 and X only
• 0xD833 TimeShiftParameters: Theta A1 and X only
• 0xD834 Image Stitching
• 0xD837 CameraMode: Theta X only
• 0xD839 BurstOption: Theta Z1 only
• 0xD83A White Balance Auto Strength: Theta Z1 only
• 0xD83B Water Housing: Theta X only
• 0xD83C Water Housing Stitching: Theta X only
• 0xD83E ExposureStatus: Theta Z1 only
• 0xD840 hdrBracket: Theta X and Z1 only
• 0xD841 ModeMemory: Theta Z1 only

3. Events

• 0x4002 ObjectAdded
• 0x400A StoreFull
• 0x400C StorageInfoChanged
• 0x400D CaptureComplete

Appendix A. Recent firmware change history

These API descriptions target the latest version of Theta firmware. Older versions may not have any options or parameters. Refer firmware change history.