WebUI项目新增客户端接口以增强跨语言支持

WebUI作为一个轻量级的跨平台Web UI库，近期对其客户端接口进行了重要升级。这次升级的核心目标是解决不同语言封装层对客户端API的调用需求，特别是为Deno等非C语言环境提供更友好的接口支持。

背景与需求

在WebUI的原始设计中，客户端操作主要通过webui_event_t结构体进行。这种设计虽然简洁，但对于其他编程语言封装层来说存在一定局限性。例如，Deno等环境需要更直接的接口来执行客户端操作，而不必依赖完整的事件结构体。

新增接口设计

开发团队新增了6个关键接口，这些接口直接使用窗口ID和事件编号作为参数，替代了原先的事件结构体指针：

webui_interface_show_client(size_t window, size_t event_number, const char* content);
webui_interface_close_client(size_t window, size_t event_number);
webui_interface_send_raw_client(size_t window, size_t event_number, const char* function, const void* raw, size_t size);
webui_interface_navigate_client(size_t window, size_t event_number, const char* url);
webui_interface_run_client(size_t window, size_t event_number, const char* script);
webui_interface_script_client(size_t window, size_t event_number, const char* script, size_t timeout, char* buffer, size_t buffer_length);

技术优势

1. 更好的跨语言支持：新接口使用基本数据类型作为参数，使得其他语言封装层更容易实现绑定。

2. 功能完整性：新接口完全覆盖了原有功能，包括：

   • 显示内容
   • 关闭窗口
   • 发送原始数据
   • 导航控制
   • 脚本执行

3. 性能优化：直接传递窗口ID和事件编号减少了间接访问的开销。

实现细节

每个新接口都对应一个原始API，内部实现会将参数转换为适当的事件结构体引用。例如：

void webui_interface_show_client(size_t window, size_t event_number, const char* content) {
    webui_event_t e = {.window = window, .event_number = event_number};
    webui_show_client(&e, content);
}

这种设计既保持了向后兼容性，又提供了更灵活的调用方式。

应用场景

这些接口特别适合以下场景：

• 需要从非C语言环境调用WebUI功能
• 构建轻量级封装层
• 需要直接控制特定窗口和事件
• 自动化测试场景

总结

WebUI项目的这次接口升级体现了其对多语言生态支持的重视。通过提供更底层的控制接口，开发者可以更容易地将WebUI集成到各种编程环境中，同时保持了原有API的简洁性和功能性。这一改进将为WebUI在更广泛场景下的应用打开大门。