方案概述

搭配生活物聯網平臺提供的公版App，燈的解決方案提供以下基本功能。

• 白燈的亮度和色溫調節
• 彩燈的顏色、亮度和飽和度調節
• 智能場景，支持白光常亮、白光閃爍、白光漸變、彩光常亮、彩光閃爍、彩光漸變6種場景模式
• 定時，支持云端定時或本地定時

根據設備類型不同展示不同的界面。

• 一路燈
• 兩路燈
• 三路燈
• 四路燈
• 五路燈

在控制臺開發產品

1. 登錄生活物聯網控制臺。
2. 創建一個產品，并定義產品功能。
   建議您添加以下燈的標準功能，操作請參見創建產品并定義功能。

   功能名稱	標識符	數據類型	是否必選	功能描述
   開關	powerstate	布爾型	是	燈開關
   HSV調色	HSVColor	復合型	否	3路燈、4路燈、5路燈必要屬性，JSON對象 色調：Hue 數據類型：整數型 取值范圍：0~360 步長：1 單位：度（°） 飽和度：Saturation 數據類型：整數型 取值范圍：0~100 步長：1 單位：百分比（%） 明度：Value 數據類型：整數型 取值范圍：0~100 步長：1 單位：百分比（%）
   明暗度	brightness	整數型	否	1路燈、2路燈、4路燈、5路燈必要屬性 取值范圍：0~100 單位：百分比（%） 步長：1
   色溫_開爾文	colorTemperatureInKelvin	整數型	否	2路燈、5路燈必要屬性 取值范圍：2000~7000 單位：開爾文（K） 步長：1
   本地定時	LocalTimer	數組型	否	元素類型：JSON數組
   燈模式	LightMode	枚舉型	否	取值：0 - mono（白光）；1 - color （彩光） 說明 支持兩種模式的燈需要此屬性，添加完頁面會出現白光、彩光兩種模式
   燈類型	LightType	枚舉型	否	當定義了燈類型以后，設備上電需要自己上報當前燈的類型，如沒有上報則以TSL為準 0：C 1：CW 2：RGB 3：RGBC 4：RGBCW
   燈場景（新增）	LightScene	復合型	否	JSON對象 燈模式：LightMode 數據類型：枚舉型 0 - mono（白光） 1 - color （彩光） 變色速度：ColorSpeed 數據類型：整數型 取值范圍：0~100 步長：1 單位：百分比（%） 場景模式：SceneMode 數據類型：枚舉型 0：常亮 1：閃爍 2：漸變 燈顏色：ColorArr 數據類型：字符型 數據長度：2048 明暗度：Brightness 數據類型：字符型 數據長度：2048 運行狀態：Enable 數據類型：布爾型 0：已停止 1：運行中 場景標識：SceneId 數據類型：字符型 數據長度：100 場景參數：SceneItems 數據類型：字符型 數據長度：2048
   心跳（新增）	Heartbeat	布爾型	否	0：停止 1：正常

   說明 當使用LightType屬性時，一定要配置以上的功能定義，否則可能會造成面板畫面顯示不正常。
3. 添加測試設備，參見添加設備。
4. 配置App的功能參數項，參見配置App。
   該解決方案默認使用本地定時功能，您還需要在人機交互頁面設置定時的功能屬性。

開發界面

由于燈的界面較復雜，請您根據以下燈的界面與設備功能之間的邏輯來開發設備。

• 白燈模式

  1路燈、2路燈、4路燈、5路燈支持此模式。

  • 當功能定義里定義了ColorTemperture，或者通過LightType設置了2路燈、5路燈時，白燈模式支持冷暖調節。
  • 白燈模式的亮度Brightness，設置為1~100。
  • 單擊白光按鈕時，依次下發當前燈光的模式LightMode=0，以及云端備份的Brightness和ColorTemputure（支持冷暖的燈會下發）。
• 彩燈模式

  3路燈、4路燈、5路燈支持此模式。

  • 單擊彩光按鈕時，依次下發燈光的模式LightMode=1以及云端存的HSVColor。
  • 彩光模式的色調為H（Hue）、飽和度為S（Saturation）、亮度為V（Value），各取值范圍如下。
    • Hue：0~360，與實際燈的是一一對應的
    • Saturation：0~100，與實際燈的是一一對應的
    • Value：1~100，因為實際調節燈的亮度不會變成0，所以在App上調節的范圍是1~100
  • 每次調節彩光的亮度、飽和度或色調時，都會下發對應的HSVColor。

開發燈場景

