# 次方云助手

**Repository Path**: btsc/sub__square_cloud_assistant

## Basic Information

- **Project Name**: 次方云助手
- **Description**: 以websocket方式操作指定打印机进行打印PDF文件
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2023-10-11
- **Last Updated**: 2023-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 次方云助手

#### 项目介绍
次方云助手客户端是以独立进程和打印机交互。
浏览器或其他客户端需要通过 WebSocket 协议与次方云助手进行通信， 支持 javascript，
java， c/c++， python, php 等常用的语言。
若 ISV 的 ERP 系统是 B/S 结构， 需要使用以下版本的浏览器来更好的支持 WebSocket:
chrome 45 及以上（建议使用 chrome 的最新版本）

#### 软件架构
软件架构说明


#### 安装教程

免安装

#### 使用说明

次方云助手 websocket 连接地址: ws://127.0.0.1:13613
请求协议基本格式
{
"cmd":"这是指令名称",
"content":"这是内容详情",
"print_name":"这是打印机名字"
}

实例:
1.打印本地 pdf 文件
{
"cmd":"print_file",
"content":"C:/Administrator/96aadb7829e33e64f275fc1bbf9b1eb0.pdf",
"print_name":"10*10"
} 2
.打印网络 pdf 文件
{
"cmd":"print_url",
"content":"http://www.baidu.com/1132349299.pdf",
"print_name":"10*10"
} 3
.打印二进制 pdf 文件(base64 后的字符串)
{"cmd":"print_code",
"content":"JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggNTIvRmlsdGVyL0ZsYXRlR
GVjb2RlPj5zdHJlYW0KeJwr5HIK4TI2tNQzVdA1NlMISeFyDeEK5CpUMFQwAEIImZyroB+RZqjgkq8Q
yAUABsUKgQplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwvVHlwZS9QYWdlL01lZGlhQm94Wz
I4My41IDI4My41IDAgMF0vUm==",
"print_name":"10*10"
} 4
.打印纯文本数据
{
"cmd":"print_msg",
"content":"打印测试数据\r\n 第一行数据\r\n 第二行数据",
"print_name":""
} 5
.获取打印机列表
{
"cmd":"print_list",
"content":"",
"print_name":""
}


响应协议格式： 次方云助手会返回如下格式的响应头给请求方。
{
"ack":"响应结果",
"msg":"响应文本内容"
}


 **注:
1.打印纯文本任务, print_name 指定打印机无效(调用默认打印机),该属性为可选项
2.打印机名字必须和本机或网络中打印机名字保持一致
3.请求协议数据中, 如出现\(反斜线)分隔符,必须进行转义, 建议统一用/(斜线)分隔符** 

#### 注意事项
1. 在用 JavaScript， C#， C++， delphi， JAVA, PHP 使用 webSocket 的过程中，要以全局对象
的形式存在， 不要每次发送交互请求去创建一个对象， 做到 webSocket 对象重用， 和打印组件保持长连接，不然会导致各种意想不到的问题!
2. 在同打印组件交互过程中的 json 报文， 如果文本中包含了特殊字符， 比如常见的回
车， 引号等， 需要对特殊字符做转义， 详细请参考: http://www.json.org/json-zh.html 。
3. 可能存在发送交互请求成功, 响应也成功, 但打印机无反映的情况, 这种一般是请求数
据出错, 或者打印的文件出错， 或者打印机问题, 请自行检查！
4. 不建议使用打印网络文件形式, 因网络因素不可控!
5. 次方云助手暂只支持打印 pdf 类型文件, 其他文件类型暂不支持。