# Smart-Socket-Miniprogram

**Repository Path**: End-ING/smart-socket-miniprogram

## Basic Information

- **Project Name**: Smart-Socket-Miniprogram
- **Description**: 智能插座微信小程序项目代码
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-07-25
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能插座小程序

[![License: GPL-3.0](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://opensource.org/licenses/GPL-3.0)

智能插座控制小程序，支持实时监控、定时控制、用电统计等功能。本项目是智能插座系统的微信小程序端，通过局域网 UDP 协议与智能插座硬件设备进行通信。

## 界面预览

### 主要功能界面
<div align="center">
  <img src="docs/images/index.png" width="200" alt="首页">
  <img src="docs/images/timer.png" width="200" alt="定时页面">
</div>

### 设置与配置
<div align="center">
  <img src="docs/images/settings1.png" width="200" alt="设置1">
  <img src="docs/images/settings2.png" width="200" alt="设置2">
  <img src="docs/images/network-config1.png" width="200" alt="网络配置1">
  <img src="docs/images/network-config2.png" width="200" alt="网络配置2">
</div>

## 相关项目

本项目需要配合以下硬件项目使用：

- [智能插座硬件项目](https://gitee.com/nzttj/smart-socket-firmware.git) - ESP8266 智能插座硬件实现

## 通信说明

- 采用局域网 UDP 通信协议
- 使用 mDNS 服务发现局域网内的智能插座设备
- 支持实时数据交互和设备控制
- 通信数据采用自定义二进制协议

## 功能特性

- 🏠 设备管理
  - 自动发现局域网内的智能插座设备
  - 支持多设备管理
  - 实时显示设备连接状态

- 📊 用电监控
  - 实时显示功率、电压、电流等数据
  - 支持今日用电量统计
  - 提供周/月度用电量图表分析

- ⏰ 定时控制
  - 支持设置定时开关
  - 灵活的时间段设置
  - 定时任务管理

- 📈 数据统计
  - 详细的用电记录查询
  - 支持按日期查看用电数据
  - 图表化展示用电趋势

- ⚙️ 系统设置
  - 设备配置管理
  - 系统参数设置
  - 关于页面

## 技术栈

- 微信小程序原生开发
- UDP 通信协议（局域网通信）
- mDNS 设备发现（局域网设备发现）
- ECharts 图表展示

## 安装说明

1. 确保智能插座硬件已正确配置并接入局域网
2. 使用微信开发者工具打开项目
3. 在微信开发者工具中导入项目，填写自己的 AppID
4. 编译运行

## 项目结构

```
├── app.js              # 应用程序入口
├── app.json            # 全局配置
├── pages/              # 页面文件夹
│   ├── index/          # 首页（设备列表）
│   ├── timer/          # 定时器页面
│   ├── settings/       # 设置页面
│   └── ...
├── utils/              # 工具类
│   ├── udpManager.js   # UDP 通信管理
│   ├── mdnsManager.js  # mDNS 设备发现
│   └── ...
└── ec-canvas/          # ECharts 组件
```

## 使用说明

1. 确保手机和智能插座在同一个局域网内
2. 打开小程序，等待自动扫描局域网内的智能插座设备
3. 点击设备进行连接
4. 连接成功后可以进行以下操作：
   - 查看实时用电数据
   - 控制插座开关
   - 设置定时任务
   - 查看用电统计

## 开发说明

### 环境要求

- 微信开发者工具

### 开发规范

- 遵循微信小程序开发规范
- 使用 ES6+ 语法
- 代码注释完整
- 遵循组件化开发原则

## 贡献指南

1. Fork 本仓库
2. 创建新的功能分支
3. 提交代码
4. 创建 Pull Request

## 联系方式

如有问题或建议，请提交 Issue 或 Pull Request。