萬能紅外遙控器

一、萬能紅外整體介紹：

萬能紅外：萬能紅外遙控器，也稱萬能紅外網(wǎng)關(guān)，可替代國內(nèi)外 99% 主流品牌紅外遙控器，支持 DIY 學(xué)習(xí)功能。可以讓家里的傳統(tǒng)家電快速接入互聯(lián)網(wǎng)，支持手機端控制，場景聯(lián)動等各種豐富的功能。有關(guān)產(chǎn)品介紹和相關(guān)參數(shù)，請訪問 萬能紅外遙控器。

其中場景類型包括：普通遙控器控制、機頂盒遙控器控制、空調(diào)遙控器，另外還有通用接口、紅外碼學(xué)習(xí)、紅外碼智能匹配、紅外定時任務(wù)等等。

二、場景類接口列表：

普通遙控器控制

用于控制電視和風(fēng)扇的遙控器類型。此場景只是推薦的紅外流程，可以根據(jù)各自不同的需要，基于已開放的接口開發(fā)并豐富各自的業(yè)務(wù)流程場景。

操作流程如下：

首先可以獲取當(dāng)前云云對接支持的紅外設(shè)備類型；當(dāng)前支持電視、機頂盒、空調(diào)和風(fēng)扇類型；API(1)：API文檔——獲取紅外支持的設(shè)備類型

根據(jù)想要控制的設(shè)備類型，選擇一個類型獲取支持的設(shè)備類型的品牌；API(2)：API文檔——獲取指定類型品牌列表

選擇指定的品牌獲取云云對接中預(yù)設(shè)的公版遙控器紅外碼庫索引；API(3)：API文檔——獲取品牌支持遙控器索引列表

一個品牌可能會有多個不同的遙控器紅外碼庫索引，這時需要試用是否合適需要控制的紅外設(shè)備，一般建議至少測試三個按鍵有效后再確認添加遙控器；API(4)：API文檔——控制遙控器：測試場景按鍵（基于通用標準按鍵）

確認可用的遙控器紅外碼庫索引后，使用此索引綁定普通遙控器到萬能紅外遙控器設(shè)備上；API(7)：API文檔——添加普通遙控器

使用普通遙控器，基于標準紅外指令控制設(shè)備，標準指令參考；API(8)：API文檔——控制遙控器：已添加遙控器（基于通用標準按鍵）

API列表：

獲取紅外支持的設(shè)備類型：獲取紅外設(shè)備支持的設(shè)備類型，目前支持電視，機頂盒，空調(diào)，風(fēng)扇等。

獲取指定類型品牌列表：按遙控器類型獲取品牌列表,支持電視和空調(diào)。

獲取品牌支持遙控器索引列表：根據(jù)品牌 id獲取指定品牌下所有型號的遙控器索引列表。

添加普通遙控器：添加一款指定型號的遙控器，形成一個實例化的虛擬遙控器。

機頂盒遙控器控制

機頂盒設(shè)備支持 IPTV 和非 IPTV 。此場景只是推薦的紅外流程，可以根據(jù)各自不同的需要，基于已開放的接口開發(fā)并豐富各自的業(yè)務(wù)流程場景。

操作流程：

首先獲取支持的紅外設(shè)備類型；API(1)：API文檔——獲取紅外支持的設(shè)備類型

選擇相應(yīng)的地址；

API(2)：API文檔——獲取省份列表

API(3)：API文檔——獲取城市列表

API(4)：API文檔——獲取區(qū)域列表

根據(jù)所在的區(qū)域，獲取指定區(qū)域支持的運營商信息列表；API(5)：API文檔——獲取運營商列表：根據(jù)區(qū)域

根據(jù)選擇的運營商，獲取支持的設(shè)備品牌；API(6)：API文檔——獲取品牌列表：根據(jù)運營商

選擇指定的品牌獲取云云對接中預(yù)設(shè)的公版遙控器紅外碼庫索引；

