# sdk_yushi

**Repository Path**: Free4K/sdk_yushi

## Basic Information

- **Project Name**: sdk_yushi
- **Description**: 宇视SDK项目开发，使用Springboot（若依）从原企业项目中重新整理出的部分硬件相关代码。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-18
- **Last Updated**: 2025-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 宇视SDK, 宇视, SpringBoot, yushi

## README

## 说明

​        宇视设备SDK开发示例。本代码以springboot(若依分离版)为基础，以原先的开发一个项目为基础，整理出**部分门禁相关的硬件功能**。本代码中删除了所有的数据以及非硬件相关的代码，仅包含硬件连接的相关操作。

​        硬件核心操作流程位于admin模块中的**MyAsync**类中。Test类中有更为简洁的登陆并使用设备截图的功能示例。

依据官方文档实现对应功能。

![](./static/yssdk.PNG)

### 以下是AI分析生成的功能说明

关于AI提出的潜在问题，根据实际情况可进行忽略/改进。

## 功能概述

1. **异步设备管理**：通过 `@Async` 注解实现异步执行设备监控任务
2. **设备状态检查**：登录网络设备并检查在线状态
3. **人流统计**：统计设备的进出人数并触发告警
4. **数据持久化**：将统计结果保存到数据库
5. **截图功能**：在特定条件下捕获设备画面

## 详细组件分析

### 1. 依赖注入

- **数据访问组件**：
  - 注入了多个 Mapper 接口用于数据库操作
  - 包括告警记录、场所、设备信息等
- **配置项**：
  - `@Value("${file.path}")` 注入了文件存储路径

### 2. 核心方法 `async()`

- **设备初始化**：
  - 设置 SDK 超时参数
  - 获取所有硬件设备列表
- **设备登录流程**：
  - 为每个设备设置登录参数
  - 尝试登录并更新设备在线状态
  - 失败时记录日志并跳过该设备
- **通道状态查询**：
  - 查询视频通道详情
  - 筛选在线通道
- **人流统计**：
  - 按天统计每个通道的进出人数
  - 计算场所内当前人数
- **告警逻辑**：
  - 当人数超过场所容量时插入告警记录
- **数据记录**：
  - 每日最高人数记录
  - 必要时捕获设备截图

### 3. 辅助方法

- `getWeekForYear()`：计算日期所在的周数

## 技术特点

1. **异步处理**：
   - 使用 Spring 的 `@Async` 实现异步执行
   - 适合耗时较长的设备监控任务
2. **JNA 集成**：
   - 通过 JNA 调用 NetDEV SDK 本地方法
   - 处理复杂的数据结构和内存操作
3. **状态管理**：
   - 实时更新设备在线状态
   - 记录每日人流峰值
4. **异常处理**：
   - 使用 try-catch 捕获并记录异常
   - 确保单个设备故障不影响其他设备处理

## 业务逻辑流程

1. 初始化 SDK 参数
2. 遍历所有设备：
   - 登录设备 → 检查状态 → 查询通道 → 统计人流
   - 判断是否超限 → 记录告警
   - 记录每日数据 → 必要时截图
   - 注销设备
3. 记录处理日志

## 潜在改进建议

1. **日志增强**：
   - 增加更详细的调试日志
   - 使用 SLF4J 替代 Commons Logging
2. **资源管理**：
   - 确保所有 SDK 资源正确释放
   - 添加连接超时和重试机制
3. **性能优化**：
   - 考虑并行处理多个设备
   - 缓存频繁访问的数据
4. **配置灵活性**：
   - 将硬编码参数(如超时时间)改为可配置项
5. **异常处理**：
   - 细化异常处理逻辑
   - 添加重试机制关键操作

## 典型使用场景

- 智能安防系统中的人员密度监控
- 公共场所的人流统计与管理
- 基于视频分析的安全预警系统
- 设备状态集中监控平台

这个服务类展示了如何将设备 SDK 集成到 Spring 应用中，并实现复杂的异步监控逻辑，是视频监控类应用的典型实现方式。