系统桥接
系统桥接
前提条件
版本
此集成需要系统桥接 4.0.2 及以上版本。任何较早版本将无法工作。
令牌
您将需要您的令牌。有关查找您的令牌的说明，请按照 系统桥接文档
配置
要将 系统桥接 设备 添加到您的 Home Assistant 实例中，请使用此 My 按钮：
系统桥接 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。
如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在右下角，选择
Add Integration 按钮。 -
从列表中选择 系统桥接。
-
按照屏幕上的说明完成设置。
二进制传感器
此集成提供以下二进制传感器：
| 名称 | 描述 |
|---|---|
| 电池正在充电 | 电池是否正在充电 |
| 相机正在使用 | 相机/网络摄像头是否正在使用 |
| 待重启 | 是否有重启待处理 |
| 有新版本可用 | 是否有新版本可用 |
传感器
此集成提供以下传感器：
| 名称 | 描述 |
|---|---|
| 电池 | 设备的电池电量 |
| 启动时间 | 设备开启的时间 |
| CPU 速度 | 当前 CPU 速度 |
| 连接的显示器数量 | 连接的显示器数量 |
| 显示分辨率 X | 显示分辨率（横向） |
| 显示分辨率 Y | 显示分辨率（纵向） |
| 显示刷新率 | 显示的刷新率 |
| 文件系统 | 每个驱动器字母/文件系统挂载使用的空间 |
| GPU 空闲内存 | GPU 空闲内存（以 GB 为单位） |
| GPU 使用率 % | GPU 使用百分比 |
| 内核 | 内核版本信息 |
| 最新版本 | 系统桥接最新版本 |
| 负载 | 系统负载百分比 |
| 内存空闲 | 内存（RAM）空闲（以 GB 为单位） |
| 内存使用 | 内存（RAM）使用（以 GB 为单位） |
| 内存使用 % | 内存（RAM）使用百分比 |
| 操作系统 | 操作系统版本信息 |
| 进程 | 显示系统上的进程数量 |
| 版本 | 系统桥接版本 |
这些传感器也可用，但默认情况下未启用：
| 名称 | 描述 |
|---|---|
| CPU 温度 | 当前 CPU 的温度 |
| CPU 电压 | 当前 CPU 的电压 |
| GPU 核心时钟速度 | GPU 核心时钟速度（以 MHz 为单位） |
| GPU 内存时钟速度 | GPU 内存时钟速度（以 MHz 为单位） |
| GPU 风扇速度 | GPU 风扇速度百分比 |
| GPU 使用内存 | GPU 使用的内存（以 GB 为单位） |
| GPU 使用内存 % | GPU 使用内存百分比 |
| GPU 功率使用 | GPU 功率使用 |
| GPU 温度 | 当前 GPU 的温度 |
媒体播放器
该集成还提供媒体播放器。这使您能够控制设备上当前播放的媒体。
目前仅支持在 Windows 上运行系统桥接的设备。
媒体源
此集成作为媒体源与媒体浏览器集成一起使用。您可以浏览和查看系统中的媒体，并将其播放到您的浏览器和其他受支持的媒体播放器。
更新
该集成提供更新组件，当应用程序有新版本可用时会通知您。
操作
通知 notify.system_bridge_hostname
您可以使用 notify 平台向设备发送通知。
action: notify.system_bridge_hostname
data:
data:
image: "https://brands.home-assistant.io/system_bridge/logo@2x.png"
timeout: 30
actions:
- command: api
data:
endpoint: open
method: POST
body:
url: "http://homeassistant.local:8123/lovelace/cameras"
label: "打开相机"
audio:
source: "https://d3qhmae9zx9eb.cloudfront.net/home/amzn_sfx_doorbell_chime_02.mp3"
volume: 80
title: "测试标题"
message: "这是一条消息"
参数
| 参数 | 描述 |
|---|---|
| target | 要发送通知的目标。可以忽略。 |
| title | 通知的标题。 |
| message | 通知的消息。 |
| data | 要发送到设备的数据。有关详细信息，见下文。 |
操作（data 参数）
这是可以发送到设备的操作数组。这些是显示在标题、消息和图像下方的按钮。
| 参数 | 描述 |
|---|---|
| command | 发送给设备的命令。例如 api 将向系统桥接 API 发送请求。 |
| label | 按钮的标签。 |
| data | 要发送到设备的数据。api 命令的可用参数包括：endpoint，method，body，params。 |
以下是一个将在设备的浏览器中打开 URL 的操作示例：
- command: api
label: "打开相机"
data:
endpoint: open
method: POST
body:
url: "http://homeassistant.local:8123/lovelace/cameras"
音频（data 参数）
这是一个包含 source 和 volume（0-100）的对象。源必须是可播放音频文件的 URL（例如 MP3）。
操作 system_bridge.get_process_by_id
根据 pid 返回进程。
action: system_bridge.get_process_by_id
data:
bridge: "deviceid"
id: 17752
这将返回 响应数据，如下所示：
id: 17752
name: steam.exe
cpu_usage: 0.9
created: 1698951361.6117153
memory_usage: 0.23782578821487121
path: C:\Program Files (x86)\Steam\steam.exe
status: running
username: hostname\user
working_directory: null
操作 system_bridge.get_processes_by_name
根据提供的名称返回进程的计数和列表。
action: system_bridge.get_processes_by_name
data:
bridge: "deviceid"
name: discord
这将返回 响应数据，如下所示：
count: 1
processes:
- id: 11196
name: Discord.exe
cpu_usage: 0.3
created: 1698951365.770648
memory_usage: 0.07285296297215042
path: C:\Users\user\AppData\Local\Discord\app\Discord.exe
status: running
username: hostname\user
working_directory: null
操作 system_bridge.open_path
使用默认应用程序打开服务器上的 URL 或文件。
action: system_bridge.open_path
data:
bridge: "deviceid"
path: "C:\\image.jpg"
这将返回 响应数据，如下所示：
id: abc123
type: OPENED
data:
path: C:\image.jpg
message: 路径已打开
操作 system_bridge.open_url
使用默认应用程序打开服务器上的 URL 或文件。
action: system_bridge.open_url
data:
bridge: "deviceid"
url: "https://home-assistant.io"
这将返回 响应数据，如下所示：
id: abc123
type: OPENED
data:
url: https://home-assistant.io
message: URL 已打开
操作 system_bridge.send_keypress
向服务器发送按键。
action: system_bridge.send_keypress
data:
bridge: "deviceid"
key: "a"
这将返回 响应数据，如下所示：
id: abc123
type: KEYBOARD_KEY_PRESSED
data:
key: a
message: 按键已按下
操作 system_bridge.send_text
发送文本让服务器输入。
action: system_bridge.send_text
data:
bridge: "deviceid"
text: "Hello"
这将返回 响应数据，如下所示：
id: abc123
type: KEYBOARD_TEXT_SENT
data:
text: Hello
message: 文本已输入
操作 system_bridge.power_command
向系统发送电源命令。
支持的命令有：
hibernatelocklogoutrestartshutdownsleep
action: system_bridge.power_command
data:
bridge: "device"
command: "sleep"
这将返回 响应数据，如下所示：
id: abc123
type: POWER_SLEEPING
data: {}
message: 睡眠中