API 参考
EventCallback
事件回调: (eventJson: string) => void
LogCallback
日志回调: (logLine: string) => void
TinCore {
打印服务客户端。
接口形状与 C API tijet_core.h 保持一致。
使用 @grpc/proto-loader 动态加载 proto 定义,无需预生成桩代码。
constructor
创建客户端实例(对应 tijet_client_create())。
close
释放所有资源(对应 tijet_client_destroy())。
connect
连接到打印服务(对应 tijet_client_connect())。
- address: 服务地址。
null/ 空字符串 → 默认 UDS;"host:port"→ TCP;其他 → UDS。
gRPC 1.62.2 兼容性
@grpc/grpc-js 是 Google 官方维护的纯 JS gRPC 实现,与 C++ 服务端的线协议完全兼容。
以下 channel options 对齐 C++ 1.62.2 的参数:
| grpc-js option | C++ 对应参数 | 值 |
|---|---|---|
grpc.keepalive_time_ms | GRPC_ARG_KEEPALIVE_TIME_MS | 30000 |
grpc.keepalive_timeout_ms | GRPC_ARG_KEEPALIVE_TIMEOUT_MS | 10000 |
grpc.keepalive_permit_without_calls | GRPC_ARG_KEEPALIVE_PERMIT_WITHOUT_CALLS | 1 |
grpc.max_receive_message_length | GRPC_ARG_MAX_RECEIVE_MESSAGE_LENGTH | 64 MiB |
grpc.max_send_message_length | GRPC_ARG_MAX_SEND_MESSAGE_LENGTH | 64 MiB |
disconnect
断开连接(对应 tijet_client_disconnect())。
isConnected
查询连接状态(对应 tijet_client_is_connected())。
networkConfig
配置设备网络(对应 tijet_client_network_config())。
setInt
设置 int32 参数
getInt
获取 int32 参数
setDouble
设置 double 参数
getDouble
获取 double 参数
setBool
设置 bool 参数
getBool
获取 bool 参数
setParameter
设置参数(对应 tijet_client_set_parameter())。
通过 Key 命名约定区分全局参数与驱动板参数。
getParameter
获取参数(对应 tijet_client_get_parameter())。
通过 Key 命名约定区分全局参数与驱动板参数。
setPrintData
发送打印数据(对应 tijet_client_set_print_data())。
@returns SHA-256 校验和(64 字符十六进制字符串)
setEventCallback
注册事件回调(对应 tijet_client_set_event_callback())。
startEventSubscription
启动事件订阅(对应 tijet_client_start_event_subscription())。
stopEventSubscription
停止事件订阅(对应 tijet_client_stop_event_subscription())。
setLogCallback
注册日志回调(对应 tijet_client_set_log_callback())。
startLogSubscription
启动日志订阅(对应 tijet_client_start_log_subscription())。
注意:当前 proto 尚无 WatchLogs RPC 定义,本方法为存根。
stopLogSubscription
停止日志订阅(对应 tijet_client_stop_log_subscription())。
lastError
最近一次错误信息(对应 tijet_client_last_error())。
jsToProtoValue
将 JavaScript 原生值转为 grpc-js 的 proto Value 表示。 proto-loader 使用简单的 JSON 映射,因此可以直接传 JS 值。
protoValueToJSON
将 grpc-js 返回的 proto Value 转为 JSON 字符串。