Skip to content

Latest commit

 

History

History
240 lines (192 loc) · 16.1 KB

theta-api.md

File metadata and controls

240 lines (192 loc) · 16.1 KB

RICOH THETA API

dev_link_img-beta

Develop Apps for RICOH THETA

Use the API and SDK provided by RICOH to develop your own original RICOH THETA apps.
Join us in sharing the joy of 360° photography with the world.

Explore new ways to enjoy RICOH THETA

Start developing apps for RICOH THETA on iOS and Android platforms.

Protocol Specifications

WebAPI

Model Standards IP Address Port Reference
RICOH THETA (2013) / m15 PTP over TCP-IP (PTP-IP) 192.168.1.1 15740 THETA WebAPI v1.0
RICOH THETA S / RICOH THETA SC OSC Protocol based 192.168.1.1 80 THETA WebAPI v2.0
RICOH THETA S*1 / SC / V / Z1 / X OSC Protocol based 192.168.1.1 80 THETA WebAPI v2.1

*1 Firmware v1.62 and later

USB-MTP API

Model Standards Reference
RICOH THETA S*2 / SC / V / Z1 / X Media Transfer Protocol (MTP) THETA USB API

*2 With firmware v1.42 and later, shooting is now possible even when connected to a PC via USB.

Bluetooth API

Model Standards Reference
RICOH THETA V / Z1 / X Bluetooth Low Energy THETA Bluetooth API

Available Features

RICOH THETA X

Method Capture image Record Video Aquire Files Delete Files Set DateTime Control WLAN Switch Capture Mode Live Preview
On-device UI
Wireless LAN
USB-MTP
Bluetooth

: In certain cases, recording may be disabled depending on the video mode or remaining battery level.

RICOH THETA V, RICOH THETA Z1

Method Capture image Record Video Aquire Files Delete Files Set DateTime Control WLAN Switch Capture Mode Live Preview
On-device UI
Wireless LAN
USB-MTP
Bluetooth

RICOH THETA S firmware v1.42 and later, RICOH THETA SC

Method Capture image Record Video Aquire Files Delete Files Set DateTime Control WLAN Switch Capture Mode Live Preview
On-device UI
Wireless LAN
USB-MTP
Bluetooth

RICOH THETA S firmware v1.41 and earlier

Method Capture image Record Video Aquire Files Delete Files Set DateTime Control WLAN Switch Capture Mode Live Preview
On-device UI
Wireless LAN
USB-MTP
Bluetooth

RICOH THETA m15

Method Capture image Record Video Aquire Files Delete Files Set DateTime Control WLAN Switch Capture Mode Live Preview
On-device UI
Wireless LAN
USB-MTP
Bluetooth

RICOH THETA (2013)

Method Capture image Record Video Aquire Files Delete Files Set DateTime Control WLAN Switch Capture Mode Live Preview
On-device UI
Wireless LAN
USB-MTP
Bluetooth

Projection Type

RICOH THETA generates two types of images.

Equirectangular

https://en.wikipedia.org/wiki/Equirectangular_projection Equi.png

Dual Fisheye

DualFisheye.png

Supported Image Format

Model Projection Type Format Image Size
RICOH360 THETA A1 Equirectangular /
Dual Fisheye		 JPEG11008x5504 / 5504x2752
RICOH THETA X Equirectangular /
Dual Fisheye		 JPEG /
DNG*2		11008x5504 / 5504x2752
RICOH THETA Z1 Equirectangular JPEG 6720x3360
Dual Fisheye JPEG 7296x3648
Dual Fisheye DNG 7296x3648
RICOH THETA V Equirectangular JPEG5376x2688
Dual Fisheye*1 JPEG5792x2896
RICOH THETA S / SC EquirectangularJPEG 5376x2688 / 2048x1024
RICOH THETA (2013) / m15 EquirectangularJPEG 3584x1792

*1 RICOH THETA V firmware v3.00.1 and later
*2 RICOH THETA X firmware v2.61.0 and later

Supported Video Format

Model Projection Type Container Codec Video Size
RICOH360 THETA A1 Equirectangular /
Dual Fisheye		 MP4 H.264/AVC,
H.265/HEVC		 7680x3840 / 5760x2880 / 3840x1920 / 1920x960
RICOH THETA X Equirectangular /
Dual Fisheye		 MP4 H.264/AVC 7680x3840 / 5760x2880 / 3840x1920 / 1920x960
RICOH THETA V / Z1 Equirectangular /
Dual Fisheye		 MP4 H.264/AVC 3840x1920 / 1920x960
RICOH THETA S / SC Dual Fisheye MP4 H.264/AVC 1920x1080 / 1280x720
RICOH THETA m15 Dual Fisheye MOV H.264/AVC 1920x1080
RICOH THETA (2013) Not Supported

Metadata Specifications

Please refer to RICOH THETA Metadata Spec.

Supported Live Preview Format

Model Projection Type Codec Preview Size
RICOH360 THETA A1 Equirectangular / Dual Fisheye Motion JPEG 1024x512
RICOH THETA X Equirectangular / Dual Fisheye Motion JPEG 1024x512 / 1920x960 / 3840x1920
RICOH THETA V / Z1 Equirectangular / Dual Fisheye Motion JPEG 640x320 / 1024x512 / 1920x960 / 3840x1920
RICOH THETA S*1 / SC*1 Equirectangular Motion JPEG 640x320
RICOH THETA m15 Not Supported
RICOH THETA (2013) Not Supported

*1 Supported on only still image mode

Supported Live Streaming Protocol (Video)

Model Projection Type I/F Codec Video Size / Frame Rate
RICOH360 THETA A1 Not Supported
RICOH THETA X Equirectangular UVC1.51 H.264/AVC 3840x1920 30/15fps, 1920x960 30/15fps
RICOH THETA V / Z1 Equirectangular UVC1.51 H.264/AVC 3840x1920 30fps, 1920x960 30fps
RICOH THETA SC2 Not Supported
RICOH THETA SC Not Supported
RICOH THETA S Dual Fisheye HDMI YCbCr 1920x1080 30fps, 1280x720 30fps, 720x480 30fps
UVC1.51 H.264/AVC, Motion JPEG 1920x1080 30fps
UVC1.12 Motion JPEG 1280x720 15fps
RICOH THETA m15 Not Supported
RICOH THETA (2013) Not Supported

Supported Live Streaming Protocol (Audio)

Model I/F Codec
RICOH360 THETA A1 Not Supported
RICOH THETA X UAC2.03 AAC
RICOH THETA V / Z1 UAC2.03 AAC
RICOH THETA SC2 Not Supported
RICOH THETA SC Not Supported
RICOH THETA S UAC1.04 AAC
RICOH THETA m15 Not Supported
RICOH THETA (2013) Not Supported

Footnotes

  1. Universal Serial Bus Device Class Definition for Video Devices Revision 1.5 ↩ ↩2 ↩3

  2. Universal Serial Bus Device Class Definition for Video Devices Revision 1.1 ↩

  3. Universal Serial Bus Device Class Definition for Audio Devices Release 2.0 ↩ ↩2

  4. Universal Serial Bus Device Class Definition for Audio Devices Release 1.0 ↩