# 屏幕控制
消息类型 | 名称 | 必须实现 |
---|---|---|
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 | 是 |