Video point annotation

Data format examples

CSV and XLSX formats

For a sample file, see video_data_demo.csv.

Manifest format (JSONL format)

{"data":{"video_url":"oss://****.oss-cn-hangzhou.aliyuncs.com/iTAG/mov/1.mp4"}}
{"data":{"video_url":"oss://****.oss-cn-hangzhou.aliyuncs.com/iTAG/mov/10.mp4"}}

For a sample file, see video_data_demo.manifest.

Limits

The template supports the following video formats: MP4, WebM, and OGG.

Video length: 5 minutes or less is recommended.

Configuration

Video frame bounding box (Video mapping data required)

• The Video URL mapping data component configures the video field.

  Click Video URL mapping data, choose a dataset, and then configure the parameters in the Configuration area on the right. The following table describes the parameters:

  Parameter	Description
  Title	Do not modify the default title.
  Dataset field	From the dataset fields, select the video URL field. You can use a custom field name.
  Prompt	Do not modify the default prompt.
  Card style configuration	No configuration is required. This parameter has no effect.

• Use the frame bounding box question area to configure the questions that appear in a pop-up window after you draw a bounding box.

  Click a question to configure its parameters in the Configuration area on the right. The following table describes the parameters:

  Parameter	Description
  Title	Configure the question title as needed.
  Placeholder text Note This parameter is required when the question type is Single-line input box.	The placeholder text for a fill-in-the-blank question. This text provides guidance for user input.
  Options Note This parameter is required when the question type is Single choice, Multiple choice, or Tree select.	When the question type is Single choice or Multiple choice, you can configure options using Manual Entry or Import from Dataset. The Dictionary Search feature is not currently available. If the question type is Tree select, you can only configure options using manual entry.
  Prompt	Configure the tooltip text that appears when you hover over the question title.
  Is required	Specify whether the question is required. If a question is required, a validation check is performed when the user provides an answer.
  Support option search Note This parameter is required when the question type is Single choice or Multiple choice.	Allows users to search for options.
  Effective stage	The stage where the question is active. If you do not select a stage, the question is active throughout the end-to-end process by default.

Video frame marking (Video mapping data required)

• The Video URL mapping data component configures the video field. The field must be consistent with the other two components.

  Click Video URL mapping data, choose a dataset, and then configure the parameters in the Configuration area on the right. The following table describes the parameters:

  Parameter	Description
  Title	Do not modify the default title.
  Dataset field	From the dataset fields, select the video URL field.
  Prompt	Do not modify the default prompt.
  Card style configuration	No configuration is required. This parameter has no effect.

• Use the Frame marking question area to configure questions that users answer after marking a frame.

  Click a question to configure its parameters in the Configuration area on the right. The following table describes the parameters:

  Parameter	Description
  Title	Configure the question title as needed.
  Placeholder text Note This parameter is required when the question type is Single-line input box.	The placeholder text for a fill-in-the-blank question. This text provides guidance for user input.
  Options Note This parameter is required when the question type is Single choice, Multiple choice, or Tree select.	When the question type is Single choice or Multiple choice, you can configure options using Manual Entry or Import from Dataset. The Dictionary Search feature is not currently available. If the question type is Tree select, you can only configure options using manual entry.
  Prompt	Configure the tooltip text that appears when you hover over the question title.
  Is required	Specify whether the question is required. If a question is required, a validation check is performed when the user provides an answer.
  Support option search Note This parameter is required when the question type is Single choice or Multiple choice.	Allows users to search for options.
  Effective stage	The stage where the question is active. If you do not select a stage, the question is active throughout the end-to-end process by default.

Global questions (Mapping data required)

• The Mapping data component configures the video field. The field must be consistent with the other two components.

  Click Mapping data, choose a dataset, and then configure the parameters in the Configuration area on the right. The following table describes the parameters:

  Parameter	Description
  Title	Do not modify the default title.
  Dataset field	From the dataset fields, select the video URL field.
  Prompt	Do not modify the default prompt.
  Card style configuration	No configuration is required. This parameter has no effect.

• Use the Global question area to configure questions that apply to the entire video.

  Click the Answer area to configure its parameters in the Configuration area on the right. The following table describes the parameters:

  Parameter	Description
  Title	Configure the question title as needed.
  Placeholder text Note This parameter is required when the question type is Single-line input box or Input box - Markdown preview.	The placeholder text for a fill-in-the-blank question. This text provides guidance for user input.
  Options Note This parameter is required when the question type is Single choice, Multiple choice, Tree select, or Multi-select tree.	When the question type is Single choice or Multiple choice, you can configure options using Manual Entry or Import from Dataset. The Dictionary Search feature is not currently available. If the question type is Tree select or Multi-select tree, you can only configure options using manual entry.
  Prompt	Configure the tooltip text that appears when you hover over the question title.
  Is required	Specify whether the question is required. If a question is required, a validation check is performed when the user provides an answer.
  Support option search Note This parameter is required when the question type is Single choice or Multiple choice.	Allows users to search for options.
  Effective stage	The stage where the question is active. If you do not select a stage, the question is active throughout the end-to-end process by default.

Global configuration

Use Global configuration to configure user-defined functions (UDFs) for the template. For example, you can configure a UDF to retrieve the video frames per second (fps).

All three components are configured in the same way. Click the icon to configure them. The parameters are described as follows:

Demo

Video frame bounding box

Draw a bounding box around a target area in the video. A pop-up window appears. After you answer the questions, the results appear in the video, the answer area on the right, and the timeline at the bottom. To edit or delete an answer, hover over the question in the answer area or click the box in the video.

Video frame marking

1. Click Video frame marking in the title area on the right to activate the video frame marking component.

2. Click Add frame mark or double-click the timeline below the video to open a pop-up window. Answer the questions to add a new frame mark. The results appear in the answer area on the right and on the timeline. To edit or delete an answer, hover over the question in the answer area or double-click the frame mark on the timeline.

Global questions

In the global question area, answer the questions that are configured for the entire video.