API(7)：API文檔——獲取遙控器索引列表：根據(jù)品牌

API(8)：API文檔——獲取遙控器索引列表：根據(jù)區(qū)域

一個品牌可能會有多個不同的遙控器紅外碼庫索引，這時需要試用是否合適需要控制的紅外設(shè)備，一般建議至少測試三個按鍵有效后再確認添加遙控器；API(9)：API文檔——控制遙控器：測試場景按鍵（基于通用標準按鍵）

確認可用的遙控器紅外碼庫索引后（即某型號遙控器可用），使用此索引綁定機頂盒遙控器到萬能紅外遙控器設(shè)備上；API(12)：API文檔——添加機頂盒遙控器

使用剛才添加的遙控器，基于標準紅外指令控制設(shè)備，標準指令參考；API(13)：API文檔——控制遙控器：已添加遙控器（基于通用標準按鍵）

API列表：

獲取省份列表：獲取省份列表。

獲取城市列表：根據(jù)省份ID獲取城市列表。

獲取區(qū)域列表：根據(jù)省份ID和城市ID獲取區(qū)域列表。

根據(jù)區(qū)域獲取運營商列表：針對于機頂盒類型設(shè)備，可獲取指定區(qū)域支持的 IPTV s列表。

根據(jù)運營商獲取品牌列表：針對機頂盒設(shè)備，根據(jù)運營商支持的品牌列表。

根據(jù)品牌/區(qū)域獲取遙控器索引列表：根據(jù)類型 ID/區(qū)域ID 獲取支持IPTV運營商的遙控器索引。

添加機頂盒遙控器：添加機頂盒遙控器。

查詢電視頻道列表：根據(jù)遙控器ID查詢頻道列表。

切換電視頻道：切換電視片頻道

空調(diào)遙控器控制

此場景只是推薦的紅外流程，可以根據(jù)各自不同的需要，基于已開放的接口開發(fā)并豐富各自的業(yè)務(wù)流程場景。。

操作流程：

獲取支持的紅外空調(diào)設(shè)備的品牌；API(1)：API文檔——獲取指定類型品牌列表

選擇指定的品牌獲取遙控器紅外碼庫索引；API(2)：API文檔——獲取品牌支持遙控器索引列表

一個品牌可能會有多個不同的遙控器紅外碼庫索引，這時需要試用是否合適需要控制的紅外設(shè)備，一般建議至少測試三個按鍵有效后再確認添加遙控器；API(3)：API文檔——測試空調(diào)遙控器

確認可用的遙控器紅外碼庫索引后，使用此索引綁定空調(diào)遙控器到萬能紅外遙控器設(shè)備上；API(4)：API文檔——添加普通遙控器

使用普通遙控器，基于標準紅外指令控制設(shè)備；標準指令參考：API文檔——控制遙控器：已添加遙控器（基于通用標準按鍵）

或者空調(diào)專有指令控制設(shè)備；API(5)：API文檔——控制空調(diào)遙控器

部分業(yè)務(wù)場景存在直接控制空調(diào)相關(guān)參數(shù)的情況，調(diào)用多條件的空調(diào)指令直接控制空調(diào)的相關(guān)參數(shù)，但請注意并不是所有的組合條件都可以支持直接下發(fā)紅外碼；API(6)：API文檔——多條件控制空調(diào)

空調(diào)類遙控器只支持API文檔中描述的標準指令，不支持非標準指令。

API列表

測試空調(diào)遙控器：用于在測試空調(diào)遙控器是否匹配空調(diào)設(shè)備時，根據(jù)遙控器索引下發(fā)單個的空調(diào)遙控器按鍵指令。

控制空調(diào)遙控器：下發(fā)單個的空調(diào)遙控器按鍵指令。

多條件控制空調(diào)：多條件的空調(diào)指令下發(fā)，用于在部分聯(lián)動場景下對空調(diào)的控制。

