萤石云软件技术文档
萤石云软件是由海康威视旗下品牌"萤石"推出的智能化视频管理平台，基于云计算、物联网和AI技术，为家庭、企业及行业用户提供安全监控、设备管理、数据存储与智能分析服务。其核心功能覆盖实时视频预览（支持最高4K分辨率）、云端录像回放（最长支持30天存储周期）、移动侦测报警（灵敏度可调范围0.1-1.0）、多终端协同管理（单账号最多绑定50台设备）等模块。
该软件支持跨平台部署，兼容Windows 7及以上操作系统（含x86/x64架构）、Android 6.0+及iOS 11+移动端，同时提供Web浏览器访问接口。典型应用场景包括：
硬件要求包含支持H.265编码的萤石系列设备（如C6系列摄像机）、网络带宽建议上行≥2Mbps（720P画质）。软件安装需通过官网或认证渠道获取安装包，Windows端建议预留2GB以上存储空间。
注册流程包含：
1. 手机号/邮箱验证（支持86+国际区号）
2. 企业认证（需上传统一社会信用代码）
3. 创建应用获取AppKey（格式示例：a1b2c3d4e5）
通过"萤石云视频"APP可实现三类设备接入：
1. 扫码直连：扫描设备底部二维码（有效距离15-30cm）
2. 序列号绑定：输入18位设备SN码+6位验证码
3. API接入：调用`/api/lapp/device/add`接口实现批量接入
设备管理功能支持：
| 组件 | 最低要求 | 推荐配置 |
| CPU | Intel Pentium 4 | Intel i5-6500 |
| 内存 | 2GB DDR3 | 8GB DDR4 |
| 存储 | 50GB HDD | 256GB SSD+1TB HDD |
| 显卡 | 集成显卡 | NVIDIA GTX 1050 |
| 网络接口 | 100Mbps以太网 | 千兆双网卡 |
特殊场景要求：
需开放以下端口实现外网访问：
建议配置QoS优先级（DSCP 46）保障视频传输质量
集成YOLOv5算法实现：
配置方法：
python
启用智能分析服务
from ezviz import AI_Service
ai_config = {
motion_detection": True,
face_recog_threshold": 0.85,
alarm_interval": 30 单位：秒
AI_Service.enable(ai_config)
通过OBS虚拟摄像机实现直播推流：
1. 获取设备RTSP地址（格式：rtsp://admin:password@ip:554）
2. 配置OBS媒体源（缓冲大小建议2-4MB）
3. 抖音直播伴侣选择"OBS Virtual Camera
API开发包（EZPCOpenSDK）支持：
日志分级管理：
日志保存策略：
| 代码 | 含义 | 解决方案 |
| 40005 | 设备验证码错误 | 重置设备验证码 |
| 50002 | 视频流加密失败 | 更新TLS证书 |
| 60013 | 云存储空间不足 | 扩容存储套餐 |
| 90001 | API调用频率超限 | 调整请求间隔≥200ms |
技术支持通道：
本技术文档基于萤石开放平台最新版（v4.8.1）编制，详细开发指南可参考官方API文档。系统配置建议定期进行压力测试（建议并发数≥设备数×1.5），确保在峰值负载下CPU使用率≤75%，内存占用≤80%。
