LGTV Companion技术解析：基于WebOS的OLED电视与PC智能联动解决方案

LGTV Companion技术解析：基于WebOS的OLED电视与PC智能联动解决方案

【免费下载链接】LGTVCompanion Power On and Off WebOS LG TVs together with your PC 项目地址: https://gitcode.com/gh_mirrors/lg/LGTVCompanion

LGTV Companion是一款专为解决OLED电视作为PC显示器时电源管理难题而设计的开源工具，通过WebOS API和Windows系统事件监听实现电视与PC的智能同步控制。该工具采用C++构建，支持Windows 10/11系统，能够自动响应PC的关机、重启、休眠、唤醒等电源事件，有效预防OLED屏幕烧屏问题，提供完整的自动化电视管理解决方案。

问题定义：OLED电视作为PC显示器的技术挑战

随着OLED电视在PC显示市场的普及，用户面临三个核心技术挑战：

1. 电源管理不匹配：传统PC显示器能够随主机自动开关，而OLED电视缺乏相应的硬件级电源联动机制
2. 烧屏风险加剧：OLED屏幕长时间显示静态内容易导致像素老化，需要智能的闲置检测和自动关闭功能
3. 操作复杂性：手动控制电视电源状态影响使用体验，多显示器环境下的拓扑变化管理尤为复杂

技术架构：多层事件驱动模型

LGTV Companion采用分层架构设计，核心组件包括事件监听层、逻辑处理层和WebOS通信层。

事件监听层实现

系统通过Windows事件日志监控和用户活动检测获取电源状态变化：

// 系统事件定义
#define EVENT_SYSTEM_SHUTDOWN     1
#define EVENT_SYSTEM_REBOOT       2  
#define EVENT_SYSTEM_RESUME       3
#define EVENT_SYSTEM_SUSPEND      5
#define EVENT_SYSTEM_DISPLAYOFF   6
#define EVENT_SYSTEM_DISPLAYON    7
#define EVENT_SYSTEM_USERBUSY     10
#define EVENT_SYSTEM_USERIDLE     11

事件监听器实时监控Windows电源事件，包括：

• 系统关机/重启事件（EVENT_SYSTEM_SHUTDOWN/REBOOT）
• 系统休眠/唤醒事件（EVENT_SYSTEM_SUSPEND/RESUME）
• 显示器状态变化（EVENT_SYSTEM_DISPLAYON/OFF）
• 用户活动状态（EVENT_SYSTEM_USERBUSY/IDLE）

WebOS通信层架构

与LG电视的通信基于WebOS的SSAP（Simple Service Access Protocol）协议，采用WebSocket连接实现双向通信：


安装界面采用复古电视与现代霓虹光带结合的设计，象征传统电视与智能系统的技术融合

通信层核心组件包括：

1. WebSocket客户端：建立与电视的SSL/TLS加密连接
2. 消息队列系统：异步处理命令发送和响应接收
3. 重试机制：网络中断时的自动重连和命令重发
4. 状态监控：定期轮询电视电源状态保持连接活跃

核心通信协议实现

// WebOS握手协议定义
#define LG_HANDSHAKE_PAIRED L"{\"type\":\"register\",\"id\":\"register_0\",\"payload\":{\"forcePairing\":false,\"pairingType\":\"PROMPT\",\"client-key\":\"#CLIENTKEY#\",\"manifest\":{\"manifestVersion\":1,\"appVersion\":\"1.0\",\"signed\":{\"created\":\"20260427\",\"appId\":\"com.lgtvc.app\",\"localizedAppNames\":{\"\":\"LGTV Companion\"},\"localizedVendorNames\":{\"\":\"LGTV Companion\"},\"permissions\":[\"TEST_SECURE\",\"CONTROL_INPUT_TEXT\",\"CONTROL_MOUSE_AND_KEYBOARD\",\"READ_INSTALLED_APPS\",\"READ_LGE_SDX\",\"READ_NOTIFICATIONS\",\"SEARCH\",\"WRITE_SETTINGS\",\"WRITE_NOTIFICATION_ALERT\",\"CONTROL_POWER\",\"READ_CURRENT_CHANNEL\",\"READ_RUNNING_APPS\",\"READ_UPDATE_INFO\",\"UPDATE_FROM_REMOTE_APP\",\"READ_LGE_TV_INPUT_EVENTS\",\"READ_TV_CURRENT_TIME\"],\"serial\":\"lgtvc-webos26\"},\"permissions\":[\"LAUNCH\",\"LAUNCH_WEBAPP\",\"APP_TO_APP\",\"CLOSE\",\"TEST_OPEN\",\"TEST_PROTECTED\",\"CONTROL_AUDIO\",\"CONTROL_DISPLAY\",\"CONTROL_INPUT_JOYSTICK\",\"CONTROL_INPUT_MEDIA_RECORDING\",\"CONTROL_INPUT_MEDIA_PLAYBACK\",\"CONTROL_INPUT_TV\",\"CONTROL_POWER\",\"CONTROL_TV_SCREEN\",\"READ_APP_STATUS\",\"READ_CURRENT_CHANNEL\",\"READ_INPUT_DEVICE_LIST\",\"READ_NETWORK_STATE\",\"READ_RUNNING_APPS\",\"READ_TV_CHANNEL_LIST\",\"WRITE_NOTIFICATION_TOAST\",\"READ_POWER_STATE\",\"READ_COUNTRY_INFO\",\"READ_SETTINGS\"]}}}"