查詢空調(diào)狀態(tài)：查詢空調(diào)狀態(tài)。

三、其他接口列表：

通用接口API列表：

獲取紅外設(shè)備下面綁定的遙控器列表：根據(jù)紅外設(shè)備 ID 來獲取紅外設(shè)備下面綁定的遙控器列表。

添加/刪除/設(shè)置遙控器：此接口可以兼容機頂盒、電視、空調(diào)等類型設(shè)備的遙控器添加/刪除/設(shè)置。

獲取遙控器配對規(guī)則：根據(jù)遙控器 ID 獲取配對規(guī)則，獲取到key用于紅外碼下發(fā)。

控制遙控器：測試場景按鍵（基于通用標準按鍵）：在測試遙控器是否匹配設(shè)備時使用。使用通用標準key控制，標準key見附錄。支持空調(diào)的標準指令下發(fā)。

控制遙控器：測試場景按鍵（基于配對規(guī)則）：在測試遙控器是否匹配設(shè)備時使用。根據(jù)key來下發(fā)紅外碼，請求參數(shù)中的key是從獲取配對規(guī)則中獲得key。非

標準指令不支持空調(diào)，空調(diào)使用專有的指令下發(fā)。

控制遙控器：已添加遙控器（基于配對規(guī)則）：控制已綁定的遙控器下發(fā)指令，根據(jù)raw_key來下發(fā)紅外碼，請求參數(shù)中的raw_key是從獲取配對規(guī)則中獲得

key，目前這個接口只支持電視和機頂盒，空調(diào)使用專有的指令下發(fā)。

獲取遙控器支持的按鍵列表：可查詢指定遙控器支持的按鍵列表，同時返回可支持的標準key和非標準key。

獲取空調(diào)遙控器支持的按鍵規(guī)則列表：僅查詢指定空調(diào)類的遙控器支持的按鍵列表，同時返回可支持的標準key和非標準key，同時返回支持的按鍵范圍。

紅外碼學(xué)習(xí)API列表

開啟學(xué)習(xí)狀態(tài)后，再使用真實的遙控器對準萬能紅外設(shè)備按下需要學(xué)習(xí)的按鍵，然后再使用查詢學(xué)習(xí)到的學(xué)習(xí)碼的API獲取學(xué)習(xí)到的學(xué)習(xí)碼。

更新學(xué)習(xí)狀態(tài)：進入學(xué)習(xí)狀態(tài)

查詢學(xué)習(xí)到的紅外碼：獲取學(xué)習(xí)到的紅外碼。傳入的參數(shù)建議直接使用更新學(xué)習(xí)狀態(tài)時返回的時間戳t。

下發(fā)/更新/刪除學(xué)習(xí)到的紅外碼：下發(fā)/更新/刪除學(xué)習(xí)到的紅外碼。

保存學(xué)習(xí)到的紅外碼：保存學(xué)習(xí)到的紅外碼，生成遙控器id

獲取保存的學(xué)習(xí)紅外碼：獲取保存的學(xué)習(xí)紅外碼

紅外碼智能匹配API列表

部分品牌下的預(yù)設(shè)的遙控器紅外碼庫索引可能比較多，有時候為了嘗試出某個索引是否支持需要控制的設(shè)備，可能需要測試多次，造成匹配成功一個遙控器需要耗費大量的時間和精力。 因此提供紅外碼智能匹配功能，可以根據(jù)學(xué)習(xí)到的紅外碼來快速匹配遙控器紅外碼庫索引。

前提是需要提供真實的遙控器進行學(xué)習(xí)匹配。

操作流程：

開啟紅外網(wǎng)關(guān)學(xué)習(xí)狀態(tài)；API文檔——更新學(xué)習(xí)狀態(tài)

用戶使用遙控器對準紅外網(wǎng)關(guān)發(fā)送紅外碼；

