如何在Python中使用CEC控制？导入cec模块失败求助

作为编程新手遇到模块导入卡壳太正常了，别慌！咱们一步步来搞定这个CEC控制电视的问题～

第一步：先搞定CEC模块的正确安装 #

CEC模块不是Python自带的，得先装底层依赖+Python绑定：

• 先装系统级依赖（以Ubuntu/Debian为例，其他系统类似）：
  打开终端输入：

  sudo apt-get update && sudo apt-get install libcec-dev
  

  这个是给CEC功能提供底层支持的库，必须先装。
• 再装Python的CEC模块：
  用pip安装对应的Python绑定，输入：

  pip3 install cec
  

  （如果用Python2就换成pip，但现在更推荐用Python3）

第二步：确认模块导入名称没错 #

很多新手会卡在这里——安装的模块名和导入名可能不一样！
你在代码里应该写：

import cec

如果安装的是pycec（另一个常用的CEC库），那导入语句是import pycec，不过先优先试上面的cec模块。

第三步：验证安装是否成功 #

先别急着写代码，在终端里测试一下：

1. 输入python3进入Python交互环境
2. 输入import cec，如果没弹出任何报错，说明安装成功了！
3. 如果报错ModuleNotFoundError，回到第一步重新检查安装步骤；如果是编译相关的错误，大概率是系统依赖没装全，再重新装一遍libcec-dev。

第四步：测试简单的开关电视代码 #

安装成功后，试试这个极简的示例代码（记得保存成tv_control.py）：

import cec

# 初始化CEC控制器
cec.init()

# 获取电视设备（大多数电视的CEC地址是0）
tv_device = cec.Device(0)

# 打开电视
tv_device.power_on()
print("电视已打开")

# 要是想测试关机，就把上面两行注释掉，解开下面的
# tv_device.standby()
# print("电视已关闭")

⚠️ 注意：运行这个脚本需要root权限（因为CEC要访问HDMI硬件），所以终端里输入：

sudo python3 tv_control.py

常见问题排查 #

• 如果报错libcec.so.x: cannot open shared object file：说明系统里的libcec库没装好，重新执行第一步的系统依赖安装命令。
• 如果pip安装失败：先升级pip再试pip3 install --upgrade pip && pip3 install cec。
• 电视没反应？先确认电视的HDMI-CEC功能已经开启（不同品牌叫法不同：索尼叫BRAVIA Sync，三星叫Anynet+，LG叫Simplink），并且你的电脑/设备的HDMI口支持CEC。

内容的提问来源于stack exchange，提问作者Aaron Gingrich