> ## 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](/ja/controller) は、ワークスペースにバインドされたすべてのデバイスを管理する集中ダッシュボードを提供します。

## デバイスの追加

### 物理デバイスのバインド

<Steps>
  <Step title="BRICKS Foundation でデバイスを開く">
    デバイスで [BRICKS Foundation](/ja/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（リモートデバッグ）** — アプリケーションのプロパティをリアルタイムで検査する（[リモートデバッグ](/ja/foundation/remote-debug)を参照）
* **Debug panel（デバッグパネル）** — デバイスのデバッグパネル、ログ、その他の診断オーバーレイを切り替える
* **Activity log（アクティビティログ）** — デバイスのイベント履歴を確認する

## デバイスグループ

デバイスグループは BRICKS Controller 内に独立したトップレベルタブ（**Device Group**）を持ちます。グループを使用してデバイスを整理し、バッチ操作を実行します：

1. **Device Group** タブに移動する
2. **New Device Group** をクリックする
3. グループにデバイスを追加する
4. グループを使用して、アプリケーションのデプロイ、デバイス設定のデプロイ、またはすべてのデバイスへのアクションの一括送信を行う

## デバイストークン

仮想デバイスには API アクセス用の固有のトークンがあります。デバイストークンを使用して、[BRICKS CLI](/ja/cli) またはワークスペース API を通じてプログラムで仮想デバイスを操作します。

仮想デバイスのトークンを確認するには：

1. デバイスリストで仮想デバイスをクリックする
2. **Settings** タブに移動する
3. **Device Token** をコピーする

## スクリーンショット

オンライン状態の任意のデバイスのリモートスクリーンショットを撮影します：

1. デバイスリストからデバイスを選択する
2. **Screenshot** をクリックする
3. スクリーンショットがデバイス詳細ページに表示される

スクリーンショットは、デバイスの画面モニタリングや表示上の問題のデバッグに役立ちます。