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
To build with Python, need below:
pycurl
The use of external libraries will be explained later.
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++)
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)
See here for building with Python.
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.
For additional information, see ADAM_AdditionalInfo_Set() in the API specification.
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).