資料服務 Data Service

前言大綱

數據服務跟踪通過 API 記錄到機器人的數據。 這包括：

• 文本消息 Text messages：信息/警告/錯誤/調試消息，通常由 API 服務記錄。
• 評論 Comments：短消息，通常由操作員添加的有關機器人行為的信息。
• 事件 Events：記錄機器人或客戶端事件的消息，帶有時間戳和可能的持續時間。
• 消息塊 Message blobs：任意二進制消息塊。

這些和其他消息存儲在機器人的數據“頁面”中。 頁是數據服務跟踪的離散存儲單元。

這些示例程序演示如何查詢機器人數據服務以獲取有關機器人數據頁及其內容的信息。

設置相依性

此範例需要安裝 bosdyn API 和客戶端，並且必須使用 python3 運行。使用 pip，可以使用以下命令安裝這些相依性：

python3 -m pip install -r requirements.txt

運行示例

每個示例都要求您指定用戶名和密碼以對機器人進行身份驗證。

get_comments.py

獲取通過 API 記錄的操作員評論。

python3 get_comments.py --username USER --password PASSWORD ROBOT_IP

get_events.py

獲取在機器人上的日誌事件。

python3 get_events.py --username USER --password PASSWORD ROBOT_IP

get_index.py

獲取包含 blob、文本消息、事件或操作員註釋的頁面列表。 COMMAND 可以是 blob、文本、事件或註釋之一。

python3 get_index.py --username USER --password PASSWORD ROBOT_IP COMMAND

get_pages.py

獲取當前機器人上的數據頁列表。

python3 get_pages.py --username USER --password PASSWORD ROBOT_IP

您可以選擇指定要返回的頁面的時間範圍。

例如：

python3 get_pages.py --username USER --password PASSWORD \
   --timespan 20201030-20201031 ROBOT_IP

請參閱下面的時間範圍規範說明。

delete_pages.py

從機器人中刪除數據頁。在沒有時間範圍的情況下運行此操作將刪除機器人上的所有數據頁。

python3 delete_pages.py --username USER --password PASSWORD ROBOT_IP

您可以選擇指定要刪除的頁面的時間範圍。例如：

python3 delete_pages.py --username USER --password PASSWORD \
   --timespan 20201031_115000-20201031_115950 --robot-time ROBOT_IP

如果較喜歡，您可以僅指定一個開始時間或僅指定一個結束時間。

時間範圍

命令行參數中的時間採用 _val_or val-val 格式，其中 val 具有以下格式之一：

yyyymmdd_hhmmss（例如，20200120_120000）

yyyymmdd（例如，20200120）

n 天前

nh n 小時前

nm n 分鐘前

ns n 秒前

nnnnnnnnnn[.nn]（例如，1581869515.256）自紀元以來的秒數

nnnnnnnnnnnnnnnnnnnn 自紀元以來的n秒

所以：

5m 表示從 5 分鐘前到現在。

20201107-20201108 表示 2020/11/07 的所有時間。

添加 --robot-time 表示指定的時間範圍在機器人時鐘內，因此指定的值不應從客戶端時間轉換為機器人時間。

參考資料

• Using the Robot Data Service

特色、摘要，Feature、Summary:

關鍵字、標籤，Keyword、Tag:

• Spot-Python,Spot-SDK,Spot,Robot,Data-Science,