Q1 What is the difference between using the SDK and OSC for integration?

Q1 What is the difference between using the SDK and OSC for integration?

The overall stability and transmission speed of the SDK will be better and faster; while OSC has stronger compatibility, but OSC does not have the functions of the Media SDK and some functions of the Camera SDK (such as preview, LIVE, camera activation, and firmware upgrade, etc.).

Q2 What are the connection methods between the camera and the device?

Through the SDK, desktop devices can only connect via USB and cannot use Wi-Fi or Bluetooth; Android supports USB, Wi-Fi, and Bluetooth connections; iOS supports Wi-Fi and Bluetooth connections. OSC supports Wi-Fi but does not support Bluetooth connections.

Q3 Which mode should be selected when taking a photo?

The X5 and X4 support in-camera PureShot processing, while the X3 does not. The SDK does not support PureShot output. When using the X3 for taking photo, the INSP mode should be selected. When using the X4, the PureShot mode can be enabled. The X5 no longer supports INSP mode, so please select PureShot mode for capturing photos.

Q4 Can I freely set parameters such as resolution, frame rate, and interval time?

The SDK only supports preset resolutions, frame rates, and interval times available on the camera screen. Custom configurations are not supported.

Q5 Why does recording video with other camera models result in two fisheye lens video streams, while the X4 has only one?

For creatives of X5, X4, and X4 Air, if the resolution is greater than or equal to 5.7K, X5, X4, and X4 Air save information for two video tracks in the same main code stream (insv) file. Therefore, high-resolution video files also have only one insv main code stream, and FFmpeg can be used to separate the video tracks.

Q6 What is the shortest interval time for different resolutions in Timelapse mode?

In the X5 and X4's Timelapse mode, the minimum interval duration is 0.5 seconds for 5.7K resolution and 2 seconds for 8K and 11K resolutions. For the X3, the minimum interval is 0.2 seconds for both 8K and 5.7K resolutions.

Q7 Can images or videos be retrieved in real-time?

The SDK allows you to access real-time footage, whereas OSC cannot provide real-time camera feed.

Q8 What is the maximum video recording duration?

When the normal recording time of X5, X4, X4Air, and X3 exceeds 30 minutes (specifically 29 minutes and 59 seconds), the camera will perform segmented recording and storage. After segmentation, it will automatically continue shooting, and every 29 minutes and 59 seconds, the system will automatically store the next segment of video creatives again, without the need for user operation. In time-lapse photography mode, a new creative video is generated every 90 minutes.

Q9 Can the preview stream resolution be set?

The X5 and X4 preview stream resolution is fixed and cannot be adjusted. Other models require preview resolution settings before streaming.

Q10 How to view the video preview stream after obtaining it?

After obtaining the H.264 preview stream, you can decode it using FFmpeg. The decoded data will be in YUV420 format, which can then be used for preview.

Q11 Can operations be performed in single-lens mode using the SDK?

The SDK is primarily intended for panoramic shooting and is not recommended for single-lens mode use.

Q12 Can I implement panoramic live streaming on my platform using the SDK?

The Android and iOS SDKs support panoramic live streaming.

Q13 Can the SDK call the Webcam mode?

The SDK does not support controlling the Webcam mode.

Q14 Does the SDK support transmitting live view to a computer via USB?

Preview streaming is supported, but video recording must be saved to the camera's memory card.

Q15 How to set the video encoding format?

The video encoding format must be set on the camera screen. Go to "Settings" > "Image Settings" > "Video Encoding," and select either H.265 or H.264. The SDK does not support setting the video encoding format.

Q16 How to set the bit rate?

The bit rate can only be set via the camera screen and is not supported for setting via the SDK.

Q17 Which models support in-camera stitching?

X5/X4/X4 Air supports in-camera stitching for photos but not for videos; OSC supports in-camera stitching for X3 and X2 photos, but the stitching time is longer, and it does not support in-camera stitching for videos.

Q18 Can insp or dng files be exported as jpg files?

The SDK allows exporting INSP files to JPG but does not support DNG to JPG conversion. DNG files are intended for professional post-processing, which the SDK does not facilitate.

Q19 Can insv files be exported as MP4 files?

Yes, to convert an insv file to MP4, you can simply change the file extension. This will give you the unstitched dual-fisheye video stream.

Q20 Can the preview stream be played in single-lens mode?

The SDK retrieves single-lens preview streams correctly, but the Android SDK demo player currently supports panoramic playback only.

Q21 Does the SDK provide a panoramic player?

The Android and iOS SDKs provide a built-in panoramic player. The desktop SDK only supports retrieving panoramic video streams and does not include player functionality. Users need to install a panoramic player through public channels and adopt the desired rendering methods for flat outputs, such as panoramic equirectangular projections (refer to Insta360 Studio).

Q22 How to set X5, X4, and X4 Air to Android mode?

Android mode is included in the USB connection mode, and the Android mode of X5/X4/X4 Air will not be displayed in the camera settings menu. When the camera is connected to a computer via USB, the mode menu (including Android phone control, file transfer, USB camera, and reverse charging) will automatically pop up. Please ensure that the firmware of X5/X4/X4 Air has been updated to the latest version provided by the official website.

Q23 Why can't I switch to Android mode?

To ensure the switch to Android mode, it is necessary to ensure a stable voltage of 5V3A at the USB port. If the voltage is unstable, it will be recognized as a disconnection, resulting in a failed switch. To troubleshoot this issue, a powered USB hub can be used for comparative verification.

Q24 Does the camera have a default USB connection mode when powered on?

No default mode is set initially. The first selected mode becomes the default, and subsequent power-ups will automatically activate this mode. For example, setting Android mode initially will make it the default.

Q25 Can location information be obtained?

Mobile devices support adding GPS information to video files. The SDK only acquires three-axis data of acceleration and angular velocity provided by the gyroscope, and the acquired data is relative position information.

Q26 How to synchronize the camera time via the SDK?

Android and iOS SDKs automatically synchronize time upon successful Wi-Fi or USB connections. Bluetooth connections do not synchronize time.

Q27 Which camera models support in-camera HDR fusion?

X5, X4, and X4 Air support in-camera HDR fusion.

Q28 Does the SDK support PureVideo mode?

Yes, it does. PureVideo is a new night mode introduced in the X5 and can be used via the SDK's specific frames export feature with 8K 30fps, ideal for low-light environments.

Q29 How to reduce noise and motion blur?

Higher ISO values increase noise, while lower ISO values reduce it. Faster shutter speeds reduce motion blur, whereas slower shutter speeds increase it. For stationary cameras and scenes, ISO can be lowered, and shutter speed slowed without concern for motion blur. For moving cameras, a balance between noise and motion blur is required.

Q30 Does the Insta360 panoramic camera support OSC protocol?

Insta360 panoramic cameras support OSC protocol for camera control. For photos, in-camera stitching must be enabled. Videos require Media SDK for external stitching, as in-camera stitching is unsupported.

Q31 Why does the camera still shoot in Timelapse mode when the OSC is set to regular video mode?

OSC settings must match the camera's screen configuration.

Q32 Can OSC set exposure parameters?

The OSC protocol does not support exposure parameter adjustments.