# 屏幕控制

消息类型 名称 必须实现
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