Control4 驱动说明
驱动版本 V1.06 适用型号 M310 · M310B · M320B · M210B Control4 要求 OS 3.2 + Composer Pro 3.1
米悦提供官方 Control4 驱动（.c4z），在 Composer Pro 中加载后即可把米悦主机
作为音源设备接入 Control4 系统，支持播放控制、音量、媒体库浏览与场景编程调用。
驱动下载：MiYue.c4z
1. 兼容性
| 项目 | 要求 |
|---|---|
| Control4 主机 | OS 3.2 及以上（未适配 OS 2） |
| Composer Pro | 3.1 及以上 |
| 米悦主机 | M310 · M310B · M320B · M210B |
各型号注意事项
| 型号 | 说明 |
|---|---|
| M310B | 需升级到固件 V2.3。2019 年出货的机器可直接 OTA 升级 |
| M310 | 需要刷机升级，请联系我们索取刷机工具 |
| M300 | 不支持。安卓 4.4 平台不在本次升级范围内 |
| M100 | 不支持读取媒体库，仅支持场景触发（跳过第 3 步） |
2. 添加驱动
将 MiYue.c4z 添加到本地驱动库后，在工程中搜索并添加驱动。
3. 设置 IP 地址
在驱动属性中填入米悦播放器的 IP 地址。
必须用 ARP 绑定或 DHCP 保留地址，不要在播放器上设固定 IP。
填完后检查驱动是否显示 online。
显示 offline 怎么排查
播放器能正常上网但驱动仍 offline 时，按下列顺序检查：
- VLAN 划分 —— 家庭局域网不要划 VLAN
- AP 隔离 / 客户端隔离 —— 必须关闭
- 网络延迟
提交故障时请附上完整的网络拓扑图，包含所有网络设备的品牌与型号，否则难以定位。
4. 扫描媒体库
M100 跳过本步骤。
在驱动的 ACTIONS 页点击 SCAN，等待扫描完成，全程约 3–5 分钟。
扫描完成后驱动属性会显示下载成功，此时才能正常操作。
警告 绝对不要对 offline 的设备执行 SCAN —— 会导致 Control4 主机死机。 务必先确认驱动在线再扫描。
5. 房间连接
在 Control4 系统内设置房间的音频终端连接：
Audio End-Point 1 → MiYue Audio Volume 1
配置完成后执行 Refresh Navigators，即可在 APP、电视机、触摸屏、遥控器界面正常使用。
6. 编程调用
驱动提供四类编程调用：
| 调用 | 作用 |
|---|---|
localmusic | 播放本地音乐 |
Playlist | 调用收藏的自定义歌单 |
Boards | 调用收藏的榜单 |
Radios | 调用收藏的电台 |
SENCE ACTION | 调用米悦内配置的场景 |
前提 歌单、榜单、电台只能调用已收藏的项目。 编程联动前需先在播放器或 Control4 内完成收藏操作。
场景调用
在米悦 APP 内编辑的场景，命令填 sences01 – sences10，内置 10 个场景可供调用。
自定义场景支持文字播报、自定义列表、天气预报等。
界面预览
相关文档
- Control4 驱动说明 V1.04（PDF） —— 旧版，含更多截图
- 刷机说明 —— M310 / M310B 升级固件