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