qima / procameraapi

ProCameraApi decribes protocols to control Insta360 Pro, Insta360 Pro2, Insta360 Titan.

Overview

Insta360 Pro Camera API defines a set of commands to control Insat360 Pro series cameras, supported cameras are listed below.

Model	Link
Insta360 Pro	http://insta360.com/product/insta360-pro/
Insta360 Pro2	http://insta360.com/product/insta360-pro2/
Insta360 Titan	http://insta360.com/product/insta360-titan/

The commands are transferred via http request/response, the data is encoded in JSON format.

About Built-in Http Server

Camera supporting Insta360 Pro Camera API has a built-in http server. You could get ip address from the screen of the camera. Here are url routers.

Name	URL Pattern	Function
command	http://{camera_ip}:20000/osc/commands/execute	Execute commands
state	http://{camera_ip}:20000/osc/state	Poll state, also for notification from camera to client
file	http://{camera_ip}:8000/{fileuri}	Access Image/Video file from camera
preview	rtmp://{camera_ip}:1935/live/preview	rtmp stream of preview

Documentations

• State Polling

• Async Command Handling

• Commands

  • camera._connect

  • camera._setOptions

  • camera._getOptions

  • camera._getImageParam

  • camera._startPreview

  • camera._stopPreview

  • camera._takePicture

  • camera._startRecording

  • camera._stopRecording

  • camera._startLive

  • camera._stopLive

  • camera._listFiles

• Capabilities