方案2.0的燈場景一共支持6種場景模式，分別為：白光常亮、白光閃爍、白光漸變、彩光常亮、彩光閃爍、彩光漸變。各路燈的支持情況如下。

請您根據以下操作開發燈的場景。

1. 登錄生活物聯網控制臺。
2. 預設場景。
   1. 進入產品的人機交互頁面。
   2. 打開公版App開關，單擊選擇產品面板處的未設置。
      
   3. 選擇X路燈（根據預置的lightType來選擇幾路燈），并單擊編輯。
      
   4. 配置燈界面。

      選擇燈場景，并單擊打開浮層。

      

      • 配置冷暖模式
      • 配置白光、彩光模式

      說明 速度調節為從0%（間隔6s）至100%（間隔1s），速度的步長為50ms。

      以彩光場景為例： 可以修改場景名稱，6種場景模式，以及場景參數等。不同模式以及1~5路燈所支持的配置不完全相同，支持參數如下。

      燈模式	支持的參數情況
      白光常亮	支持明暗度調節，如功能定義包含ColorTemperature則支持冷暖調節
      白光閃爍	支持速度調節，如功能定義包含ColorTemperature則支持冷暖調節，明亮度Brightness為0和100閃爍
      白光漸變	支持速度調節，如功能定義包含ColorTemperature則支持冷暖調節，明亮度Brightness為0~100漸變，漸變步長為1
      彩光常亮	僅支持選擇一種顏色
      彩光閃爍	支持速度調節，最多可選8種顏色，顏色順序切換
      彩光漸變	支持速度調節，最多可選8種顏色，顏色順序漸變，漸變規則為HSVColor中的Value從0~100漸變，再進入下一個顏色

      說明 當您開發同時支持多路燈產品時，如果您在開發產品時還不確定具體支持幾路燈，我們允許您添加在功能定義中支持的所有場景。如功能定義中，同時添加了Brightness、ColorTemperature、HSVColor、LightMode，滿足5路燈的屬性，則可以添加6種場景模式的任意一種。但是最終App用戶使用燈時不一定是5路燈，根據設備上報lightType動態決定是幾路燈，最終App側會根據lightType過濾掉設備不支持的場景。

      例如，同時預設了白光-閃爍和彩光-閃爍的場景。

      • App用戶在使用時，如果設備上報lightType=1即為2路燈，不支持彩光模式，則用戶僅能看到白光-閃爍的場景
      • App用戶在使用時，如果設備上報lightType=2即為3路燈，不支持白光模式，則用戶僅能看到彩光-閃爍的場景
3. 實現燈場景。
   新的燈場景的實現依賴LightScene和HeartbeatStatus屬性（屬性介紹參見功能定義頁面）。
   1. 用戶選擇場景時，云端下發數據。
      • 白光場景

        {
          "LightScene": {
            "LightMode": 0,
            "ColorSpeed": 100,
            "SceneMode": 1,
            "ColorArr": "[]",
            "Brightness": "{"min":0,"max":100}",
            "Enable": 1,
            "SceneItems": "{"ColorTemperature":4445,"Brightness":100}",
            "SceneId": "B_5"
          }
        }

      • 彩光場景

        {
          "LightScene": {
            "LightMode": 1,
            "ColorSpeed": 100,
            "SceneMode": 1,
            "ColorArr": "[]",
            "Brightness": "{}",
            "Enable": 1,
            "SceneItems": "{}",
            "SceneId": "B_5"
          }
        }

        其中ColorArr值為JSON字符串，內容如下，注意有些平臺雙引號需要轉義{"Hue":6,"Saturation":99,"Value":98},{"Hue":121,"Saturation":96,"Value":97},{"Hue":286,"Saturation":63,"Value":85}
   2. 設備收到LightScene后，根據LightScene中的參數LightMode和SceneMode來判斷當前是哪一種場景模式，執行不同的邏輯。
      

      六種模式對應的設備執行邏輯如下。

      燈模式	設備端執行邏輯
      白光常亮	上報LightScene，常規屬性設置動作，屬性上報 調整LightMode=0，獲取SceneItems中的Brightness、ColorTemperature 上報 LightMode、Brightness、ColorTemperature（1路燈和4路燈無ColorTemperature）
      白光閃爍	上報LightScene，常規屬性設置動作，屬性上報 調整LightMode=0，ColorTemperature為SceneItems中的值 上報 LightMode、ColorTemperature 根據ColorSpeed定時改變Brightness為0與100（閃爍），并上報Brightness
      白光漸變	上報LightScene，常規屬性設置動作，屬性上報 調整LightMode=0，ColorTemperature為SceneItems中的值 上報LightMode、ColorTemperature 根據ColorSpeed 定時改變Brightness為0~100（漸變），步長為1，并上報Brightness
      彩光常亮	上報LightScene，常規屬性設置動作，屬性上報 調整LightMode=1，HSVColor為ColorArr中的第一個顏色值 上報LightMode、HSVColor
      彩光閃爍	上報LightScene，常規屬性設置動作，屬性上報 調整LightMode=1 上報LightMode 根據ColorSpeed定時改變HSVColor并上報；每次從ColorArr中順序取下一個顏色值，且循環取值
      彩光漸變	上報LightScene，常規屬性設置動作，屬性上報 調整LightMode=1 上報LightMode 根據ColorSpeed 定時改變HSVColor 并上報；每次從ColorArr中順序取下一個顏色值，取出顏色值后對HSVColor的Value值進行0至100漸變。Value達到100后，取下一個顏色值，Value繼續從0至100取值