配置方法与最佳实践

网络配置要求

配置项	技术参数	注意事项
网络连接	同一局域网（同子网）	不支持跨VLAN/WOL广播
IP分配	静态DHCP租约	确保电视IP地址固定
电视设置	启用"通过Wi-Fi开机"	无论使用有线或无线都必须启用
路由器	允许WOL广播包	部分路由器需特殊配置

安装配置流程

1. 环境准备

   • 确保电视和PC在同一局域网
   • 在路由器中为电视设置静态IP
   • 启用电视的"通过Wi-Fi开机"功能（路径：设置->通用->设备->外部设备）

2. 软件部署

   # 通过Winget安装
   winget install LGTVCompanion
   
   # 或手动安装
   # 1. 从GitCode下载安装包
   # 2. 运行安装程序
   # 3. 从开始菜单启动LGTV Companion
   


安装器横幅采用简洁的LG品牌标识，突出产品与LG电视的生态集成

3. 设备发现与配对
   • 点击"扫描"按钮自动发现网络中的WebOS设备
   • 手动添加设备需提供IP地址和MAC地址
   • 首次连接时电视会显示配对对话框，需手动确认

高级配置参数

系统支持多种高级配置选项，通过命令行或配置文件调整：

# 调整背光设置示例
param (
    [Parameter(Mandatory=$true)]
    [ValidateScript({$_ -eq "increase" -or $_ -eq "decrease"})]
    $scriptArgument
)

