# video-sdks

**Repository Path**: nextaiot/video-sdks

## Basic Information

- **Project Name**: video-sdks
- **Description**: 大华海康sdk
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-04
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NexIoT Video SDK Native Libraries

This directory contains Hikvision, Hikvision ISUP, and Dahua native SDK files used by the standalone `nexiot-video-sdk-gateway` process.

This directory is intended to be checked out as a Git submodule of the main NexIoT repository so gateway deployments can be self-contained without storing large SDK binaries in the main repository. Keep dump files, local logs, temporary files, and database scratch files out of Git.

## Recommended Layout

```text
sdk-libs/
  dahua/
    linux-x86_64/
      libdhnetsdk.so
      libavnetsdk.so
      libdhconfigsdk.so
      ...
    win-x86_64/
      dhnetsdk.dll
      avnetsdk.dll
      dhconfigsdk.dll
      ...
  hik/
    linux-x86_64/
      libhcnetsdk.so
      libHCCore.so
      HCNetSDKCom/
      ...
    win-x86_64/
      HCNetSDK.dll
      HCCore.dll
      HCNetSDKCom/
      ...
  hik-isup/
    linux-x86_64/
      libHCISUPCMS.so
      libHCISUPAlarm.so
      libHCISUPStream.so
      libHCISUPSS.so
      ...
    win-x86_64/
      HCISUPCMS.dll
      HCISUPAlarm.dll
      HCISUPStream.dll
      HCISUPSS.dll
      ...
```

## Runtime Configuration

For Dahua on Linux:

```bash
export NEXIOT_DAHUA_SDK_ENABLED=true
export NEXIOT_DAHUA_SDK_NATIVE_PATH=/opt/nexiot/video-sdk-gateway/sdk-libs/dahua/linux-x86_64
export NEXIOT_DAHUA_SDK_BRIDGE_CLASS=cn.universal.video.sdk.gateway.nativebridge.dahua.DahuaNetSdkBridge

# Optional. Usually not needed when JNA can load libdhnetsdk.so from NEXIOT_DAHUA_SDK_NATIVE_PATH.
export NEXIOT_DAHUA_SDK_LOAD_NATIVE=false
export NEXIOT_DAHUA_SDK_LIBRARY_FILES=libdhnetsdk.so
```

For Hikvision on Linux:

```bash
export NEXIOT_HIK_SDK_ENABLED=true
export NEXIOT_HIK_SDK_NATIVE_PATH=/opt/nexiot/video-sdk-gateway/sdk-libs/hik/linux-x86_64
export NEXIOT_HIK_SDK_BRIDGE_CLASS=cn.universal.video.sdk.gateway.nativebridge.hik.HikNetSdkBridge

# Optional explicit System.load order when required by a specific SDK package.
export NEXIOT_HIK_SDK_LOAD_NATIVE=true
export NEXIOT_HIK_SDK_LIBRARY_FILES=libhcnetsdk.so
```

For Hikvision ISUP on Linux:

```bash
export NEXIOT_HIK_ISUP_ENABLED=true
export NEXIOT_HIK_ISUP_NATIVE_PATH=/opt/nexiot/video-sdk-gateway/sdk-libs/hik-isup/linux-x86_64
export NEXIOT_HIK_ISUP_LOAD_NATIVE=false

export NEXIOT_HIK_ISUP_CMS_IP=192.168.31.118
export NEXIOT_HIK_ISUP_CMS_PORT=7660
export NEXIOT_HIK_ISUP_SMS_PORT=7665
export NEXIOT_HIK_ISUP_ALARM_TCP_PORT=8003
export NEXIOT_HIK_ISUP_ALARM_UDP_PORT=8002
export NEXIOT_HIK_ISUP_PIC_PORT=6011
export NEXIOT_HIK_ISUP_KEY=12345
export NEXIOT_ZLM_API_BASE_URL=http://192.168.31.118:8080
export NEXIOT_ZLM_SECRET=
```

Also set the OS loader path when the SDK depends on sibling libraries:

```bash
export LD_LIBRARY_PATH="${NEXIOT_DAHUA_SDK_NATIVE_PATH}:${LD_LIBRARY_PATH:-}"
```

On Windows, use the matching `win-x86_64` directory and add it to `PATH`.

## Reference Source

The imported `ruoyi-qs-nvr` reference tree contains sample vendor SDK layouts:

- `ruoyi-qs-nvr/ruoyi-modules/ruoyi-dahua/lib/linux`
- `ruoyi-qs-nvr/ruoyi-modules/ruoyi-dahua/lib/win`
- `ruoyi-qs-nvr/ruoyi-modules/ruoyi-haikang/lib/linux`
- `ruoyi-qs-nvr/ruoyi-modules/ruoyi-haikang/lib/win`

The current directory was initialized from those reference SDK layouts.