4. 調試燈場景。
   公版App最多支持10個場景，您最多預設5個場景，剩余的為App用戶自定義場景。請您根據業務邏輯來調試預設的場景，并根據以下操作調試App用戶自定義的場景（以5路燈為例）。
   1. 登錄公版App。
   2. 單擊智能，并選擇場景頁簽。
      此時會彈出浮層，看到支持場景的列表，分為兩部分：預設場景和用戶自定義場景。預設場景用戶不可編輯。
   3. 單擊右上角的加號（+）來新增場景。
      App用戶可以新增常亮、閃爍、漸變等場景，以及最多添加8種顏色。此時設置的參數與生活物聯網平臺的控制臺可設置的參數相同，區別在于自定義用戶場景無法切換白光模式與彩光模式。 而是根據1~5路燈適配（1~2路燈僅能設置白光場景；3~5路燈僅設置彩光場景）。App用戶可以通過設置白色的場景來實現白光場景的效果。

開發音樂律動場景

音樂律動功能開啟后，可在App上使用律動功能，隨著手機麥克風接收的音樂節奏，變換燈的顏色和閃爍頻率，需配合設備端開發，實現TSL對律動服務的接收。使用音樂律動功能時，務必要保證手機和設備處于同一個Wi-Fi網絡下。

請您根據以下操作開發音樂律動的場景。

1. 登錄生活物聯網控制臺。
2. 創建產品并定義產品功能。
   您需要新增一個名為Rhythm的服務，詳細操作請參見創建產品并定義功能。
3. 預設場景。
   1. 進入人機交互頁面。
      
   2. 選擇X路燈（根據預置的lightType來選擇幾路燈），并單擊編輯。
      

      說明 音樂律動功能僅支持3~5路燈彩燈模式。
   3. 單擊律動頁面 > 律動場景組件， 并打開浮層。
      

      在浮層中您可以看到官方推薦的幾種律動場景，即我們在不同音樂模式下反復驗證效果較好的場景，建議您可以直接使用。

      • 默認場景（不支持編輯和刪除）
      • 暖色
      • 冷色
      • 多彩
   4. （可選）選擇除默認場景外的一個場景模式，單擊鉛筆圖標編輯律動場景。
      

      參數名稱	描述
      場景名稱	場景名稱支持多語言的文案
      單設備模式	支持默認（閃爍）、漸變、跳變三種模式
      多設備模式	支持推薦、脈沖、同頻三種模式，多設備組控時，不同設備可以按不同顏色順序變化
      顏色	最多支持添加8種顏色

4. 調試音樂律動場景。
   公版App最多支持10個場景，您最多預設5個場景，剩余為App用戶自定義場景。請您根據業務邏輯來調試預設的場景，并根據以下操作調試App用戶自定義的場景（以5路燈為例）。
   1. 登錄公版App。
   2. 單擊智能，并選擇場景頁簽。
      此時會彈出浮層，看到支持場景的列表，分為兩部分：預設場景和用戶自定義場景。預設場景用戶不可編輯。
   3. 單擊加號（+）新增場景。
      App用戶可以新增默認（閃爍）、漸變、跳變模式的場景，最多添加8種顏色，和控制臺可設置的參數相同。
   4. 預覽效果。
      

開發定時功能

方案2.0默認使用云端定時功能。App用戶設置定時任務后，由云端保存該定時任務，并在時間到達時，給設備發送執行指令。

使用云端定時，設備端不需要任何改動便可以支持。