Insta360

The insta360 plugin supports an arbitrary number of insta360 cameras connected by USB. The following features are supported:

• Taking a photo
• Taking video
• Timelapse video
• On-camera file management
• Getting device information (serial number, firmware version, etc)

Supported Platforms

The insta360 plugin is only supported on debian-based machines.

Getting Started

The insta360 plugin is does not come with the agent by default. To install it, ensure you have setup your apt sources and run:

sudo apt install rocos-agent-plugin-insta360

Your agent will need a section in its agent-settings.json file which enables the insta360 component, as shown below. For more information on how to configure the agent plugins, see Agent Configuration.

...
"components": [
	...
	{
    "enabled": true,
    "id": "plugin",
    "settings": {
      "logLevel": 4,
      "name": "insta360",
      "plugin": "/opt/rocos-agent/bin/rocos-agent-plugin-insta360",
      "downloadDirectory": "/var/opt/rocos-agent/data/raw/insta360",
      "disableAutoDelete": false
    }
  },
...
]

The Insta360 plugin understands the following configuration parameters:

Name	Description	Default	Unit
enabled	Whether to enable the plugin or not	false
name	How this instance of the plugin should be named.	-
logLevel	The logging verbosity: 1 - very quiet, 6 - very talkative	4
plugin	Required. The location of the plugin's executable file. If you have installed with apt , the location will be /opt/rocos-agent/bin/rocos-agent-plugin-insta360
downloadDirectory	Required. Where captured files will be saved on the agent's machine. The designated directory must exist; the plugin does not attempt to create a directory which does not exist.
disableAutoDelete	Captures made by the plugin are automatically deleted from the camera, unless this option is set to true	false

Camera Setup

Ensure that your camera's USB Mode is set to Android

To avoid the camera from turning off, set the camera's Auto Power Off to Never

Make sure the camera is On and connected via USB to the machine the agent is running on before starting the agent. If the camera was Off or disconnected, you can call the Scan service to connect to the camera.

---

Troubleshooting

The camera turns off/disconnects after X minutes

1. Please check the camera's Auto Power Off is set to Never
2. If the problem persists, please contact our support team, and include a copy of the plugin's status telemetry.

I cannot connect a second insta360 camera

1. The plugin supports only one camera at a time. Connecting a second camera will not work.