How to Develop

Preparation of development environment and debugging

Step 1: Get RICOH THETA V

  • Update the firmware to the latest version to develop the plug-in.

Step 2: Enable developer mode (adb)

  • Register from here to enable developer mode

Step 3: Install Android™ Studio

Step 4: Connect RICOH THETA V with USB

Step 5: Enter adb devices from terminal and ready when the device name appears

Step 6: Download RICOH THETA Plug-in SDK

Step 7: Develop THETA plug-in, which is the Android™ application, based on SDK

Step 8: Debugging with the Run button etc. With this step, the THETA plug-in is executed by installing the APK.

Names of Camera Parts

v_name01.png

  1. Microphone

  2. Lens

  3. Camera Status Light (LED2)

  4. Shutter Button

  5. Speaker

  6. Wireless Light (LED3)

  7. Capture Mode Light (LED4, LED5, LED6)

  8. Video Recording Light (LED7)

  9. Memory Warning Light (LED8)

  10. Power Light (LED1)

  11. Power Button

  12. Wireless Button

  13. Mode Button

  14. Microphone Jack

  15. USB Port

  16. Tripod Mount Hole

Controlling the Camera

Plug-ins can take pictures using the Web API or the Camera API, but development using the Web API is recommended. When using the Camera API with a plug-in, the Web API can not be used.

Device Control

You can receive notifications of button operation, and you can control the LEDs, the speaker, the wireless LAN, and files on the device. For details see Broadcast Intent.

Open Source Licenses

By placing the open source license information used by the plug-in in the plug-in (APK file) \assets\licenses.html, you can acquire the license information using the Web API camera._getPluginLicense command. In case of no open source softwares in the plug-in, please use the following code:

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
    <style type="text/css">
      body { padding: 0; font-family: sans-serif; }
    </style>
  </head>
  <body topmargin="0" leftmargin="0" rightmargin="0" bottommargin="0">
    <div>
      <p>This plug-in does not use open source software.</p>
    </div>
  </body>
</html>

Version Information

The version of the plugin is designed using a number and a decimal point, with the major version using 2 digits or less, the minor version using 2 digits or less, and the build number using 4 digits or less. For example: “12.34.5678”

Declaring Supported API Versions

You must declare the version of each API for the plug-in’s target model and the corresponding Web / MTP / BLE / Plug-in API. Plug-ins will not be installed if it is not the correct target model or if the version of the camera is lower than the declared version. To declare, use the following syntax in the plug-in manifest (AndroidManifest.xml).

<uses-feature android:name="com.theta360.receptor.v" android:required=["true" | "false"]/>
<uses-feature android:name="com.theta360.receptor."+["webapi" | "mtpapi" | "bleapi" | "pluginapi"] android:version="integer"/>

Warnings When Developing Plug-ins

  • To install the developed plug-in on RICOH THETA V you need to enable ADB. Please register as a developer with RICOH and enable ADB according to the documentation. (Please be patient as we are planning to release the developer registration mechanism and effective ADB usage techniques in the near future.)
  • Please limit the size of the plug-in to 256MB
  • Plug-in and package names cannot exceed 64 characters and an extension must use apk
  • Version number must follow the versioning information
  • Use of open source licenses must be explicitly stated
  • You cannot start a service
  • When you press and hold the mode button for 2 seconds or more, the plug-in must terminate
  • When the plug-in is terminated, the plug-in must give a notification of termination for the plug-in