DiGiCo调音台控制技能
功能概述
DiGiCo调音台是专业级数字调音台，广泛应用于大型演出、音乐会、剧院、电视直播等场景。本技能通过OSC（Open Sound Control）协议实现远程控制和监控，让技术人员在无法物理接触设备时也能实时调整调音台参数。
核心功能
- 场景切换: 快速加载预设场景配置
- 通道控制: 调整输入/输出通道的增益、EQ、压缩等参数
- 输出路由: 管理音频信号的路由和分配
- 状态监控: 实时监控调音台运行状态
- 快照管理: 保存和调用场景快照
应用场景
- 演出实时调整: 演出过程中远程调整调音参数
- 彩排预设置: 提前配置场景参数，演出时快速切换
- 设备巡检: 定时检查调音台状态和连接性
- 故障诊断: 远程诊断调音台异常问题
使用方法
基础调用
from skill_digico_mixer import execute
# 连接调音台
result = execute(
action="connect",
ip="192.168.1.100",
port=12345
)
# 切换场景
result = execute(
action="load_scene",
scene_id=5
)
# 调整通道增益
result = execute(
action="set_channel_gain",
channel=12,
gain=-6.0
)
状态监控
# 获取调音台状态
status = execute(
action="get_status"
)
# 获取通道列表
channels = execute(
action="get_channels"
)
参数说明
连接参数
| 参数 | 类型 | 默认值 | 说明 |
|---|
| ip | str | 192.168.1.100 | DiGiCo调音台IP地址 |
| port | int | 12345 | OSC协议端口（DiGiCo默认端口） |
控制参数
| 参数 | 类型 | 范围 | 说明 |
|---|
| scene_id | int | 1-999 | 场景编号 |
| channel | int | 1-128 | 通道编号 |
| gain | float | -∞ to +12dB | 增益值（dB） |
| eq_band | str | low/mid/high | EQ频段 |
| eq_gain | float | -20 to +20 | EQ增益（dB） |
OSC协议路径
DiGiCo OSC协议标准路径：
/digico/scene/load - 加载场景/digico/channel/{id}/gain - 通道增益/digico/channel/{id}/eq - 通道EQ/digico/output/{id}/route - 输出路由/digico/status - 状态查询
示例
示例1：演出前预设置
# 连接调音台
execute(action="connect", ip="192.168.1.100")
# 加载演出场景
execute(action="load_scene", scene_id=10)
# 调整主唱通道
execute(
action="set_channel_gain",
channel=1,
gain=-3.0
)
# 添加压缩
execute(
action="set_channel_compressor",
channel=1,
threshold=-20,
ratio=4.0
)
# 保存快照
execute(action="save_snapshot", name="演出开场")
示例2：定时设备巡检
# 自动化巡检脚本（适合cron任务）
import schedule
def check_digico_status():
status = execute(action="get_status")
if status["cpu_usage"] > 80:
send_alert("DiGiCo CPU使用率过高")
if status["network_latency"] > 50:
send_alert("DiGiCo网络延迟异常")
# 每5分钟执行一次
schedule.every(5).minutes.do(check_digico_status)
示例3：故障诊断
# 检查调音台连接性
ping_result = execute(action="ping")
if ping_result["status"] == "success":
# 检查OSC端口
port_result = execute(action="check_port", port=12345)
# 获取错误日志
logs = execute(action="get_error_logs", lines=50)
print("诊断结果:", {
"ping": ping_result,
"port": port_result,
"errors": logs
})
注意事项
- 网络连接: 确保调音台和控制端在同一网络，或已配置正确的路由
- OSC端口: DiGiCo默认OSC端口为12345，确保未被防火墙拦截
- 权限要求: 需要调音台管理员权限才能执行某些控制操作
- 调用合规: 本技能支持人工触发和自动化触发两种方式
依赖要求
- Python OSC库：
python-osc
- 网络连接：TCP/IP协议支持
- DiGiCo调音台：OSC协议开放端口
# 安装依赖
pip install python-osc
技能信息
- 技能名称: skill_digico_mixer
- 优先级: P1（核心设备控制）
- 调用模式: both（人工+自动化）
- 推荐套餐: MiniMax（适合自动化场景）
- 版本: 1.0.0
