homevision-skill

name	homevision-skill
description	智慧屏设备专用技能

依赖关系

本技能依赖 common-skill 的通用设备控制能力：

• 设备查询：使用 common-skill 的 get_devices_info 查询账号下所有设备，通过 devType='09C' 筛选智慧屏
• 设备详情：使用 common-skill 的 get_device_detail 获取智慧屏的详细状态和属性信息
• 设备控制：使用 common-skill 的 control_device 执行智慧屏特定功能，配合本技能提供的 sid 和参数

触发关键词

• 智慧屏、MateTV、电视、儿童模式、未成年人模式
• 智能呵护、距离提醒、坐姿提醒
• 息屏、音量调节、网络状态

---

🎯 智慧屏支持的能力清单（完整列表）

⚠️ 重要注意事项

• 参数取值/含义：严格遵守技能说明，查询到数据后先看技能文件说明（是否支持，什么含义）再回答用户。下发指令时必须使用提供的参数下发，不要猜测参数。
• 指令下发：只支持单条下发，不要合并指令
• 能力限制：智慧屏设备仅支持本技能"支持的能力清单"中列出的操作，其他任何操作均不支持
• 用户沟通：回复内容要贴合用户，不要暴露内部实现细节，当用户请求不支持的操作时，必须明确告知用户"该能力当前还未支持"，引导用户查看支持的能力清单
• 空值处理：智能呵护相关字段（distanceReminder、postureProtect、blueLightFilter、cameraRemindOnlyChild）GET查询返回必定为空字符串，空字符串不代表功能已关闭，无法据此判断功能状态

---

1. 儿童模式控制（sid: childMode）

操作	支持状态	说明
打开未成年人模式	✅ 支持	使用 {"mode": "ON"}
关闭未成年人模式	❌ 不支持	系统限制，无法关闭
打开未成年人模式锁	✅ 支持	使用 {"mode": "LOCK_ON"}
关闭未成年人模式锁	✅ 支持	使用 {"mode": "ON"}
查询儿童模式状态	✅ 支持	使用 GET 操作，mode字段有意义

参数说明

• mode：
  • OFF 表示儿童模式已关闭
  • ON 表示儿童模式已打开，未上锁
  • LOCK_ON 表示儿童模式已打开，且上锁

操作流程

打开未成年人模式

1. 执行 POST 操作：{"mode": "ON"}
2. 执行 GET 操作查询状态
3. 若 mode 返回 OFF，说明设备未设置密码/未创建儿童账户，提示用户："请先在智慧屏设备上设置密码并创建儿童账户"

关闭未成年人模式锁

1. 执行 GET 操作查询当前状态
2. 若 mode 为 OFF，不允许操作，告知用户当前未成年人模式未开启
3. 若 mode 为 LOCK_ON，执行 POST 操作：{"mode": "ON"}

---

2. 智能呵护功能控制（sid: childMode）

⚠️ 前置条件：智能呵护功能需在儿童模式打开（mode为ON或LOCK_ON）后才能设置。

操作	支持状态	说明
打开距离提醒	✅ 支持	使用 {"distanceReminder": "1"}
关闭距离提醒	✅ 支持	使用 {"distanceReminder": ""}
打开坐姿提醒	✅ 支持	使用 {"postureProtect": "1"}
关闭坐姿提醒	✅ 支持	使用 {"postureProtect": ""}

查询说明

字段	GET查询结果	能否判断状态
distanceReminder	必定返回空字符串 ""	❌ 无法判断
postureProtect	必定返回空字符串 ""	❌ 无法判断
blueLightFilter	必定返回空字符串 ""	❌ 无法判断

用户询问距离提醒/坐姿提醒是否开启时，应回复："该功能不支持查询，无法确认当前状态，请在智慧屏设备上直接查看"

---

3. 设备状态控制（sid: devicestate）

操作	支持状态	说明
息屏	✅ 支持	使用 {"on": 0}
亮屏	❌ 不支持	不支持亮屏操作

---

4. 音量控制（sid: speaker）

操作	支持状态	说明
调节音量	✅ 支持	使用 {"volume": 0-100}
查询音量	✅ 支持	使用 GET 操作

---

5. 网络信息查询（sid: netInfo）

操作	支持状态	说明
查询网络状态	✅ 支持	使用 GET 操作

---

🚫 不支持的能力清单

以下操作经常被误认为支持，但实际上均不支持，需明确告知用户：

操作	不支持原因
播放控制（播放/暂停/快进等）	能力暂未开放
频道切换	能力暂未开放
应用启动/关闭	不支持
语音助手唤醒	不支持
画面调节（亮度/对比度等）	不支持
打开/关闭护眼模式	不支持
查询护眼模式状态	GET返回空字符串，无法判断
查询距离提醒是否开启	GET返回空字符串，无法判断
查询坐姿提醒是否开启	GET返回空字符串，无法判断
其他未在支持清单中列出的操作	均不支持

---

使用流程

1. 使用 get_devices_info 获取设备列表，通过 devType='09C' 找到智慧屏
2. 使用 get_device_detail 获取智慧屏的详细信息（可选）
3. 使用本技能提供的 sid 和参数，通过 control_device 执行控制
4. 参考技能说明回复用户