通過海康螢石API控制家里相機的云臺及抓圖
- 一、背景
- 二、環境準備
- 2.1 注冊開發者賬號
- 2.2 安裝依賴庫
- 2.3 創建`.`env`文件
- 三、代碼片段解釋
- 3.1 加載并使用環境變量
- 3.2 發送HTTP請求的封裝函數
- 3.3 獲取AccessToken
- 3.4 分頁查詢設備列表
- 3.5 抓拍圖片
- 3.6 開始云臺控制
- 3.7 控制云臺并抓拍圖片
- 四、完整的代碼
- 五、參考鏈接
一、背景
在智能家居時代，攝像頭已經成為我們生活中不可或缺的一部分。很多朋友都選擇使用海康威視或螢石攝像頭來監控家中的情況。然而，只用它們的原生App來進行云臺控制和抓圖似乎并不夠靈活方便。借助于海康威視和螢石提供的API，我們可以通過編寫自定義代碼來實現更加智能化、定制化的攝像頭控制。
在這篇技術博客中，我將帶你了解如何利用Python完成家里攝像頭的云臺控制及抓圖操作。無論您是一個熱愛DIY家居的創客、還是一個追求極致體驗的智能家居愛好者，希望這篇博客都能幫助您更好地掌握這一技術。
二、環境準備
2.1 注冊開發者賬號
訪問螢石開放平臺，完成以下步驟：
- 創建新應用
- 獲取AppKey和Secret（相當于API的賬號密碼）
- 綁定需要控制的攝像頭設備
為什么需要AppKey和Secret？
這是API訪問的身份憑證，確保只有授權用戶才能操作設備。就像銀行賬戶需要密碼才能操作一樣。
2.2 安裝依賴庫
首先，我們需要安裝python-dotenv庫來讀取環境變量。打開終端并運行以下命令：
pip install python-dotenv requests
上面這條命令同時會安裝requests庫，它是Python中發送HTTP請求的標準庫。
2.3 創建.env`文件
為了保密和安全起見，我們將把一些敏感信息（比如AppKey和Secret）存放在環境變量中。在項目根目錄下創建一個名為.env的文件，并添加以下內容：
AppKey=你的AppKey
Secret=你的Secret
三、代碼片段解釋
3.1 加載并使用環境變量
首先我們需要通過讀取環境變量獲取到你的AppKey和Secret，這些信息將用于認證你的請求。
from dotenv import load_dotenv
import os
import requests# 加載環境變量
load_dotenv()
AppKey = os.getenv("AppKey")
Secret = os.getenv("Secret")
3.2 發送HTTP請求的封裝函數
接下來，我們需要一個函數來封裝常用的HTTP POST請求操作。
def http_requests(url, data):headers = {'Content-Type': 'application/x-www-form-urlencoded'}print(f'Request URL: {url}')response = requests.post(url, headers=headers, data=data)response.raise_for_status() # 檢查是否成功return response.json()
3.3 獲取AccessToken
首先我們要獲取accessToken。accessToken是一個認證令牌，用于通過驗證來訪問海康威視提供的API。
def get_accessToken():url = 'https://open.ys7.com/api/lapp/token/get'data = {"appKey": AppKey, "appSecret": Secret}try:return http_requests(url, data)["data"]['accessToken']except requests.exceptions.RequestException as e:print("Error:", e)return None
關鍵點說明：
- 獲取到的accessToken有效期是7天
- 每次API調用都需要攜帶此令牌
- 實際生產環境需要實現令牌刷新機制
3.4 分頁查詢設備列表
通過accessToken，我們可以獲取到所有綁定了應用的設備。
def list_devices(accessToken):url = 'https://open.ys7.com/api/lapp/device/list'data = {"accessToken": accessToken, "pageStart": 0, "pageSize": 10}try:response_data = http_requests(url, data)return [(x['deviceSerial'], x['deviceName']) 
 】)
