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 optionC++ 对应参数
grpc.keepalive_time_msGRPC_ARG_KEEPALIVE_TIME_MS30000
grpc.keepalive_timeout_msGRPC_ARG_KEEPALIVE_TIMEOUT_MS10000
grpc.keepalive_permit_without_callsGRPC_ARG_KEEPALIVE_PERMIT_WITHOUT_CALLS1
grpc.max_receive_message_lengthGRPC_ARG_MAX_RECEIVE_MESSAGE_LENGTH64 MiB
grpc.max_send_message_lengthGRPC_ARG_MAX_SEND_MESSAGE_LENGTH64 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 字符串。