Shairport Sync项目MQTT功能详解与配置指南-优快云博客

Shairport Sync项目MQTT功能详解与配置指南

shairport-sync 项目地址: https://gitcode.com/gh_mirrors/sh/shairport-sync

一、Shairport Sync与MQTT集成概述

Shairport Sync作为一款优秀的AirPlay音频接收器，其MQTT功能扩展为智能家居和自动化系统提供了强大的集成能力。通过MQTT协议，Shairport Sync可以将音频播放状态、元数据等信息实时发布到MQTT消息服务器，实现与其他智能设备的联动控制。

二、MQTT功能启用步骤

2.1 环境准备

首先需要确保系统已安装MQTT客户端库：

apt install libmosquitto-dev

2.2 编译配置

在编译Shairport Sync时添加MQTT支持选项：

./configure --with-mqtt-client --sysconfdir=/etc --with-alsa --with-avahi --with-ssl=openssl --with-systemd

验证是否成功启用MQTT功能：

shairport-sync -V

输出中应包含mqtt标识，例如：

3.3.8-OpenSSL-Avahi-ALSA-metadata-mqtt-sysconfdir:/etc

三、MQTT配置详解

3.1 基础配置

在配置文件中添加MQTT相关设置：

mqtt = {
    enabled = "yes";  // 启用MQTT功能
    hostname = "192.168.1.111";  // MQTT消息服务器地址
    port = 1883;  // MQTT服务端口
    username = "username";  // 认证用户名
    password = "password";  // 认证密码
    topic = "shairport";  // 发布主题
};

3.2 元数据处理选项

Shairport Sync提供三种元数据发布模式：

原始数据模式 (publish_raw)：发布所有可用元数据，使用标准4字符代码
解析数据模式 (publish_parsed)：发布经过解析的人性化主题数据
封面艺术模式 (publish_cover)：发布二进制格式的专辑封面

publish_parsed = "yes";  // 推荐启用
publish_cover = "yes";  // 如需封面则启用

四、元数据类型解析

4.1 元数据分类

Shairport Sync处理的元数据分为两大类：

核心元数据 (core)：来自音源设备(iOS/iTunes等)
- asal：专辑名称
- asar：艺术家
- minm：曲目标题
- astm：歌曲时长
Shairport Sync元数据 (ssnc)：由Shairport Sync生成
- PICT：专辑封面图像(JPEG/PNG)
- clip：客户端IP地址
- pbeg/pend：播放开始/结束标记
- pvol：音量信息

4.2 活动状态跟踪

通过active_start和active_end主题可以监控AirPlay会话状态：

sessioncontrol = {
    active_state_timeout = 30.0;  // 超时设置(秒)
};

五、智能家居集成示例

5.1 Home Assistant配置

状态传感器配置：

binary_sensor:
  - name: "AirPlay活动开始"
    state_topic: "shairport/active_start"
    payload_on: "--"

元数据传感器配置：

sensor:
  - name: "当前艺术家"
    state_topic: "shairport/artist"
    expire_after: 600  # 10分钟后过期

音量转换示例：

sensor:
  - name: "音量百分比"
    state_topic: "shairport/volume"
    value_template: >
      {{ value | regex_findall_index(find='^(.+?),', index=0) | float / 30 + 1 }}
    unit_of_measurement: '%'

5.2 Homebridge集成

通过MQTTThing插件实现HomeKit集成：

{
    "type": "contactSensor",
    "name": "AirPlay状态",
    "topics": {
        "getContactSensorState": "shairport/active"
    },
    "onValue": "1",
    "offValue": "0"
}