# WebPrinter

**Repository Path**: vichen2021/web-printer

## Basic Information

- **Project Name**: WebPrinter
- **Description**: 本项目旨在为各品牌云打印机提供统一的 C# 接口封装SDK ，方便开发者快速集成云打印功能。目前已对接"大趋智能"打印机品牌。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-06-19
- **Last Updated**: 2025-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SDK, 餐饮, 云打印机

## README

# WebPrinter 云打印机对接库

> 如果你觉得本项目有帮助，欢迎 star 支持！

本项目旨在为云打印机提供统一的 C# SDK 接口，方便开发者快速集成云打印功能。目前已对接"大趋"打印机品牌。

## 项目特点
- **统一接口**：简化不同品牌云打印机的对接流程。
- **C# 实现**：适用于 .NET 平台的各类应用。

## 支持品牌
- [x] 大趋打印机（Daqu）
- [ ] 其他主流品牌（规划中）

## 主要功能
1. **加签/验签**：对API请求参数进行签名与验签，保障数据安全。
2. **API请求**：
   - 添加打印机
   - 打印小票
   - 其他云打印相关操作

## 目录结构
```
WebPrinter/
  ├─ WebPrinter.Console/      // 控制台示例项目
  ├─ WebPrinter.Library/      // 核心库，封装云打印机对接逻辑
  └─ WebPrinter.sln           // 解决方案文件
```

## 快速开始

### 1. 基本用法示例
```csharp
using WebPrinter.Library;
using WebPrinter.Library.DaQu;

class Program
{
    static async Task Main(string[] args)
    {
        // 创建品牌客户端（以大趋为例）
        var client = PrinterClientFactory.Create(PrinterBrand.Daqu, "开发者AppId", "你的appsecrect");

        // 绑定打印机
        var addResult = await client.AddPrinterAsync("设备sn", "设备key");
        Console.WriteLine($"绑定结果: {addResult.Success}, {addResult.Message}");

        // 打印小票
        var printResult = await client.PrintReceiptAsync("设备sn", "==测试打印==");
        Console.WriteLine($"打印结果: {printResult.Success}, {printResult.Message}");
    }
}
```
> 具体接口和参数请参考源码及后续文档补充。

### 2. 开发者密钥获取
请前往各品牌开放平台注册账号并获取 AppId、AppSecret 等开发者密钥。
大趋智能API文档：https://doc.trenditiot.com/docs/start

### 3. 加签/验签
SDK 内部已集成签名算法，调用接口时自动完成签名与验签。

## 未来规划
- 支持更多云打印机品牌（如芯烨、商鹏、佳博等）

## License
MIT