> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# 裝置管理

> 從 BRICKS Controller 新增、監控及控制裝置

[BRICKS Controller](/zh-Hant/controller) 提供集中式儀表板，管理所有綁定至工作區的裝置。

## 新增裝置

### 綁定實體裝置

<Steps>
  <Step title="在 BRICKS Foundation 上開啟裝置">
    在裝置上啟動 [BRICKS Foundation](/zh-Hant/foundation)。畫面上會顯示一組 9 個字元的通行碼。
  </Step>

  <Step title="在 BRICKS Controller 中新增裝置">
    在 BRICKS Controller 中，前往 **Devices** > **Add Device**。
  </Step>

  <Step title="輸入通行碼">
    輸入裝置上顯示的通行碼並點擊 **Bind**。裝置隨即出現在裝置清單中。
  </Step>
</Steps>

### 建立虛擬裝置

虛擬裝置是以雲端為基礎的實例，行為與實體裝置相同。可用於測試與開發。

1. 前往 **Devices** > **Add Device**
2. 選擇 **Virtual Device**
3. 設定裝置名稱與檢視區
4. 點擊 **Create**

## 裝置清單與監控

裝置清單顯示工作區中所有裝置及其目前狀態：

| 狀態                  | 說明          |
| ------------------- | ----------- |
| **線上（Online）**（綠色）  | 裝置已連線並正在執行  |
| **離線（Offline）**（灰色） | 裝置未連線       |
| **Last alive**      | 裝置最後連線的時間戳記 |

點擊裝置可檢視詳細資訊，包括硬體資訊、目前應用程式及連線紀錄。

## 裝置控制

從裝置詳細資訊頁面，您可以：

* **Refresh（重新整理）** —重新載入裝置上的應用程式
* **Clear cache（清除快取）** —清除應用程式快取並強制完整重新載入
* **Take screenshot（螢幕截圖）** —擷取裝置目前畫面的螢幕截圖
* **Remote debug（遠端除錯）** —即時檢查應用程式屬性（請參閱[遠端除錯](/zh-Hant/foundation/remote-debug)）
* **Debug panel（除錯面板）** —在裝置上切換除錯面板、記錄及其他診斷覆蓋層
* **Activity log（Activity Log）** —檢視裝置事件紀錄

## 裝置群組

裝置群組在 BRICKS Controller 中擁有獨立的頂層分頁（**Device Group**）。使用群組來組織裝置以進行批次操作：

1. 前往 **Device Group** 分頁
2. 點擊 **New Device Group**
3. 將裝置加入群組
4. 使用群組一次部署應用程式、部署裝置設定或向所有裝置派送動作

## 裝置 token

虛擬裝置具有用於 API 存取的唯一 token。透過 [BRICKS CLI](/zh-Hant/cli) 或工作區 API，使用裝置 token 以程式方式與虛擬裝置互動。

檢視虛擬裝置的 token：

1. 在裝置清單中點擊虛擬裝置
2. 前往 **Settings** 分頁
3. 複製 **Device Token**

## 螢幕截圖

對任何線上裝置進行遠端螢幕截圖：

1. 從裝置清單選取裝置
2. 點擊 **Screenshot**
3. 螢幕截圖會顯示在裝置詳細資訊頁面

螢幕截圖有助於監控裝置畫面及除錯視覺問題。