THETA X - SDK - Camera API Examples and Documentation Status

I started to modify the plugin I’m working on to work on Theta X. I’m facing serious issues with starting camera preview as I used to. Seems I’m missing something or SDK is not fully ready yet for Theta X.

I was able to start camera and to get the live preview the same was as doing at Z1:

parms.set(“RIC_SHOOTING_MODE”, “RicPreview3840”);
parms.set(“RIC_PROC_STITCHING”, “RicStaticStitching”);


  1. Stitching doesn’t work even if I set to enable, I tried all valid values from documentation
  2. Like I get only one of the lenses preview, when I try to set preview size parms.setPreviewSize(3840, 1920); plugin fails, when I try to check supported preview sizes I get supported size: 1920 x 1920, 1920 x 1440, 1920 x 1080 , no higher resolutions
  3. Exposure compensation is bad in some cases image is overexposure a lot, seems randomly changes after starting and stopping multiple times the plugin.

Regarding what I’ve seen from this camera I like it very much… it’s speed during live preview is fascinating, but I will rather not share until I’m really able to make this running.

@craig , @jcasman , would you be kind and try to ask Ricoh’s help on these?

Thanks in advance!

Can you compare it to the RICOH plug-in and see if the RICOH plug-in has the same problem?

I tested this plugin on Theta X and it worked fine, issues I was facing with wasn’t there, so there must be something adjusted in that plugin by them that is not exposed…

The code of that plugin is not updated to support Theta X. I downloaded latest SDK and I’m using latest 3.0.1 plugin library of course. I also tried to decompile the library, but I couldn’t find yet why stitching doesn’t work for me. Very strange.

Where are you with your work on Theta X, may I ask what are you focusing on, any plugin code tests in progress by you?


1 Like

can you post the entire code that you are getting the error on along with the error. For example, put the entire app for the test with the SDK on GitHub. Include the

parms.set(“RIC_SHOOTING_MODE”, “RicPreview3840”);
parms.set(“RIC_PROC_STITCHING”, “RicStaticStitching”);

and then post the error.

Is there anything in the debug console? Or, does the stream just come out as dual-fisheye?

