前序系列文章>>>
【涂鴉物聯網足跡】涂鴉云平臺介面串列
我們系列文章，都會圍繞如何完成一款智能“隔空接吻機”的開發，希望能幫到各異地戀or異國戀的情侶們！
本文我們會大概講解API介面串列中的垂直品類之一的萬能紅外遙控器~
目前涂鴉云開發平臺除了提供了共12個基礎的介面串列（見上一篇文章）， 還提供5個垂直品類的介面，所謂的“垂直品類”，就是基于場景化的介面啦~我們接下來一一介紹一下吧~
一、萬能紅外整體介紹：
萬能紅外：萬能紅外遙控器，也稱萬能紅外網關，可替代國內外 99% 主流品牌紅外遙控器，支持 DIY 學習功能，可以讓家里的傳統家電快速接入互聯網，支持手機端控制，場景聯動等各種豐富的功能，有關產品介紹和相關引數，請訪問 萬能紅外遙控器，
其中場景型別包括：普通遙控器控制、機頂盒遙控器控制、空調遙控器，另外還有通用介面、紅外碼學習、紅外碼智能匹配、紅外定時任務等等，
二、場景類介面串列：
普通遙控器控制
用于控制電視和風扇的遙控器型別，此場景只是推薦的紅外流程，可以根據各自不同的需要，基于已開放的介面開發并豐富各自的業務流程場景，
操作流程如下：
- 首先可以獲取當前云云對接支持的紅外設備型別；當前支持電視、機頂盒、空調和風扇型別；API(1)：API檔案——獲取紅外支持的設備型別
- 根據想要控制的設備型別，選擇一個型別獲取支持的設備型別的品牌；API(2)：API檔案——獲取指定型別品牌串列
- 選擇指定的品牌獲取云云對接中預設的公版遙控器紅外碼庫索引；API(3)：API檔案——獲取品牌支持遙控器索引串列
- 一個品牌可能會有多個不同的遙控器紅外碼庫索引，這時需要試用是否合適需要控制的紅外設備，一般建議至少測驗三個按鍵有效后再確認添加遙控器；API(4)：API檔案——控制遙控器：測驗場景按鍵（基于通用標準按鍵）
- 確認可用的遙控器紅外碼庫索引后，使用此索引系結普通遙控器到萬能紅外遙控器設備上；API(7)：API檔案——添加普通遙控器
- 使用普通遙控器，基于標準紅外指令控制設備，標準指令參考；API(8)：API檔案——控制遙控器：已添加遙控器（基于通用標準按鍵）
API串列：
- 獲取紅外支持的設備型別：獲取紅外設備支持的設備型別，目前支持電視，機頂盒，空調，風扇等，
- 獲取指定型別品牌串列：按遙控器型別獲取品牌串列,支持電視和空調，
- 獲取品牌支持遙控器索引串列：根據品牌 id獲取指定品牌下所有型號的遙控器索引串列，
- 添加普通遙控器：添加一款指定型號的遙控器，形成一個實體化的虛擬遙控器，
機頂盒遙控器控制
機頂盒設備支持 IPTV 和非 IPTV ，此場景只是推薦的紅外流程，可以根據各自不同的需要，基于已開放的介面開發并豐富各自的業務流程場景，
操作流程：
- 首先獲取支持的紅外設備型別；API(1)：API檔案——獲取紅外支持的設備型別
- 選擇相應的地址；
API(2)：API檔案——獲取省份串列
API(3)：API檔案——獲取城市串列
API(4)：API檔案——獲取區域串列
- 根據所在的區域，獲取指定區域支持的運營商資訊串列；API(5)：API檔案——獲取運營商串列：根據區域
- 根據選擇的運營商，獲取支持的設備品牌；API(6)：API檔案——獲取品牌串列：根據運營商
- 選擇指定的品牌獲取云云對接中預設的公版遙控器紅外碼庫索引；
API(7)：API檔案——獲取遙控器索引串列：根據品牌
API(8)：API檔案——獲取遙控器索引串列：根據區域
- 一個品牌可能會有多個不同的遙控器紅外碼庫索引，這時需要試用是否合適需要控制的紅外設備，一般建議至少測驗三個按鍵有效后再確認添加遙控器；API(9)：API檔案——控制遙控器：測驗場景按鍵（基于通用標準按鍵）
- 確認可用的遙控器紅外碼庫索引后（即某型號遙控器可用），使用此索引系結機頂盒遙控器到萬能紅外遙控器設備上；API(12)：API檔案——添加機頂盒遙控器
- 使用剛才添加的遙控器，基于標準紅外指令控制設備，標準指令參考；API(13)：API檔案——控制遙控器：已添加遙控器（基于通用標準按鍵）
API串列：
- 獲取省份串列：獲取省份串列，
- 獲取城市串列：根據省份ID獲取城市串列，
- 獲取區域串列：根據省份ID和城市ID獲取區域串列，
- 根據區域獲取運營商串列：針對于機頂盒型別設備，可獲取指定區域支持的 IPTV s串列，
- 根據運營商獲取品牌串列：針對機頂盒設備，根據運營商支持的品牌串列，
- 根據品牌/區域獲取遙控器索引串列：根據型別 ID/區域ID 獲取支持IPTV運營商的遙控器索引，
- 添加機頂盒遙控器：添加機頂盒遙控器，
- 查詢電視頻道串列：根據遙控器ID查詢頻道串列，
- 切換電視頻道：切換電視片頻道
空調遙控器控制
此場景只是推薦的紅外流程，可以根據各自不同的需要，基于已開放的介面開發并豐富各自的業務流程場景，，
操作流程：
- 獲取支持的紅外空調設備的品牌；API(1)：API檔案——獲取指定型別品牌串列
- 選擇指定的品牌獲取遙控器紅外碼庫索引；API(2)：API檔案——獲取品牌支持遙控器索引串列
- 一個品牌可能會有多個不同的遙控器紅外碼庫索引，這時需要試用是否合適需要控制的紅外設備，一般建議至少測驗三個按鍵有效后再確認添加遙控器；API(3)：API檔案——測驗空調遙控器
- 確認可用的遙控器紅外碼庫索引后，使用此索引系結空調遙控器到萬能紅外遙控器設備上；API(4)：API檔案——添加普通遙控器
- 使用普通遙控器，基于標準紅外指令控制設備；標準指令參考：API檔案——控制遙控器：已添加遙控器（基于通用標準按鍵）
或者空調專有指令控制設備；API(5)：API檔案——控制空調遙控器
- 部分業務場景存在直接控制空調相關引數的情況，呼叫多條件的空調指令直接控制空調的相關引數，但請注意并不是所有的組合條件都可以支持直接下發紅外碼；API(6)：API檔案——多條件控制空調
空調類遙控器只支持API檔案中描述的標準指令，不支持非標準指令，
API串列
- 測驗空調遙控器：用于在測驗空調遙控器是否匹配空調設備時，根據遙控器索引下發單個的空調遙控器按鍵指令，
- 控制空調遙控器：下發單個的空調遙控器按鍵指令，
- 多條件控制空調：多條件的空調指令下發，用于在部分聯動場景下對空調的控制，
- 查詢空調狀態：查詢空調狀態，
三、其他介面串列：
通用介面API串列：
- 獲取紅外設備下面系結的遙控器串列：根據紅外設備 ID 來獲取紅外設備下面系結的遙控器串列，
- 添加/洗掉/設定遙控器：此介面可以兼容機頂盒、電視、空調等型別設備的遙控器添加/洗掉/設定，
- 獲取遙控器配對規則：根據遙控器 ID 獲取配對規則，獲取到key用于紅外碼下發，
- 控制遙控器：測驗場景按鍵（基于通用標準按鍵）：在測驗遙控器是否匹配設備時使用，使用通用標準key控制，標準key見附錄，支持空調的標準指令下發，
- 控制遙控器：測驗場景按鍵（基于配對規則）：在測驗遙控器是否匹配設備時使用，根據key來下發紅外碼，請求引數中的key是從獲取配對規則中獲得key，非標準指令不支持空調，空調使用專有的指令下發，
- 控制遙控器：已添加遙控器（基于配對規則）：控制已系結的遙控器下發指令，根據raw_key來下發紅外碼，請求引數中的raw_key是從獲取配對規則中獲得key，目前這個介面只支持電視和機頂盒，空調使用專有的指令下發，
- 獲取遙控器支持的按鍵串列：可查詢指定遙控器支持的按鍵串列，同時回傳可支持的標準key和非標準key，
- 獲取空調遙控器支持的按鍵規則串列：僅查詢指定空調類的遙控器支持的按鍵串列，同時回傳可支持的標準key和非標準key，同時回傳支持的按鍵范圍，
紅外碼學習API串列
開啟學習狀態后，再使用真實的遙控器對準萬能紅外設備按下需要學習的按鍵，然后再使用查詢學習到的學習碼的API獲取學習到的學習碼，
- 更新學習狀態：進入學習狀態
- 查詢學習到的紅外碼：獲取學習到的紅外碼，傳入的引數建議直接使用更新學習狀態時回傳的時間戳t，
- 下發/更新/洗掉學習到的紅外碼：下發/更新/洗掉學習到的紅外碼，
- 保存學習到的紅外碼：保存學習到的紅外碼，生成遙控器id
- 獲取保存的學習紅外碼：獲取保存的學習紅外碼
紅外碼智能匹配API串列
部分品牌下的預設的遙控器紅外碼庫索引可能比較多，有時候為了嘗試出某個索引是否支持需要控制的設備，可能需要測驗多次，造成匹配成功一個遙控器需要耗費大量的時間和精力，? 因此提供紅外碼智能匹配功能，可以根據學習到的紅外碼來快速匹配遙控器紅外碼庫索引，
前提是需要提供真實的遙控器進行學習匹配，
操作流程：
- 開啟紅外網關學習狀態；API檔案——更新學習狀態
- 用戶使用遙控器對準紅外網關發送紅外碼；
- 獲取紅外網關學習到的學習碼； API檔案——查詢學習到的紅外碼
- 使用學習到的 學習碼 請求智能匹配，回傳 智能匹配token； API檔案——生成智能匹配令牌
- 使用 智能匹配token 請求匹配串列；API檔案——獲取智能匹配遙控器串列
- 用戶在回傳的匹配串列中依次查看遙控器索引資訊； API檔案——獲取遙控器索引支持的品牌資訊
- 回圈嘗試匹配串列的遙控器索引中的按鍵；
API檔案——控制遙控器：測驗場景按鍵（基于通用標準按鍵）
API檔案——測驗空調遙控器
- 如果找到合適的，則確認遙控器，結束此次智能匹配動作；否則繼續后續步驟；API檔案——添加遙控器
- 如果未找到合適的，則繼續使用 智能匹配token 請求匹配串列，進行步驟5的操作，這里就是在有多個匹配結果的時候，進行的分頁處理，如果只有1頁，則不需要再進行步驟5的操作；
- 如果介面回傳無資料，則匹配串列結束；
- 如果需要進一步縮小匹配范圍，則可以再次開啟紅外網關學習狀態，下發新的學習碼，然后獲取新的 智能匹配token （步驟1、2、3、4）；
- 然后使用新的 智能匹配token 同時帶上步驟5中的舊的 智能匹配token 一起請求匹配串列，系統則會在使用步驟3學習到的紅外碼匹配的基礎上，再使用步驟11獲取的紅外碼進一步縮小匹配范圍；
- 然后再重復步驟6、7、8、9、10、11，直到找到合適的遙控器索引，或者未匹配到，
API串列：
- 生產智能匹配令牌：使用紅外網關學習到的紅外碼，生成智能匹配令牌token，用于后續分頁查詢智能匹配結果，
- 獲取智能匹配遙控器串列：使用生成的智能匹配令牌token，分頁查詢智能匹配結果串列，
- 獲取遙控器索引支持的品牌資訊：查詢指定遙控器索引支持的品牌的資訊，
紅外定時任務API串列
- 添加紅外定時任務：添加一個紅外定時任務，
- 獲取/更新/洗掉紅外定時任務：查詢/更新/洗掉紅外定時任務，
- 洗掉所有定時任務：洗掉所有定時任務，
- 更新紅外分組定時狀態：更新紅外分組定時狀態，
以上所有所有介面地址可在此處查詢>>>涂鴉云平臺介面串列
轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/219930.html
標籤：python