獲取紅外網(wǎng)關(guān)學(xué)習(xí)到的學(xué)習(xí)碼； API文檔——查詢學(xué)習(xí)到的紅外碼

使用學(xué)習(xí)到的 學(xué)習(xí)碼 請求智能匹配，返回 智能匹配token； API文檔——生成智能匹配令牌

使用 智能匹配token 請求匹配列表；API文檔——獲取智能匹配遙控器列表

用戶在返回的匹配列表中依次查看遙控器索引信息； API文檔——獲取遙控器索引支持的品牌信息

循環(huán)嘗試匹配列表的遙控器索引中的按鍵；

API文檔——控制遙控器：測試場景按鍵（基于通用標準按鍵）

API文檔——測試空調(diào)遙控器

如果找到合適的，則確認遙控器，結(jié)束此次智能匹配動作；否則繼續(xù)后續(xù)步驟；API文檔——添加遙控器

如果未找到合適的，則繼續(xù)使用 智能匹配token 請求匹配列表，進行步驟5的操作，這里就是在有多個匹配結(jié)果的時候，進行的分頁處理，如果只有1頁，則不需要再進行步驟5的操作；

如果接口返回?zé)o數(shù)據(jù)，則匹配列表結(jié)束；

如果需要進一步縮小匹配范圍，則可以再次開啟紅外網(wǎng)關(guān)學(xué)習(xí)狀態(tài)，下發(fā)新的學(xué)習(xí)碼，然后獲取新的 智能匹配token （步驟1、2、3、4）；

然后使用新的 智能匹配token 同時帶上步驟5中的舊的 智能匹配token 一起請求匹配列表，系統(tǒng)則會在使用步驟3學(xué)習(xí)到的紅外碼匹配的基礎(chǔ)上，再使用步驟11獲取的紅外碼進一步縮小匹配范圍；

然后再重復(fù)步驟6、7、8、9、10、11，直到找到合適的遙控器索引，或者未匹配到。

API列表：

生產(chǎn)智能匹配令牌：使用紅外網(wǎng)關(guān)學(xué)習(xí)到的紅外碼，生成智能匹配令牌token，用于后續(xù)分頁查詢智能匹配結(jié)果。

獲取智能匹配遙控器列表：使用生成的智能匹配令牌token，分頁查詢智能匹配結(jié)果列表。

獲取遙控器索引支持的品牌信息：查詢指定遙控器索引支持的品牌的信息。

紅外定時任務(wù)API列表

添加紅外定時任務(wù)：添加一個紅外定時任務(wù)。

獲取/更新/刪除紅外定時任務(wù)：查詢/更新/刪除紅外定時任務(wù)。

刪除所有定時任務(wù)：刪除所有定時任務(wù)。

更新紅外分組定時狀態(tài)：更新紅外分組定時狀態(tài)。

以上所有所有接口地址可在此處查詢>>>涂鴉云平臺接口列表

API

版權(quán)聲明：本文內(nèi)容由網(wǎng)絡(luò)用戶投稿，版權(quán)歸原作者所有，本站不擁有其著作權(quán)，亦不承擔(dān)相應(yīng)法律責(zé)任。如果您發(fā)現(xiàn)本站中有涉嫌抄襲或描述失實的內(nèi)容，請聯(lián)系我們jiasou666@gmail.com 處理，核實后本網(wǎng)站將在24小時內(nèi)刪除侵權(quán)內(nèi)容。

版權(quán)聲明：本文內(nèi)容由網(wǎng)絡(luò)用戶投稿，版權(quán)歸原作者所有，本站不擁有其著作權(quán)，亦不承擔(dān)相應(yīng)法律責(zé)任。如果您發(fā)現(xiàn)本站中有涉嫌抄襲或描述失實的內(nèi)容，請聯(lián)系我們jiasou666@gmail.com 處理，核實后本網(wǎng)站將在24小時內(nèi)刪除侵權(quán)內(nèi)容。