Stream does come out as dual fisheye, but not only that, like there is only 1 lens coming through for some reason. not sure if some specific change is required, but this code works fine for Z1 as is. After testing a lot I realized that when I set preview size it will instantly exit with error:
E/AndroidRuntime: FATAL EXCEPTION: RenderThread
Process: tours.flow.hdrstreaming, PID: 7215
java.lang.RuntimeException: setParameters failed
at android.hardware.Camera.native_setParameters(Native Method)
at android.hardware.Camera.setParameters(
at tours.flow.hdrstreaming.e.j.n(:253)
at tours.flow.hdrstreaming.e.j.e(:51)
at tours.flow.hdrstreaming.e.m$
at android.os.Handler.handleCallback(
at android.os.Handler.dispatchMessage(
at android.os.Looper.loop(
at tours.flow.hdrstreaming.e.m.m(:97)
at tours.flow.hdrstreaming.e.m.n(Unknown Source:0)
at Source:2)

So I pulled supported preview sizes and 3840x1920 wasn’t there at all. I was playing with my HDR wireless live streamign plugin to see how easily to modify to support X, I would rather not expose the whole code.


1 Like

This information is all we need at the moment. Thank you for reporting this. I’ve included your problem into the agenda we have with a manager at RICOH.

I’ll also test the CameraAPI myself in the future.


hi, @craig,
I tested again, updated firmware of camera and used SDK 3.0.2. I would really need some help on this from Ricoh. can’t set preview size. On original class would be useful if someone would modify it’s code to make a working preview of camera on Theta X. Thanks!

I’ve added this to the Thursday (tomorrow) agenda with a RICOH manager. I’m also linking to this discussion so a wider group of people at RICOH can understand that the question is coming from a serious developer (you) in the community.

Thanks, @craig ,
I spent some time looking into pluginlibrary too and noticed also there are classes like import android.hardware.Camera; used by me currently and in official Ricohs live streaming plugin the same class is used to open and set parameters of the camera. However I pluginlibrary/sdk there are also camera classes like theta360.hardware.Camera; or com.theta360.pluginlibrary.factory.Camera; is it possible that some special setup is needed to make it work? I found out by debugging that need to call method notificationCameraClose(); otherwise camera will not be able to connect to… Also I do not think this is documented anywhere at the moment. :frowning: Lot of these “small” findings are making impossible to proceed with Theta X…

I added the additional information you provided to the written report.

It’s possible that some special setup is needed. Though, I don’t know for sure. Just to let you know that you’re not alone, I have the same problems you are describing. I can make the plug-ins, but am having difficulty accessing all the camera resources. It seems like I need another class or package or some additional example of how to access the resources.

To be honest, I have been thinking that the problem was with my low programming skill, so I didn’t want to bring it up too aggressively.

However, if I guy with your experience is having problems, I think we need some additional information and possibly a tip to import another library class.

I think we both miss some information from Ricoh on this. Clearly it shouldn’t be required to build different apps, same Ricohs Wireless live streaming plugin works on both z1 and X, so it should work for us too, there are just some small code pieces missing, like that notificationcameraclose method I found earlier.

1 Like

@craig ,
also there is a github project by ricoh, created 1.5 month ago: ricohapi/theta-plugin-camera-api-sample-x · GitHub , wondering if it may help us with camera api? Why is it empty for so long? Could you please ask them to provide some information?


1 Like

@biviel we’re sending this thread to RICOH. Can if you have any more information that you’re having with SDK version 3.0.2 GitHub - ricohapi/theta-plugin-sdk: RICOH THETA Plug-in SDK and library version 3.0.2 GitHub - ricohapi/theta-plugin-library


I received this advice:

Tips for using Camera API for X are following.

  1. import Plug-in Library (v3.0.0 or later).
  2. import com.theta360.hardware.Camera, etc. not, for X. Because THETA X provides 360 camera related features via com.theta360 packages. This is very different point from THETA V/Z1.
  3. implement Camera API code, with referring to the upcoming sample code. Many APIs are designed to have same name and same interface as native APIs.

I know the web API for the Theta X only went live at the end of February, but is there a timeline for when we can expect the Camera API (theta360.hardware.Camera.*) to be ready for use and documented? I have a pretty heavily-used internal plugin that we developed for the Z1 that I’d like to update for the X, but with the forked android.Camera → theta360.hardware.Camera API and the other hardware changes I’ve not yet been able to get it to run on the X.

We relied pretty heavily on the sample camera project (GitHub - ricohapi/theta-plugin-camera-api-sample: THETA Sample Plug-in: CameraAPI Capture Plugin) when developing the plugin, and I see that there is an empty equivalent sample for the X (ricohapi/theta-plugin-camera-api-sample-x · GitHub). Is there a timeline for when that sample project using the (new) Camera API to build plugins for the Theta X will be available? I’ve got a couple dozen fresh new Xs that are useless to me until we can get this plugin updated!

(Alternatively, has anyone here got a working plugin using the Camera API on the Theta X that they’d be willing to let me have a peek at? Get in touch if so!)

@tfountain , I merged the topic with the original one from Laszlo (@biviel ) . I will try and get more information on the status of theta-plugin-camera-api-sample-x

I am in communication with the head developer and definitely know the team is working on this.

hi, @craig , @jcasman ,

there is now a sample for camera api, posted by Ricoh: GitHub - ricohapi/theta-plugin-camera-api-sample-x: THETA X Plug-in : Camera API Sample

I will start looking into it ASAP.


1 Like

We have the THETA X Sample Plug-in working in our office.


@craig, @jcasman ,
I forgot to highlight and say thank you, both of you, for asking(forcing) Ricoh to provide this example ASAP! :slight_smile: Thank you!


thanks. Note that the developer at RICOH is super cooperative and wanted to share it. He was working at 2am on vacation. All Jesse and I did was to point out your post in the forum and also the post from Trevor. It’s really your voice as a voice of a experienced developer that is moving things along. If the people at RICOH can see that there’s a real need from real developers like you, it helps to set priorities. Your tests and listing of requirements were very useful as you were willing to post in the forum and it is easy for us to share a link to the forum.


Please forward my THANKS to that Ricoh developer if you are in direct connection with him!

1 Like