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表示儿童模式已打开,且上锁
操作流程
打开未成年人模式
- 执行 POST 操作:
{"mode": "ON"} - 执行 GET 操作查询状态
- 若 mode 返回
OFF,说明设备未设置密码/未创建儿童账户,提示用户:"请先在智慧屏设备上设置密码并创建儿童账户"
关闭未成年人模式锁
- 执行 GET 操作查询当前状态
- 若 mode 为
OFF,不允许操作,告知用户当前未成年人模式未开启 - 若 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返回空字符串,无法判断 |
| 其他未在支持清单中列出的操作 | 均不支持 |
使用流程
- 使用
get_devices_info获取设备列表,通过devType='09C'找到智慧屏 - 使用
get_device_detail获取智慧屏的详细信息(可选) - 使用本技能提供的
sid和参数,通过control_device执行控制 - 参考技能说明回复用户