前言

最近接觸了微信小程序 API - wx.setScreenBrightness 、wx.getScreenBrightness 接口，調(diào)用該接口可以調(diào)節(jié)并顯示手機(jī)屏幕亮度數(shù)據(jù)。對(duì)于喜歡騰訊新聞、今日頭條等一些閱讀類(lèi)小程序的小伙伴，還是挺友好的。不需要下拉屏幕或退出小程序頁(yè)面就可以調(diào)整屏幕亮度，直接在小程序內(nèi)部完成屏幕亮度調(diào)節(jié)工作，更加快速。下面，就分享一下如何使用該微信小程序API接口以及需注意的問(wèn)題。

好！下面進(jìn)入正文。首先，打開(kāi)微信開(kāi)發(fā)者工具，添加小程序項(xiàng)目，選擇一個(gè)本地新建的空白小程序文件即可，APPid根據(jù)情況填寫(xiě)。完成（工具會(huì)自動(dòng)生成小程序必要一些的文件）。本次刪除了logs/until頁(yè)面，直接在index頁(yè)面上開(kāi)發(fā)了

第一步，打開(kāi) app.json 文件（全局控制，決定頁(yè)面文件的路徑、窗口表現(xiàn)），檢查是否寫(xiě)入pages/index/index，否則無(wú)法訪問(wèn)index頁(yè)面。接著配置navigation的相關(guān)參數(shù)，控制窗口頂部相關(guān)樣式信息，如backgroundcolor（背景）、textstyle（文本顏色）等

源碼參考：

//app.json
{
  "pages": [
    "pages/index/index"
  ],
  "window": {
    "navigationBarBackgroundColor": "#000000",
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "調(diào)節(jié)屏幕亮度",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light",
    "enablePullDownRefresh": false
  }
}

第二步，打開(kāi)index的js文件，在page下定義changeScreenLight對(duì)象，并同時(shí)在.wxml文件中設(shè)置參數(shù)，傳遞changeScreenLight下相關(guān)事件函數(shù)處理的值。接著開(kāi)始配置wx.setScreenBrightness 以及 wx.getScreenBrightness兩個(gè)事件函數(shù)！

1）wx.setScreenBrightness 即獲得屏幕亮度值，用value參數(shù)來(lái)寫(xiě)入，這里還使用了parseFloat、toFixed兩個(gè)函數(shù)來(lái)界定value的取值。為了把獲得的value值回調(diào)至下個(gè)事件函數(shù)wx.getScreenBrightnes的ScreenBrightnes中，這里借助var that = this 來(lái)處理，即把這個(gè)this事件的值復(fù)制一份到that，在下個(gè)事件函數(shù)中，用that.setDatal來(lái)回調(diào)數(shù)值。

2）wx.getScreenBrightness 即給屏幕亮度賦值，通過(guò)success參數(shù)(成功調(diào)用)的res屬性來(lái)傳遞這個(gè)事件函數(shù)，接著使用that.setData回調(diào)數(shù)值，而其中的ScreenBrightness：res.value即res第一個(gè)事件函數(shù)中的value值啦!

源碼參考：

//index.js
Page({
  data:{
  },
  changeScreenLight:function(e){
    var that = this;
    //滑動(dòng)拉桿獲得值
    wx.setScreenBrightness({
      value: parseFloat(e.detail.value).toFixed(1)
    })
    //給屏幕亮度賦值
    wx.getScreenBrightness({
      success: function(res) {
        that.setData({
          ScreenBrightness: res.value
        })
      }
    })
  }
})

第三步，配置index.wxml文件。index.wxml文件的配置和.js文件是有關(guān)聯(lián)性的。這里在.wxml用slider做了一個(gè)滑桿，通過(guò)min、max、step控制滑桿的最小值、最大值以及每滑動(dòng)一單位時(shí)的增量，最后通過(guò)bindchange="changeScreenLight"，來(lái)傳遞.js文件中changeScreenLight相關(guān)事件函數(shù)的處理結(jié)果。{{ScreenBrightness}}參數(shù)則是傳遞了.js文件中的value值。 
源碼參考：

<slider min="0" max="1" step="0.1"bindchange="changeScreenLight"/>
<view>屏幕亮度：{{ScreenBrightness}}</view>

總結(jié)：getScreenBrightness 接口若安卓系統(tǒng)設(shè)置中開(kāi)啟了自動(dòng)調(diào)節(jié)亮度功能，則屏幕亮度會(huì)根據(jù)光線自動(dòng)調(diào)整，該接口僅能獲取自動(dòng)調(diào)節(jié)亮度之前的值，而非實(shí)時(shí)的亮度值。