Aarlo是 Home Assistant 的自訂元件,可提供對 Arlo 系統的存取。
除此之外, Aarlo還提供:
Aarlo是 Home Assistant 的自訂元件,可提供對 Arlo 系統的存取。
該整合使用 Arlo 攝影機網站提供的API ,但存在一些限制。有關更多詳細信息,請參閱已知限制部分。
如果您遇到問題,請查看常見問題部分,看看是否有已知問題以及解決方法或修復。如果沒有,請查看錯誤報告部分,以了解有關如何產生偵錯日誌和建立偵錯報告的資訊。
高級自述文件在這裡
舊的自述文件仍然可以在這裡找到。
本文檔假設您熟悉Home Assistant設定和配置。
無論您在本文檔中的何處看到/config
它都是指您的Home Assistant配置目錄。例如,對於我的安裝,它是/home/steve/ha
,由我的 docker 容器對應到/config
。
無論您在哪裡看到Arlo,它都指的是Arlo系統的任何部分。
無論您在哪裡看到Aarlo,我指的是這個組件。
非常感謝:
Aarlo還提供客製化的Lovelace 卡,它將攝影機的最後快照與其當前狀態疊加,並允許存取攝影機錄製庫和即時串流媒體。
如果您不熟悉Home Assistant ,我建議您造訪社區網站。這裡到處都是樂於助人的人,而且總是有人遇到過您想要解決的問題。
Aarlo需要一個專用的Arlo帳號。如果您嘗試重複使用現有帳戶(例如,您在手機上的Arlo應用程式上使用的帳戶),該應用程式和此整合將不斷爭奪登入權限。
專用Aarlo帳戶需要啟用Allow Access Rights
才能設定警報等級並讀取某些狀態值。
請參閱Arlo文件以取得更多說明。
您需要啟用兩因素身份驗證。設定電子郵件地址以接收驗證碼。 Aarlo支援其他TFA機制,但電子郵件是最容易使用的。有關更多詳細信息,請參閱稍後的雙重認證部分。
您只需使用這些安裝機制之一。我推薦 HACS。
Aarlo 是預設 HACS 儲存的一部分。如果您對使用開發分支不感興趣,這是最簡單的安裝方法。
將aarlo
目錄複製到/config/custom_components
目錄中。
運行安裝腳本。運行一次以確保操作看起來正常,然後使用go
參數運行第二次以完成實際工作。如果更新後重新運行腳本,它將覆蓋所有已安裝的檔案。
install /config # check output looks good
install go /config
但是,您安裝了原始程式碼,您知道需要將整合添加到Home Assistant中。從主頁中選擇Settings -> Devices & Services
,然後點擊ADD INTEGRATION
並蒐索Aarlo
。在第一個畫面上輸入您的帳戶詳細資料。
場地 | 價值 |
---|---|
使用者名稱 | 您的Arlo帳戶用戶名 |
密碼 | 您的Arlo帳戶密碼 |
二因素機制 | 選擇 IMAP |
TFA 使用者名稱 | 您為 TFA 註冊的電子郵件帳戶 |
TFA密碼 | 電子郵件帳號密碼 |
TFA主機 | 用於查找電子郵件的 IMAP 伺服器 |
如果您保留Use aarlo prefix
選中,您的所有裝置都將採用type.aarlo_*
格式。
按一下SUBMIT
。整合將登入Arlo並檢索與其關聯的裝置清單。如果一切正常,您將能夠在下一個螢幕上將設備分配到房間。
您可以進一步微調設定。在「整合」頁面中點選CONFIGURE
。
微調警報設定:
場地 | 價值 |
---|---|
警報/撤防代碼 | 如果需要,請輸入代碼,否則保留預設值 |
撤防模式名稱 | 如果您的 Arlo 帳戶具有自訂解除名稱,請進行更改 |
家庭模式名稱 | 如果您的 Arlo 帳戶具有自訂家庭模式名稱,請進行更改 |
離開模式名稱 | 如果您的 Arlo 帳戶具有自訂離開模式名稱,請進行更改 |
夜間模式名稱 | 如果您的 Arlo 帳戶具有自訂夜間模式名稱,請進行更改 |
需要手臂代碼 | 選擇是否需要警報/撤防代碼才能布防 |
需要撤防代碼 | 選擇是否需要警報/撤防代碼才能撤防 |
觸發時間 | 布防時要等多久 |
警報音量 | 警報器的預設音量 |
夜間模式; Arlo不會擁有其中之一,除非您創建它
如果需要清除警報代碼, no code needed
。我會設法讓它接受空白條目......
確定哪些二進位感測器可用:
場地 | 價值 |
---|---|
聲音偵測 | 啟用相機上的麥克風 |
運動偵測 | 在攝影機上啟用運動偵測 |
門鈴按壓器 | 啟用門鈴按鈕 |
哭泣檢測 | 對於 Arlo Baby,啟用哭泣檢測 |
裝置連接 | 當設備斷開連線時收到通知 |
開啟/關閉感應器 | 啟用門窗感應器 |
亮度感測器 | 啟用光偵測 |
篡改檢測 | 如果裝置開啟則啟用通知 |
洩漏檢測 | 啟用洩漏監測設備 |
並非所有感測器都適用於所有裝置。
確定哪些感測器可用:
場地 | 價值 |
---|---|
最後捕捉時間 | 每個攝影機感應器指示最後一次錄製的時間 |
偵測到的攝影機總數 | 相機數量的整數值 |
偵測到最近的活動 | 相機最近是否處於活動狀態 |
今天捕捉的影片/快照數量 | 今天錄製的整數值 |
設備電池電量 | 電池剩餘電量百分比 |
WiFi訊號強度 | WiFi 強度,範圍為 1 到 5 |
室溫 | 房間條件 |
房間濕度 | 房間條件 |
空氣品質 | 房間條件 |
並非所有感測器都適用於所有裝置。最近的活動可能應該是binary_sensor 。
啟用其他開關:
場地 | 價值 |
---|---|
打開警報器的開關 | 提供一個開關來打開各個警報器 |
一個開關可打開所有警報器 | 提供一個開關來打開所有警報器 |
允許關閉警報器 | 允許透過開關關閉警報器 |
警笛開關音量 | 預設音量級別,從 1 到 10 |
警報器開關持續時間 | 運行鬧鐘的預設時間 |
切換到請求相機拍攝快照 | 提供相機快照開關 |
相機快照超時 | 行為不良的相機要等多久才能完成 |
切換到靜音門鈴 | 提供一個使門鈴靜音的開關。 |
如果您來自較早的地方,則需要注意以下幾點:
config flow
機制中。您的所有裝置都將顯示在整合頁面上。yaml
條目。prefix with _aarlo
以保持命名相同。aarlo
域中。pyaarlo
元件現在透過pip
安裝,不包含在整合中。.aarlo/session.pickle
,您可能會遇到登入困難。我不願意將一些更深奧的配置項目移到config flow
機制中,如果您進行了任何配置,它們將出現在/config/aarlo.yaml
檔案中。有關這些選項的更多信息,請參閱此處。
Arlo將使用 SSE 或 MQTT 向Aarlo發送事件訊號。我不完全確定決定選擇哪個的機制,但我知道新增或刪除user_agent
會在兩者之間切換。
Arlo最近更新了他們發送到session/v3
API 請求的回應,以指示選擇哪個後端。 Aarlo在使用auto
時會解析它。
# This is the MQTT backend. We use the host and port.
' mqttUrl ' : ' ssl://mqtt-cluster-z1.arloxcld.com:8883 '
# This is the SSE backend. We use a fixed host and port.
' mqttUrl ' : ' wss://mqtt-cluster-z1.arloxcld.com:8084 '
如果啟用詳細偵錯,您應該可以在Home Assistant日誌中找到該值。
從0.8
版本開始, Aarlo應該要夠聰明,能夠確定要使用哪個後端。但是,如果您發現自己遇到問題,例如缺少運動偵測事件或缺少感測器值更新,您可以手動覆蓋該設定。在/config/aarlo.yaml
中更改此設定。
aarlo :
# This forces the SSE backend
backend : sse
aarlo :
# This forces the MQTT backend
backend : mqtt
# These might also be needed
mqtt_hostname_check : false
mqtt_host : mqtt-cluster-z1.arloxcld.com
aarlo :
# This forces Aarlo to choose
backend : auto
請注意,刪除該設定相當於auto
。
Arlo對Arlo網站登入使用Cloud Flare反機器人保護。該服務不能很好地與Python Requests套件配合使用(或Aarlo如何使用這些請求,我不太確定)。
如果您看到以下錯誤,表示您遇到了Cloud Flare問題。
2021-06-03 13:28:32 WARNING (SyncWorker_4) [pyaarlo] request-error=CloudflareChallengeError
這個問題影響了我,我一直在努力完善程式碼。
Aarlo做了幾件事來解決這個問題:
Header
層級。但是,如果您仍然遇到登入問題,您可以嘗試幾個設定項。
您可以嘗試不同的用戶代理程式。這是在/config/aarlo.yaml
中配置的:
aarlo :
# Change the user agent. It can be either arlo, iphone, ipad, mac, firefox or linux
# or random. random will change it each time it tries to login
user_agent : linux
# Or use a custom user agent, everything after the ! will be used
user_agent : !this-is-a-custom-user-agent
您可以將Source
標頭與登入請求一起新增。我有一個網站需要這個,另一個則不需要。我認為這可能與用戶代理有關。
aarlo :
# This adds the following header "Source: arloCamWeb"
send_source : true
您可以使用以下命令停用會話快取:
aarlo :
# This will force a full login on every restart
save_session : false
您可以選擇使用不同的ecdh曲線。此主題超出了本文檔的範圍,請參閱此處以取得解釋。
aarlo :
# Make this curve the first choice. You can only enter 1 choice.
ecdh_curve : secp384r1
您可以修改/etc/hosts
以指向特定的Arlo Web 伺服器
# Remove the # to force the request to go to a particular cloudflare server
#104.18.30.98 ocapi-app.arlo.com
#104.18.31.98 ocapi-app.arlo.com
Arlo將其稱為兩步驟驗證。您需要為您的Home Assistant特定帳戶啟用此功能。 Aarlo支援IMAP和PUSH機制,但我建議使用IMAP ,使用PUSH需要手動回應登入要求。
您可以在此處找到有關設定兩因素身份驗證的說明 Arlo 在此處提供
新增整合時輸入兩因素身份驗證。
依照兩因素驗證說明操作,新增並設定電子郵件驗證方法。您可以透過登入 Arlo 主網頁並確保它向您發送電子郵件來測試這一點。
對於Gmail和Yahoo (以及其他基於網路的電子郵件用戶端),您無法使用常用密碼登錄,您必須建立應用程式特定密碼。解釋為什麼這是必要的超出了本文檔的範圍,因此請參閱以下頁面。
如果您發現無法登入IMAP帳戶,請檢查應用程式密碼要求。
已知以下伺服器可以工作:
服務 | 主機名稱 |
---|---|
信箱 | imap.gmail.com |
雅虎! | imap.mail.yahoo.com |
依照兩因素身份驗證說明新增並設定PUSH驗證方法。
如果您需要變更傳遞給 IMAP 用戶端的密碼列表,請使用下列選項指定它。你不需要這樣做。有關詳細信息,請參閱 openssl 手冊頁。
aarlo :
# specify cipher list to use
cipher_list : " HIGH:!DH:!aNULL "
# Use DEFAULT for the cipher list
default_ciphers : True
如果遇到問題,請建立錯誤報告,並在錯誤報告中包含以下資訊以協助偵錯。如果你不這麼做,我就會纏著你,直到你這麼做為止。
您可以透過更改configuration.yaml
中的日誌記錄設定來開啟基本Aarlo偵錯。
logger :
default : info
logs :
pyaarlo : debug
custom_components.aarlo : debug
您可以透過啟用日誌記錄並將以下內容新增至/config/aarlo.yaml
來開啟詳細偵錯。詳細偵錯會產生大量日誌,因此最好僅在需要時啟用。
aarlo :
verbose_debug : true
Aarlo會將偵錯日誌寫入標準Home Assistant日誌檔案/config/home-assistant.log
。
在向我發送調試之前,您應該對其進行加密。您可以加密此網頁上的輸出。您可以上傳文件或將其複製並貼上到緩衝區中,然後按Submit
。
此頁面不會自動將輸出轉發給我,因此您必須將其複製並貼上到文件中並將其附加到錯誤報告中。
此頁面將隱藏日誌,因此只有我可以閱讀它們,我是解密它的私鑰的唯一擁有者,但要小心,除了序號之外,它可能還包括您的帳戶和密碼資訊。你可以在加密之前隱藏它們,我從來不需要它們。
我並不擁有每件Arlo設備,因此有時,當出現問題或發布新設備時,我需要查看Arlo實際期望此代碼發送什麼以及此代碼期望從Arlo返回什麼。 Aarlo模擬 Web 瀏覽器連接,以便您可以使用瀏覽器開發人員工具來了解所需內容。
本說明適用於 Chrome,但大多數瀏覽器(我希望!)都有類似的功能。
More Tools
,最後選擇Developer Tools
。您也可以使用快速鍵CTRL+SHIFT+I
。Network
標籤。當您登入時,瀏覽器和Arlo網站之間傳遞的資料將開始顯示並持續顯示在此標籤中。如果您按一下Name
下的條目,您可以更詳細地檢查資料包。
Headers
顯示請求標頭中傳送的內容。Payload
標籤顯示請求內文中發送的內容Preview
標籤顯示從Arlo發回的回應。 如果將滑鼠懸停在name
下的欄位上,彈出視窗將顯示請求傳送到的完整 URL。
我需要記錄這一點。
尋找包含單字subscribe
URL,這將是Arlo發送回網頁的偶數流。當您按一下網頁上的按鈕時,此清單中將顯示更多項目。我可以使用此資訊來確定如何解析我尚未處理的情況的回應資料包。
例如, Arlo創建了一個帶有WOOHOO
按鈕的新設備,我沒有這樣的設備,但您希望在Aarlo中實現WOOHOO
功能。我需要的是按下按鈕時資料包的順序及其回應。執行此操作的唯一真正方法是按下按鈕並查看Name
選項卡中出現的新資料包。
然後,您需要將它們複製並貼上到GitHub上的錯誤報告中。請參閱上一節,了解如何隱藏敏感資料。
不。這是Arlo 的限制。
您確定已共用該設備嗎?登入 Arlo 網頁並確保其顯示在那裡。如果確實如此,則打開偵錯日誌並使用它們提出錯誤報告。
確保您已向共用裝置的帳戶提供了管理員存取權限,這是電池或訊號強度更新等操作所必需的。
確保您已為共用裝置的帳戶提供了管理員存取權限,這是共用基地台所必需的。
您是否使用新的Arlo基於位置的介面,在這種情況下,您只能布防或撤防位置,而不能布防單一裝置。
無需訂閱即可查看提要,但您需要訂閱才能查看錄製內容。
截至撰寫本文時(2024 年 5 月),尚無讀取本地錄音的選項。所有其他功能都運作良好。
他們確實這麼做了。 Arlo 的工作方式與IP攝影機不同,僅在檢測到運動時進行記錄,因此要求它啟動串流媒體需要與與您家中的攝影機通訊的Arlo伺服器進行通訊…可能需要幾秒鐘才能運作。串流媒體的工作原理如下:
Camera ---> Arlo Cloud Servers --> Home Assistant --> Your Home Assistant Client
視頻流量必須從您的房子流出,然後再返回…
這是已知可以工作的設備的清單。即使此列表中沒有明確提及,大多數Arlo設備也可以工作,儘管它們的功能可能有限。
模型 | 姓名 | 特徵 |
---|---|---|
ABC1000 | 嬰兒 | 動作、音頻、環境、哭泣 |
AVD1001 | 有線可視門鈴 | 運動 |
AVD2001 | 基本可視門鈴 | 運動, 警報器 |
AVD3001 | 有線可視門鈴高清 | 運動, 警報器 |
AVD4001 | 有線可視門鈴2K | 運動, 警報器 |
FB1001 | Pro 3 泛光燈 | 泛光燈 |
MS1001 | 多合一感測器 | 運動、開啟、潮濕、竄改、溫度 |
VMB3010 | 基地台 | |
VMB4000 | 基地台2 | 警笛 |
VMB4500 | 專業基地台 | 警笛 |
VMC2030 | 必備相機 | 運動、音頻、警報器、聚光燈 |
VMC2040 | 必備的室內攝影機 | 動作、音訊、警報器 無電池 |
VMC3030 | 高畫質攝影機 | 動作、音訊 |
VMC3040 | Q相機 | 動作、音訊 |
VMC3060 | 必備室內攝影機 2 | 運動,需要觀察 |
VMC3052 | Essential XL 相機 | 動作、音頻、聚光燈 |
VMC4030 | Pro 2 相機 | 動作、音訊 |
VMC4040 | Pro 3 相機 | 運動、音頻、警報器、聚光燈 |
VMC4041 | Pro 4 相機 | 運動、音頻、警報器、聚光燈 |
VMC4060 | Pro 5 相機 | 運動、音頻、警報器、聚光燈 |
VMC5040 | 超級相機 | 運動、音頻、警報器、聚光燈 |
VML2030 | 去2相機 | 動作、音訊 |
VML4030 | 去相機 | 運動 |
該組件是透過對 Arlo 攝影機網頁上使用的API進行逆向工程而編寫的。
這些是一般限制:
這些是該網站的限制:
這些是與行動應用程式相比的限制:
最後兩條可以概括if the WEB API doesn't support it, neither can the component.
當提出新功能請求時,請記住這一點。