Android 範例應用程式展示了使用 Home API 存取及控制支援裝置類型的基本功能。
完成帳戶授權並選取住家結構體後,範例應用程式會載入在該結構體中找到的所有本機裝置。
如果裝置位於某個房間,就會列在該房間下方。範例應用程式支援下列裝置類型:
- 色溫燈 (開關、亮度)
- 接觸感應器 (布林值狀態)
- 可調光燈具 (開關、亮度)
- 門鎖
- 擴充彩色燈 (開關、亮度)
- 一般切換
- Google 邊界路由器
- Google 相機
- Google Doorbell
- 活動情形感應器 (在宅感應)
- 開關燈 (開和關、亮度)
- 電燈開關
- 開/關外掛式裝置 (開和關)
- 開關感應器
現有裝置和自動化動作的操作
範例應用程式包含兩個分頁:「裝置」和「自動化動作」。每個分頁都會提供結構相關資訊,並可讓您執行工作。
「裝置」分頁
「Devices」分頁 (圖 1) 顯示住家結構中的房間 (後院、閣樓、旅行) 和每個房間的裝置,以及各裝置的狀態。如要查看或編輯裝置的特徵,請輕觸裝置名稱。系統會隨即顯示該裝置的控制畫面 (圖 2)。
如要將裝置新增至結構,請輕觸「裝置」分頁中的「新增裝置」(圖 1),然後按照操作說明新增裝置 (可選擇是否使用 QR code)。
「自動化動作」分頁
「Automations」分頁 (圖 3) 會列出住家的所有自動化動作。每項自動化動作都會顯示啟動條件和動作。支援多個啟動條件和動作。
輕觸自動化動作即可查看詳細資料,如圖 4 所示。在這個詳細檢視畫面中,你可以刪除自動化動作,或手動執行自動化動作,而不需啟動條件,前提是這個自動化動作支援「手動執行」按鈕。
此外,在自動化動作的詳細資料檢視畫面 (圖 4) 中,您可以切換 isActive 來開啟或關閉自動化動作。isValid 欄位是由 SDK 設定,如果裝置或特質支援或其他問題,則會設為 false。
建立自動化作業
如要建立新的自動化動作,請在自動化動作清單檢視畫面中輕觸「建立」按鈕 (圖 3)。「新增自動化動作」畫面隨即顯示 (圖 5)。
使用「+ 新增啟動條件」和「+ 新增動作」按鈕 (圖 5),在自動化動作中新增一或多個啟動條件和動作。圖 6 和圖 7 分別顯示選取啟動條件和動作的範例。選取並儲存啟動條件或動作後,系統會顯示啟動條件的「更新啟動條件」和「移除啟動條件」按鈕 (以及動作的「更新動作」和「移除動作」)。這樣一來,你就能在儲存自動化動作前,編輯或移除啟動條件或動作。
新增啟動條件和動作後,可以返回「新增自動化動作」畫面,然後輕觸「建立自動化動作」 (圖 8)。
疑難排解
應用程式會針對可能發生的常見事件顯示對話方塊訊息。請參閱 adb 記錄,瞭解如何解決這些事件。
如果使用範例應用程式時遇到問題,請參閱「Android 疑難排解」。