$executablePath = "C:\Program Files\LGTV Companion\LGTVcli.exe"
$arguments = "-ok", "backlight", "-get_system_settings", "picture", "[`\`"backlight`\`"]"

技术实现细节

多线程异步处理架构

系统采用Boost.Asio库实现异步I/O操作，确保在高并发场景下的稳定性：

// WebOS客户端实现类
class WebOsClient : public std::enable_shared_from_this<WebOsClient>
{
private:
    class Impl;
    std::shared_ptr<Impl> pimpl;
    
public:
    explicit WebOsClient(boost::asio::io_context&, 
                         boost::asio::ssl::context&, 
                         Device&, 
                         Logging&);
    bool powerOn(void);
    bool powerOff(bool = false);
    bool blankScreen(bool = false);
    bool sendRequest(std::string data, std::string log_message, int delay = 0);
};

电源状态管理机制

系统通过多种机制确保电视电源状态的准确控制：

1. WOL（Wake-on-LAN）唤醒：发送Magic Packet唤醒关机状态的电视
2. WebOS API关机：通过SSAP协议发送关机指令
3. 状态轮询：定期检查电视连接状态
4. 错误恢复：连接失败时的自动重试机制

闲置检测算法

用户闲置模式采用独立的检测机制，与Windows电源管理解耦：

// 闲置事件定义
#define EVENT_SYSTEM_USERBUSY     10
#define EVENT_SYSTEM_USERIDLE     11

// 闲置检测参数配置
- 检测间隔：可配置（默认30秒）
- 闲置阈值：可配置（默认5分钟）
- 恢复检测：鼠标/键盘活动监控

应用场景与技术集成

多显示器环境支持

系统能够响应Windows显示拓扑变化，在多显示器配置中智能管理电视状态：

场景	系统响应	技术实现
电视作为主显示器	完整电源管理	监听WM_DISPLAYCHANGE事件
电视作为扩展显示器	智能状态切换	检测显示器连接状态
混合显示器配置	独立控制	按设备类型区分管理

自动化脚本集成

通过命令行接口支持外部脚本自动化：

# 自动调整背光脚本示例
$value = int
switch ($scriptArgument) {
    "increase" {
        if ($value -lt 100) {
            $value += $rate
        } else {
            Write-Host "Already set to 100"
            exit 0
        }
    }
    "decrease" {
        if ($value -gt 0) {
            $value -= $rate
        } else {
            Write-Host "Already set to 0"
            exit 0
        }
    }
}

游戏模式自动切换

系统支持根据应用程序启动自动切换电视图像模式：

; AutoHotkey脚本示例 - 游戏启动时自动切换图像模式
RunWait, LGTVcli.exe -picturemode game Device1
Run, "C:\Games\YourGame.exe"
RunWait, LGTVcli.exe -picturemode expert1 Device1

性能优化与调优建议

网络延迟优化

优化项	推荐配置	效果
WOL重试间隔	1000ms	平衡响应速度与网络负载
状态轮询间隔	5000ms	减少不必要的网络流量
连接超时	3000ms	快速检测连接故障
最大重试次数	3次	避免无限重试循环

内存与CPU使用优化

系统采用智能资源管理策略：

• 按需连接：仅在需要时建立WebSocket连接
• 连接池管理：复用已建立的连接
• 异步处理：避免阻塞主线程
• 内存缓存：缓存设备状态减少重复查询

日志系统配置

内置日志系统支持多级别输出，便于故障排查：

// 日志级别定义
#define LOG_LEVEL_ERROR     1
#define LOG_LEVEL_WARNING   2  
#define LOG_LEVEL_INFO      3
#define LOG_LEVEL_DEBUG     4

// 日志输出配置
- 文件轮转：自动管理日志文件大小
- 时间戳：精确到毫秒的事件记录
- 设备标识：按设备分离日志输出

故障排查与技术限制

常见问题解决方案

问题现象	可能原因	解决方案
电视无法开机	WOL功能未启用	检查电视"通过Wi-Fi开机"设置
连接不稳定	网络配置问题	配置静态DHCP租约
配对失败	防火墙阻止	允许3000/3001端口通信
状态不同步	电视自动关机	延长电视自动关机时间

技术限制说明

1. 网络层限制：WOL广播包不能跨子网传输，电视和PC必须在同一子网
2. 硬件兼容性：仅支持WebOS 3.0及以上版本的LG电视
3. 电源状态检测：部分型号在像素刷新期间无法响应网络唤醒
4. 多用户环境：需要管理员权限安装Windows服务

调试工具使用

系统提供完整的调试支持：

• 启用详细日志：LGTVcli.exe -loglevel debug
• 测试连接状态：LGTVcli.exe -test Device1
• 获取设备信息：LGTVcli.exe -getinfo Device1
• 手动控制命令：LGTVcli.exe -poweron Device1

扩展开发指南

API接口规范

系统提供两种命令行接口：

1. LGTV Companion.exe：多线程异步执行，适合快速命令发送
2. LGTVcli.exe：单线程同步执行，支持JSON响应解析

自定义事件处理

开发者可以扩展事件处理逻辑：

// 自定义事件处理器示例
class CustomEventHandler : public EventHandler {
public:
    void onSystemEvent(int eventType, const std::string& data) override {
        // 自定义事件处理逻辑
        if (eventType == EVENT_SYSTEM_USERIDLE) {
            // 执行自定义闲置处理
        }
    }
};

插件开发支持

系统架构支持插件扩展：

• 事件监听插件：添加自定义事件源
• 命令处理插件：扩展控制命令集
• 设备驱动插件：支持新设备类型

安全与隐私保护

数据传输安全

所有与电视的通信均采用SSL/TLS加密：

• WebSocket连接使用WSS协议
• 证书验证确保连接安全性
• 客户端密钥本地存储加密

隐私保护策略

系统严格遵守隐私保护原则：

• 所有配置数据本地存储
• 不收集用户使用数据
• 无网络遥测功能
• 开源代码透明可审计

结语

LGTV Companion通过精巧的技术架构解决了OLED电视作为PC显示器时的核心管理难题，实现了设备间的智能联动。其基于WebOS API的通信机制、Windows事件监听系统和异步处理架构，为技术爱好者提供了完整的自动化电视管理解决方案。项目采用模块化设计，支持扩展开发，为OLED电视用户提供了专业级的电源管理和烧屏防护工具。

通过合理的配置和优化，LGTV Companion能够在多显示器环境、游戏应用场景和自动化工作流中提供稳定可靠的服务，成为OLED电视用户的必备工具。

【免费下载链接】LGTVCompanion Power On and Off WebOS LG TVs together with your PC 项目地址: https://gitcode.com/gh_mirrors/lg/LGTVCompanion