# 屏幕控制
| 消息类型 | 名称 | 必须实现 |
|---|---|---|
| response | set_state | 否,有屏设备必须实现 |
| set_brightness | 否,有屏设备必须实现 |
# context
"iflyos_context": {
...
"screen": {
"version": "1.2",
"state": "ON",
"brightness": 78,
"type": "percent"
},
...
}
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
| version | String | 模块版本,现在是1.2 | 是 |
| state | String | 屏幕开关状态,取值:ON,OFF | 是 |
| brightness | Long | 亮度数值 | 是 |
| type | String | 亮度类型,取值:percent | 是 |
版本说明
| 版本 | 说明 | 更新日期 |
|---|---|---|
| 1.0 | 基础实现 | 2019-07-01 |
| 1.1 | 修改设备能力范围 | 2019-08-13 |
| 1.2 | 增加亮度调整相关的能力 | 2019-08-28 |
# response
说明
如果你的设备可以触控调节屏幕亮度,设备屏幕亮度变动时,需发送设备状态同步(system.state_sync)请求。
# 打开关闭屏幕
当用户请求打开/关闭屏幕时,你会收到云端返回的response,你需要根据设备本身的情况,对该返回进行合适的处理。如:若你的设备不支持息屏,你可以选择显示一个息屏的页面。
{
"iflyos_responses": [
...,
{
"header": {
"name": "screen.set_state"
},
"payload": {
"state": "OFF",//可取值:ON 和 OFF
}
}
]
}
| 参数 | 类型 | 说明 | 必有 |
|---|---|---|---|
| state | String | 将屏幕设置为开/关状态,取值:ON,OFF | 是 |
# 调整屏幕亮度
提示
若你的设备的亮度是绝对值(即最大亮度不是100),你的设备可能会收到以百分比为单位的亮度。此时你需要将云端返回的百分比数值进行计算。对应到设备本身使用的绝对数值。
{
"iflyos_responses": [
...,
{
"header": {
"name": "screen.set_brightness"
},
"payload": {
"brightness": 79,
"type": "percent"
}
}
]
}
| 参数 | 类型 | 说明 | 必有 |
|---|---|---|---|
| brightness | Long | 亮度数值 | 是 |
| type | String | 亮度类型,取值:percent | 是 |