一、这个 skill 是做什么的
很多家庭装了不止一台 TP-Link Tapo 摄像头(甚至一机双摄),但官方 Tapo / Kasa App 只能一台一台手动操作:想出门时全屋布防、回家时全部撤防,得挨个点开每台摄像头,非常麻烦。这个 skill 就是来解决"多机联动"痛点的——它帮你把多台摄像头分组、批量控制,实现一键设防(遮蔽镜头关闭、移动侦测开、声光报警开)和一键撤防。
它提供三种由浅入深的方案:方案 A(零代码,Home Assistant 集成)适合家里已有常开设备跑 Home Assistant 的用户;方案 B(自研桌面/服务端,pytapo 本地 API)适合愿意写少量 Python 脚本的玩家;方案 C(纯安卓手机 App,手机即中枢)是大多数普通用户的真实诉求——不买额外硬件、不新建账户,用安卓手机直接控制。
它还能澄清两个常见误区:① 控制摄像头不需要先新建"摄像头账户",直接用你已有的 Tapo 云账号(邮箱+密码)就能鉴权;② 不需要 7×24 常开中枢,你的安卓手机本身就是控制中枢。
二、什么时候用它
- 你有多台 Tapo 摄像头,抱怨官方 App "只能一台台手工布防/撤防"。
- 你想要"出门自动布防、回家自动撤防",而不是每次手动操作。
- 你想给摄像头分组(比如客厅组、院子组),不同组执行不同策略。
- 你想要定时布防(如 23:00 夜间布防、07:30 撤防)。
- 你想要地理围栏:离开家半径自动布防、回到家自动撤防。
- 你打算自研一个安卓 App来统一管理家里的摄像头。
三、前置条件 / 准备
硬性前提
- TP-Link Tapo 摄像头一台或多台,且连在同一个家里 WiFi(局域网)。
- 你已有的 Tapo 云账号(TP-Link ID 的邮箱 + 密码)。不需要新建"摄像头账户"——那是走 ONVIF/RTSP 第三方取流才需要的,控制用途用不上。
- 手机/电脑与摄像头在同一局域网内控制最稳。离开家后远程布防需走 Tapo 云 API(复杂度高),MVP 阶段可先不做。
- 方案 A(Home Assistant):需要一处能常开运行 Home Assistant 的环境(如树莓派、NAS、旧电脑)。
- 方案 B(pytapo):需安装 Python,并执行
pip install pytapo。
- 方案 C(安卓 App):安卓手机 + Android Studio(若要编译 APK),或 MacroDroid / Tasker(低代码免编译,但较脆弱)。
跨品牌提醒:萤石(EZVIZ) App、米家(Mi Home) App 都不能接管 TP-Link Tapo 摄像头,三家是各自封闭生态。Tapo 可用第三方监控软件(iSpy/Blue Iris/NAS)看流录像,但拿不到隐私遮蔽/声光报警等联动开关,对你的痛点帮助不大,不建议走。
四、具体用法(步骤)
方案 A(首选,零代码):Home Assistant + Tapo 集成
- 在 Home Assistant 中安装 Tapo 集成(HACS 搜
Tapo Control,或 HA 核心集成直接添加)。
- 用你的 Tapo 云账号(邮箱+密码)把每台摄像头添加为实体,集成会暴露
set_privacy_mode / set_alarm_mode / set_motion_detection_mode 等服务。
- 建一条自动化:触发条件选"地理围栏 / 定时 / 手动按钮",动作选"对所有摄像头批量执行"。
- 数据走局域网本地 API,不上云,更稳更隐私。
方案 B(自研桌面脚本):pytapo 本地 API
- 安装库(进阶可选,见下方命令块)。
- 用现有 Tapo 云账号连接:
Tapo(host, email, cloud_password)(host 是摄像头局域网 IP)。
- 用关键接口控制:
t.setPrivacyMode(True) 物理遮蔽、t.setMotionDetection(enabled=True) 移动侦测、t.setAlarm(...) 声光报警。一机双摄用 chn_id=[0,1] 指定双通道。
- 定义"设防 = 关 privacy + 开 motion + 开 alarm","撤防 = 开 privacy + 关 motion + 关 alarm",写成脚本定时或手动调用。
方案 C(纯安卓手机 App,手机即中枢,无新账户)
- 在安卓手机装好控制 App,凭据只用一次填入现有 Tapo 账号(邮箱+密码)。
- 在家时手机经同 WiFi 直连每台摄像头本地 API 下发指令。
- 设置触发方式(推荐组合):
① WiFi 状态触发(最稳,推荐主用):手机断开家里 WiFi → 全员布防(出门);连上家里 WiFi → 全员撤防(回家)。纯本地比 GPS 围栏更准。
② GPS 地理围栏(备选):离开家半径→布防,进入→撤防。
③ 定时:设定时间执行(如 23:00 夜间布防 / 07:30 撤防)。
④ 手动一键:首页大按钮 + 下拉快捷开关。
- 双摄按通道
chn_id=[0,1] 分别下发指令。
五、可直接照用的示例
你直接对 AI大模型或AI智能体 说:「帮我用 Home Assistant 把家里 3 台 Tapo 摄像头做成:连上家里 WiFi 就自动撤防,断开 WiFi 就全员布防。」
AI大模型或AI智能体 会:给你一份 Home Assistant 自动化配置(触发用"WiFi 连接/断开"实体,动作对所有摄像头实体批量调用 set_privacy_mode / set_motion_detection_mode / set_alarm_mode),你复制到 HA 的 automations.yaml 即可生效。
你直接对 AI大模型或AI智能体 说:「帮我写个 Python 脚本,用我现在 Tapo 账号(邮箱 )把摄像头 一键设防和撤防。」
AI大模型或AI智能体 会:用 pytapo 生成一个脚本,包含设防/撤防两个函数,连好就调用 t.setPrivacyMode(False) 关遮蔽、t.setMotionDetection(True) 开侦测、t.setAlarm(...) 开报警;撤防则反过来。运行前只需把邮箱、密码、IP 填进去。
你直接对 AI大模型或AI智能体 说:「我想自己做个安卓 App,手机就是中枢,离开家自动布防、回家自动撤防,不想买额外硬件。」
AI大模型或AI智能体 会:按方案 C 给你一个 Kotlin 安卓工程方案——凭据只填一次现有 Tapo 账号,主用 WiFi 断开/连接触发,并加 GPS 围栏和定时兜底,双摄用 chn_id 分别下发,最后说明用 Android Studio 一键编译出 APK。
进阶 / 可选:方案 B 安装 pytapo(本地 API 库,事实标准,JurajNyiri 维护的非官方逆向库):
pip install pytapo
装好后,一段最小可跑的控制脚本长这样(把邮箱/密码/IP 换成你自己的):
from pytapo import Tapo
# 用你已有的 Tapo 云账号直接鉴权(不需要摄像头账户)
t = Tapo("", "", "你的云账号密码")
# 设防:关镜头遮蔽 + 开移动侦测 + 开声光报警
t.setPrivacyMode(False)
t.setMotionDetection(enabled=True)
t.setAlarm(enabled=True, soundEnabled=True, lightEnabled=True)
# 撤防:开遮蔽 + 关侦测 + 关报警
t.setPrivacyMode(True)
t.setMotionDetection(enabled=False)
t.setAlarm(enabled=False)
六、常见注意 / 避坑
- 别建"摄像头账户"当前提:控制摄像头直接用现有 Tapo 云账号即可,那个入口在 App 里可能根本找不到,正好不用走。
- 别指望跨品牌接管:萤石、米家 App 都加不了 Tapo,只能各自管各自的。
- 离开家后远程布防较复杂:纯局域网内控制最稳;要远程云控需走 Tapo 云 API(非官方逆向,复杂度高),MVP 阶段可先用"WiFi 断开瞬间本地发令 + 手动/定时兜底"。
- 非官方接口可能随固件变动:pytapo / 本地 API 是逆向接口,TP-Link 升级固件可能改动;遇问题先
pip install -U pytapo 或核对固件。若云账号鉴权被收紧,再回退到 Camera Account 本地账户。
- 没有真摄像头也能验证:方案 B 的参考工程支持
--mock 启动,无需硬件即可验证逻辑。
七、相关 skill / 延伸
- tplink-ipc-local-api:国内版 TP-Link 摄像头(TL-IPC 系列,非 Tapo 云方案)的本地 HTTP API 协议与离线安卓构建,与本 skill 同属 TP-Link 摄像头控制但针对的是另一类机型。
- video-editor:若联动产生的录像需要剪辑处理,可配合本 skill 的取流结果做后续编辑。
- windows-node-autostart:若你用方案 B 想把联动脚本常驻在 Windows 上自动运行,可参考此 skill 做开机自启。