07. RICOH THETA API Video Start Capture Progress Status

Overview

The RICOH THETA will take 3-5 seconds after ending video recording to be ready to execute the next command. If a command is sent during this time, then the next command may fail.

This tutorial focuses on taking recording a video and then using commands/status to see if the "stopCapture" process is "done."

A timer shows the time it takes for the command to finish.

Main Resources

• RICOH THETA API - webAPI v2.1
• theta360.guide developers community
• Code for this tutorial

Concepts

The process id is parsed out from the commands/execute when the user starts the video. The id is passed into the state of the application and as a parameter for the commands/status. The commands/status outputs the state of the video command: inProgress or done.

inProgress

The state of the process is inProgress while the camera is capturing the video. After the stopCapture command is run, the camera stitches the video together. The process is still inProgress even after stopping the video. The process is done once the video has finished stitching. While a video may be three seconds in duration, the process may take five seconds to complete.

API Features

• commands/status
• camera.startCapture
• camera.stopCapture
• captureMode

Steps

• Start capture with commands/execute.
• Parse out the id from the response

    var convertResponse = jsonDecode(response.bodyString);
    var id = convertResponse['id'];

• Pass the process id into the state of the application and also into commands/status. With the specific id, the commands/status should emit the state of the video process.
• The commands/status is added in a while loop to the commands/execute until the state of the video process is done. A delay between calls prevents the application from crashing.

1. After the camera is finished processing, display the state to the screen.

Text('State: ${state.cameraStatus}')

Response Window

The stopCapture command outputs the file url of the last video. This file url is passesd into the state of the application and displayed as an image.

  state.fileUrl.isNotEmpty && state.cameraStatus == 'done'
    ? SizedBox(
        width: 300,
        child: Image.network(
            '${state.fileUrl}?type=thumb',))