additional_info_sample_app

 

Table of contents


 

Introduction


This explanation assumes that the i-PRO camera application development environment has been completed.
If you are not ready to build the development environment, please refer to here to complete it.

Also, in this tutorial, the SDK installation directory is described as ${SDK_DIR}.

Operation overview


additional_info_sample_app is a sample application that adds additional information to video or audio streams.

 

External libraries required for operation


No special mention.

 

Directory path of the sample app


The C/C++ source code is stored below.

${SDK_DIR}/src/adamapp/additional_info_sample_app

The Python source code is stored below.

${SDK_DIR}/src/adamapp-py/additional_info_sample_app

 

How to build the sample app (C/C++)


This article describes how to build it as AdamApp.
If you want to build it as Container AdamApp for Azure IoT Edge, see below.

Development tutorial (Container AdamApp for Azure IoT Edge) - Technology Partner FAQ (En) - Confluence (atlassian.net)

Load the build environment settings file in the SDK installation directory.

$ cd ${SDK_DIR} $ source setup_env.sh ipro-ambaCV2X

Set the build environment according to each environment.
Here, specify ipro-ambaCV2X.

 

make.

$ cd src/adamapp/additional_info_sample_app $ make

It is successful if the .ext file is created in ${SDK_DIR}/src/adamapp/additional_info_sample_app.

 

Install it on the camera (eg, you can install from the green frame in the image below). Select the created .ext file and install it.
Open the app screen (red frame button in the image below).

 

It is successful if a character string like the image below is displayed.

 

How to build the sample app (Python)


This article describes how to build it as AdamApp.
If you want to build it as Container AdamApp for Azure IoT Edge, see below.

Development tutorial (Container AdamApp for Azure IoT Edge) - Technology Partner FAQ (En) - Confluence (atlassian.net)

Load the build environment settings file in the SDK installation directory.

$ cd ${SDK_DIR} $ source setup_env.sh ipro-ambaCV2X

 

make.

It is successful if the .ext file is created in ${SDK_DIR}/src/adamapp-py/additional_info_sample_app.

 

Install it on the camera (eg, you can install from the green frame in the image below). Select the created .ext file and install it.
Open the app screen (red frame button in the image below).

If the image below is displayed, it is successful.

 

How to use the sample app


Let's check that additional information has been added. Prepare network analyzer software such as Wireshark to check the network information sent from the camera to your computer.
(Additional information cannot be viewed unless the camera is showing live video.)

 

■ Network information before installing the sample application As shown below, you can confirm that additional information is not given.

■ Network information after installing the sample application As shown in the red frame below, you can confirm that additional information "Additional Info test" is added.

 

Appendix


Additional information

H.264, H.265 and Audio:
Additional information will be embedded in the RTP header extension in a first RTP packet each frame.

 

JPEG:
Additional information will be embedded in the COM segment.

 

RTP header extension format in i-PRO is below.

defined by profile: Always 0.
ID: Set more than 0xff.
additional information: Set any data (up to 512bytes).