OwnTone服务器中排除含单引号的AirPlay设备配置指南

在使用OwnTone媒体服务器时，用户可能会遇到需要排除特定AirPlay设备的情况，特别是当设备名称中包含特殊字符（如单引号）时。本文将详细介绍如何正确配置OwnTone以排除这些特殊命名的设备。

问题背景

当AirPlay设备名称中包含单引号（如"Tom's HomePod"）时，在OwnTone配置文件中直接使用该名称进行排除可能会遇到匹配问题。这是因为设备名称在OwnTone界面显示时可能经过大小写转换处理，导致实际配置时需要特别注意名称的精确匹配。

解决方案

方法一：精确匹配设备名称

在OwnTone配置文件中，可以使用以下语法排除特定设备：

airplay "设备完整名称" {
    exclude = true
}

对于包含单引号的设备（如"Tom's HomePod"），配置示例如下：

airplay "Tom's HomePod" {
    exclude = true
}

方法二：获取设备精确名称

如果直接配置无效，可能是因为界面显示的名称与实际名称存在差异。可以通过以下方式获取设备精确名称：

1. 访问OwnTone的API接口（默认端口3689）查看输出设备列表
2. 通过浏览器开发者工具检查网页元素，获取设备原始名称

注意事项

1. 名称匹配区分大小写，必须与设备注册名称完全一致
2. 界面显示可能对名称进行了样式处理（如大写转换），但配置时需要原始名称
3. 特殊字符（如单引号）需要完整包含在引号中

配置验证

配置完成后，建议重启OwnTone服务并通过以下方式验证：

1. 检查日志文件确认配置是否生效
2. 在Web界面或客户端查看设备列表，确认目标设备已被排除
3. 测试播放功能，确保音频不会路由到已排除设备

通过以上方法，用户可以有效地在OwnTone中排除包含特殊字符的AirPlay设备，实现更精确的音频输出控制。