OSRAM Sylvania最近宣布將為開發者社區提供開放的Lightify REST API,開發者可將其集成于自己的iOS和Android應用,以及網站中Lightify是一種涵蓋硬件、云,以及移動設備的物聯網(IoT)體系,通過OSRAM的iOS和Android免費應用,可以使用移動服務控制Lightify LED燈泡的燈光。
例如,最近有人使用Lightify為歐洲歌唱大賽(Eurovision Song Contest)增色添彩:瑞典斯德哥爾摩的七座地標式建筑通過不同色彩體現電視觀眾對歌唱大賽中不同歌曲的喜好程度。其中一些地標建筑的燈光甚至通過視頻進行了在線直播。
Lightify API最初只包含在供用戶免費使用的OSRAM應用中,不同地區用戶可通過下列兩個鏈接獲?。篽ttps://eu.lightify-api.org(適合位于歐洲或周邊地區的用戶),以及https://us.lightify-api.org(適合位于美國、加拿大和澳大利亞或周邊地區的用戶)。需要說明的是,下文有關Lightify API的所有介紹信息全部基于后者。
Lightify API網站提供了下列內容:
Home API細節 范例應用 用戶指南Home API細節提供了指向LIGHTIFY API (REST)文檔的鏈接,其中列出了可用資源(API端點和方法)以及數據類型(JSON)。
點擊范例應用鏈接將顯示2.0版Apache License許可。拖到頁面底部點擊“我同意”按鈕后,網站會感謝您接受許可協議,隨后便可下載軟件。范例應用軟件提供了三種格式(均可以Zip文件的形式下載):
Windows(EXE):Windows應用程序LightifyApp-1.0.0.exe,運行后可啟動Java(如果Java版本太老則需升級)并運行范例應用。 JAR:Java歸檔文件LightifyApp-1.0.0.jar,如果想自行開發Lightify應用或網站,可從這個文件入手學習。 源代碼:LightifyHomeApp-Src-1.0.zip文件,解壓縮后可獲得LightifyApp子目錄,該目錄中包含一個src子目錄,以及OSRAMlicense.txt、pom.xml和userconfig.yaml三個文件。用戶指南鏈接可以打開一個五頁長度的PDF文件《LIGHTIFY Home:云REST API上手指南》,該文檔提供了有關Lightify API的更多細節,以及調用和結果范例與“常用命令”。
如果打算自行開發Lightify應用程序,可以首先從OSRAM許可(文件OSRAMlicense.txt)著手。該文檔包含了《LIGHTIFY Home:云REST API使用條款》,同意條款后即可使用Lightify API。開發者需要重點查閱的內容位于“I. 許可授予和使用策略”一節:
在開發您自己的應用時,為將不必要的網絡流量降至最低,請盡量減少輪詢的使用,例如,請確保:(i)您的應用只在用戶使用應用的過程中進行輪詢,(ii)如果用戶最大閑置時間超過十五(15)分鐘,輪詢將被斷開,以及(iii)您的應用針對每個網關執行輪詢的平均頻率不應超過每三(3)秒一次。
開發者可以在新應用程序中免費使用Lightify API,由于所有Lightify應用都將免費訪問OSRAM的Lightify云,只有在新應用對API的使用能進行自我調節限流(Self-imposed throttling)的情況下,開發者才能使用這一開放式API。這種調節適用于您應用的某一具體用戶:他們下載的應用必須包含所需的調節限流機制。目前對于您應用的所有用戶產生的Lightify云累加用量尚不進行限制。
查看英文原文:OSRAM Sylvania Opens Lightify REST API to Developers