开启打印流程

本文说明应用如何上传打印数据并开启打印。

调用顺序

  1. 注册并启动事件通知。
  2. 上传至少一份打印数据。
  3. 发送开始打印指令。
  4. 等待打印启动结果通知。

启动事件通知和上传打印数据都会在最终打印结果可用之前返回。

重试建议

  • 开始打印失败时，等待一秒后重试。
  • 总重试时间不超过十秒。
  • 开始打印指令成功后，最多等待十秒获取打印启动结果。

结果处理

结果应用处理
开始指令被接受，结果成功进入可打印状态
开始指令被接受，结果失败显示失败信息并结束流程
十秒内没有结果提示打印启动结果超时
数据上传失败结束流程并提示上传错误

C 示例

void on_event(const char *event_json, void *user_data)
{
    (void)event_json;
    (void)user_data;
    /* 更新打印流程状态 */
}

ti_set_event_callback(cli, on_event, NULL);
ti_start_event_subscription(cli);

if (ti_set_print_data(cli, print_data, print_data_len, 0) != TI_OK) {
    return;
}

int rc = ti_print_control(cli, "START_PRINT");
if (rc != TI_OK) {
    /* 在总超时时间内等待一秒后重试 */
}

集成提示

  • 使用 "START_PRINT" 等大写指令。
  • 不要把打印数据上传成功当作设备已准备好打印。
  • 以打印启动结果通知作为最终启动结果。
  • 事件回调中不要执行长时间阻塞操作。