基础库 1.79.0 开始支持本方法，这是一个异步方法。

获取屏幕亮度。

前提条件	无
业务背景	无
使用限制	无
注意事项	在没有设置小游戏屏幕亮度的情况下，默认获取系统屏幕亮度
相关教程	无

语法

tt.getScreenBrightness(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	必填	说明	最低支持版本
success	function	否	接口调用成功的回调函数	1.79.0
fail	function	否	接口调用失败的回调函数	1.79.0
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）	1.79.0

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
value	number	屏幕亮度值，范围 0 ～ 1。（0 最暗，1 最亮）	1.79.0
errMsg	string	"getScreenBrightness:ok"	1.79.0

回调失败

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"getScreenBrightness:fail" + 详细错误信息	1.79.0

错误码

errNo	errMsg	说明	最低支持版本
10401	Failed to get screen brightness.	小游戏框架内部错误，有需要请创建工单咨询	1.79.0
20000	internal error	小游戏框架内部错误，有需要请创建工单咨询	1.79.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.getScreenBrightness({
  success: (res) => {
    console.log("getScreenBrightness success", res);
  },
  fail: (res) => {
    console.log("getScreenBrightness fail", res);
  },
});