Theta API on Ricoh Theta X camera.listFiles unexpected behavior

THETA API Usage
1

Hello,

I have been using the Theta API on the new camera Ricoh Theta X with the latest firmware version 1.20.0. All has been working as expected with Ricoh Theta Z1. However there could a be a bug or out-of-date documentation on Ricoh Theta X.

From the documentation it’s stated that the parameter _detail by default is true, but I found out by default is false.

Name Type Description
entryCount Integer Number of still image and movie files to acquire.
If the number of existing files is smaller than the specified number of files, all available files are only acquired.
Note that a thumbnail can be acquired for a single file only.
_detail Boolean (Optional)
Specifies whether or not to acquire the file details.
Default is “true”.
If set to “false”, “name”, “fileUrl”, “size”, “dateTime”, “isProcessed”, “previewUrl”, and “_favorite” can only be acquired.

Then the parameter entryCount doesn’t return the expected response:

In this case, I have captured a lot of photos and videos, so the number of existing files is larger than 1. However, the API returns an error if I only pass 1 as a parameter to entryCount and it returns all the files if I pass a number larger than 1.

2

Please advise if the problem you are encountering is the same as the problem explained in the video below and the workaround of using startPosition

The workaround is to add in startPosition (the first start position should be 0)

If this is the same problem, I’ll try and do more tests.

1 Like
3

That’s right, it’s the same problem. I will use the startPosition then.

Then, would the API specification be changed for Theta X, and remains the same for Z1, SC2, and earlier?

4

I’ll report your findings to RICOH. @jcasman and I have a meeting with a manager form RICOH on Thursday.

In parallel, I’ll try and do more tests with the THETA X to help illustrate the problem.

firmware 1.20.0 on THETA X

image

listFiles with entryCount 2

{
	"name": "camera.listFiles",
	"parameters": {
		"fileType": "image",
		"entryCount": 2,
		"maxThumbSize": 0
	}
}

Result

Unexpected behavior. Showing all files

image
image718×789 78.6 KB

listFiles with _detail to true

{
	"name": "camera.listFiles",
	"parameters": {
		"fileType": "image",
		"entryCount": 2,
		"maxThumbSize": 0,
		"_detail": true
	}
}

Unexpected behavior. Showing all files.

{
	"results": {
		"entries": [
			{
				"dateTimeZone": "2022:08:10 19:28:44-07:00",
				"_favorite": false,
				"fileUrl": "http://192.168.1.1/files/100RICOH/R0011225.JPG",
				"height": 2752,
				"_imageDescription": "",
				"isProcessed": true,
				"name": "R0011225.JPG",
				"previewUrl": "",
				"_projectionType": "Equirectangular",
				"size": 4412165,
				"_thumbSize": 12542,
				"width": 5504
			},
			{
				"dateTimeZone": "2022:08:10 19:18:34-07:00",
				"_favorite": false,
				"fileUrl": "http://192.168.1.1/files/100RICOH/R0011224.JPG",
				"height": 2752,
				"_imageDescription": "",
				"isProcessed": true,
				"name": "R0011224.JPG",
				"previewUrl": "",
				"_projectionType": "Equirectangular",
				"size": 4445500,
				"_thumbSize": 14901,
				"width": 5504
			},
			{
				"dateTimeZone": "2022:08:10 19:18:22-07:00",
				"_favorite": false,
				"fileUrl": "http://192.168.1.1/files/100RICOH/R0011223.JPG",
				"height": 2752,
				"_imageDescription": "",
				"isProcessed": true,
				"name": "R0011223.JPG",
				"previewUrl": "",
				"_projectionType": "Equirectangular",
				"size": 4260326,
				"_thumbSize": 15255,
				"width": 5504
			},
			{
				"dateTimeZone": "2022:08:10 19:17:41-07:00",
				"_favorite": false,
				"fileUrl": "http://192.168.1

using startPosition 0

{
	"name": "camera.listFiles",
	"parameters": {
		"fileType": "image",
		"entryCount": 2,
		"startPosition": 0,
		"maxThumbSize": 0,
		"_detail": true
	}
}

result

works with expected behavior

{
	"results": {
		"entries": [
			{
				"dateTimeZone": "2022:08:10 19:28:44-07:00",
				"_favorite": false,
				"fileUrl": "http://192.168.1.1/files/100RICOH/R0011225.JPG",
				"height": 2752,
				"_imageDescription": "",
				"isProcessed": true,
				"name": "R0011225.JPG",
				"previewUrl": "",
				"_projectionType": "Equirectangular",
				"size": 4412165,
				"_thumbSize": 12542,
				"width": 5504
			},
			{
				"dateTimeZone": "2022:08:10 19:18:34-07:00",
				"_favorite": false,
				"fileUrl": "http://192.168.1.1/files/100RICOH/R0011224.JPG",
				"height": 2752,
				"_imageDescription": "",
				"isProcessed": true,
				"name": "R0011224.JPG",
				"previewUrl": "",
				"_projectionType": "Equirectangular",
				"size": 4445500,
				"_thumbSize": 14901,
				"width": 5504
			}
		],
		"totalEntries": 355
	},
	"name": "camera.listFiles",
	"state": "done"
}
1 Like
5

THETA X firmware 1.40.0 appears to resolve this issue.

image
image1198×719 120 KB

More information in this video from 4:53