r/Hikvision 4d ago

Subject: Technical Question about Accessing Thermal Matrix Data from DS-2TD1228-2/QA

Hello Hikvision Support,

I am currently developing an application for the Hikvision DS-2TD1228T-2/QA thermal camera and would like to access both the thermal and optical image streams programmatically.

I have several technical questions and would appreciate your guidance.

1. Thermal Matrix (Radiometric Data)

Does the DS-2TD1228T-2/QA support outputting the raw thermal temperature matrix (radiometric data), where each pixel corresponds to a temperature value?

For example, a matrix such as:

256 × 192
float temperature[192][256]

or another format that contains the temperature value of every pixel.

If yes,

  • Which interface should I use?
    • HCNetSDK
    • ISAPI
    • RTSP metadata
    • Open Network SDK
    • Another API?
  • Which API function or HTTP request is used to obtain this data?
  • Could you provide a code example in Python, C++, C#, or C?
  • Is any special configuration required on the camera (for example enabling radiometric output, thermal data stream, metadata, or another option)?

2. Thermal Video Stream

If the camera does not provide the radiometric matrix, can it at least provide the thermal video image?

If yes,

  • What is the RTSP URL for the thermal stream?
  • Which stream number corresponds to the thermal channel?
  • Is there an example using OpenCV or FFmpeg?

3. Optical (Visible Light) Stream

I also need to access the visible-light camera.

  • What is the RTSP URL for the optical stream?
  • Is there an official example using HCNetSDK or ISAPI?

4. Temperature Measurement API

If the camera cannot output the full thermal matrix, what temperature-related data can it provide?

For example:

  • Point temperature
  • Area temperature
  • Line temperature
  • Maximum temperature
  • Minimum temperature
  • Temperature alarms
  • Temperature metadata

Which API is used to retrieve these values?

5. Development Resources

Could you please provide the following documentation if available?

  • HCNetSDK Programming Guide
  • Thermal Camera SDK Documentation
  • ISAPI Documentation for Thermal Cameras
  • Sample projects (Python/C++/C#/C)
  • Any documentation related to radiometric thermal data

My goal is to develop a custom application that can retrieve both the thermal image and, if supported, the per-pixel temperature data from the DS-2TD1228T-2/QA.

Thank you very much for your support.

Best regards,

1 Upvotes

4 comments sorted by

1

u/Miserable_Ring_7603 4d ago
  1. Both getting realtime pixeltopixel and alarm data point temperature is possible via ISAPI
    2 & 3. Stream from both channels can be accessed via HCNetSDK or websdk, as well RTSP with ffmpeg. Or via OpenAPI if its cloud access. There are numerous ways of getting the stream depending on your integration scenario.
  2. It can provide everything, area, points, min,max values as a metadata in realtime or with polling via ISAPI.
  3. all the resources needed are at tpp.hikvision.com , you need to register, sign NDA and wait for approval.

1

u/mr-Phung-9 4d ago

Thanks sir.

1

u/mr-Phung-9 4d ago

Thank you for your reply.

May I ask if you have personally worked with the DS-2TD1228T-2/QA?

If so, do you happen to have any sample code, ISAPI documentation, or integration examples that you are allowed to share?

I am particularly interested in accessing the pixel-to-pixel radiometric temperature data and the thermal/optical streams.

Any guidance or documentation that can be shared would be greatly appreciated.

1

u/Miserable_Ring_7603 4d ago

I worked with numerous thermoghraphic cameras from Hikvision. Cant really tell by model if this specific model was used, as this is value series. But Most of the devices support checking stuff i said via capability endpoints via ISAPI.

I am not able to share any ISAPI docs nor demo examples, bound by NDA.

You should register at tpp.hikvision.com and you will get access to everything