音视频【免费下载链接】shairport-syncAirPlay and AirPlay 2 audio player项目地址https://gitcode.com/gh_mirrors/sh/shairport-sync点击查看免费下载本文以 Shairport Sync 仓库中的 ADDINGTOHOME.md 为操作主线完整讲解如何把一台以 AirPlay 2 模式运行的 Shairport Sync 设备添加到 iOS 的 Apple Home家庭应用中。文章先交代必须满足的构建与环境前提再逐步拆解 Home 应用内的“Speaker TV 访问”设置与配对流程最后结合仓库源码与配置文件说明 HomeKit 配对在 Shairport Sync 内部的实现机制与常见排查方向。读完本文你将能够独立完成从 AirPlay 2 构建、服务运行到 Home 应用添加设备的全流程配置。一、适用范围与前置条件原文档明确指出Shairport Sync 必须以 AirPlay 2 支持的方式构建才能在 Apple Home 应用中被发现和添加参见 ADDINGTOHOME.md。只有 AirPlay 2 模式才具备 HomeKit 集成能力——这与经典 AirPlayAirPlay 1有本质区别AirPlay 2 协议提供多房间操作与 Home 应用集成能力但 Shairport Sync 的 Home 集成目前属于“有限支持”并非所有功能均可用RELEASENOTES.md 明确记录“Limited support is available for HomeKit -- Shairport Sync speakers can be added to the Home app, though not all features are working”。经典 AirPlay 不集成 Home 应用也无法与 HomePod 兼容CONFIGURATION FLAGS.md。因此在执行本指南前请确认以下前提构建参数编译时启用--with-airplay-2配置标志。该标志会同时自动启用 FFmpeg 支持--with-ffmpeg对 AirPlay 2 是强制随附的并强制要求--with-sslopensslAirPlay 2 操作必须使用 OpenSSL 库与--with-avahiAirPlay 2 必须使用 Avahi 进行 Zeroconf/Bonjour 广播——详见 CONFIGURATION FLAGS.md。配套程序 NQPTPAirPlay 2 的时钟同步依赖配套应用 NQPTP它必须独占 UDP 端口319与320且这两个端口不能被防火墙拦截AIRPLAY2.md。系统与硬件建议使用至少相当于 Raspberry Pi B 级别性能、可访问低端口号的 Linux/FreeBSD/OpenBSD 系统因实时性要求虚拟机输出到 ALSA/PipeWire/PulseAudio 的场景效果不佳AIRPLAY2.md。服务运行确保avahi-daemon已启用并启动Shairport Sync 正在以 AirPlay 2 模式对外广播_airplay._tcp服务BUILD.md。二、Home 应用内的配置与配对步骤以下操作步骤直接继承自 ADDINGTOHOME.md原文基于iOS 15.3.1的 Home 应用界面描述。Step 0设置“Speaker TV 访问”权限这是整个流程中最容易被忽略的前提。打开Home家庭应用 → 家庭设置找到“允许扬声器与电视访问”Allow Speaker TV access选项选择“同一网络上的任何人”Anyone On the Same Network。如果在该选项下方出现“需要密码”require password选项务必确保其处于未勾选状态。该设置决定了同一局域网内的其他 Apple 设备是否有权发现并配对新的 AirPlay 2 扬声器/电视配件勾选密码要求会阻断后续的自动发现流程。Step 1打开 Home 应用并进入添加配件打开Home家庭应用。点击“添加配件”Add Accessory面板或点击右上角的符号从菜单中选择“添加配件”。Step 2选择“更多选项...”在配件发现列表界面点击“更多选项...”More options...进入手动扫描/局域网设备列表。你的 Shairport Sync 设备不会作为“附近配件”自动弹出必须通过此入口在局域网设备列表中查找。Step 3选择你的 Shairport Sync 设备在设备列表中滚动查找你的 Shairport Sync 设备点击其图标然后按界面提示完成剩余的配对确认。配对成功后该设备即出现在 Home 应用中可以被其他 Apple 设备作为 AirPlay 2 目标进行音频输出。三、配对背后的源码实现HomeKit 配对协议从源码结构看Shairport Sync 的 AirPlay 2 模式能够被 Home 应用识别依赖两套机制mDNS/Bonjour 服务广播与HomeKit 配对pairing协议。3.1 Bonjour 服务广播AirPlay 2 设备通过 Zeroconf/Bonjour 对外广播_airplay._tcp服务。在 bonjour_strings.c 中build_bonjour_strings()函数会构建一组次要文本记录secondary TXT records其中包含deviceid由设备 MAC 地址计算出的 AirPlay 设备标识features与flags设备能力位与状态标志model、srcvers、osvers型号、协议版本与系统版本pi/psi/gid设备 UUID 与群组标识相关字段定义见 common.h。Home 应用正是依靠这些广播信息在局域网中发现 Shairport Sync 设备并判断其是否支持 HomeKit 配对。若设备未出现在“更多选项”列表中可从广播层面排查见第五节。3.2 HomeKit 配对协议实现配对逻辑由仓库内嵌的pair_ap库提供。pair_ap是一个 C 语言实现的 Apple 配对客户端/服务端库覆盖 Apple TV 设备验证fruit 模式与HomeKit 配对两类场景pair_ap/README.md。服务端实现位于 pair_ap/pair_homekit.c其中定义了pair_server_homekitpair_ap/pair_homekit.c等配对定义结构配对流程遵循 HomeKit 规范先由 Home 应用发起/pair-setup完成双方 ID 与公钥注册此后每次连接通过/pair-verify验证身份并协商出用于后续加密通信的共享密钥pair_ap/README.md通过/pair-addHome 控制器可将网络中其他设备的 ID 与公钥同步给所有配件实现“一次配对、全网可用”pair_ap/README.md。这段实现解释了为什么需要--with-airplay-2构建AirPlay 2 分支才包含CONFIG_AIRPLAY_2编译单元才会编译 HomeKit 配对相关代码并广播对应的服务记录。四、运行时配置要点构建参数之外运行时的配置文件 scripts/shairport-sync.conf 中还有几个与 Home 集成直接相关的选项general { // name %H; // 设备在局域网中广播的名称默认为主机名首字母大写 // service_type auto; // auto | airplay2 | classic // airplay_device_id 0x六位十六进制数L; // (AirPlay 2 only) 自定义 deviceid注意结尾的 L // airplay_device_id_offset 0; // (AirPlay 2 only) 在默认 deviceid 基础上增加偏移量 };service_type默认auto表示在检测到 NQPTP 存在时提供 AirPlay 2 服务否则回退到 classic 模式并在服务名后追加(Classic)。要保证设备能加入 Home 应用应确认该值解析为airplay2scripts/shairport-sync.conf。airplay_device_id/airplay_device_id_offset默认 deviceid 由设备某个 MAC 地址计算而来。若同一局域网内存在多台硬件配置相同的设备导致 ID 冲突可通过这两个选项手工指定scripts/shairport-sync.conf。五、常见问题与排查方向结合仓库文档与源码整理以下排查要点设备不在“更多选项”列表中优先确认 Shairport Sync 确实以 AirPlay 2 模式构建并运行shairport-sync -V输出应包含AirPlay2见 scripts/shairport-sync.conf其次确认avahi-daemon正常运行且_airplay._tcp广播可达。端口被占用导致服务不可用NQPTP 依赖的端口319/320必须空闲且不被防火墙拦截macOS 上因系统已占用这两个端口Shairport Sync 无法在 Mac 上以 AirPlay 2 模式运行AIRPLAY2.md。“需要密码”勾选导致配对失败回到 Step 0确认“允许扬声器与电视访问”设置为“同一网络上的任何人”且密码要求未勾选。功能不完整属预期行为Home 应用集成是有限支持远程控制等功能并未全部实现RELEASENOTES.md、CONFIGURATION FLAGS.md不要将“部分功能不可用”误判为配对失败。六、小结把 Shairport Sync 加入 Apple Home 应用本质上是一次“AirPlay 2 构建 mDNS 广播 HomeKit 配对”的组合验证先用--with-airplay-2连带--with-sslopenssl与--with-avahi构建并运行服务确认 NQPTP 与端口319/320正常再在 Home 应用中按“允许扬声器与电视访问 → 添加配件 → 更多选项 → 选择设备”四步完成配对。仓库内的 ADDINGTOHOME.md、AIRPLAY2.md、CONFIGURATION FLAGS.md 与 pair_ap/pair_homekit.c 提供了从操作到协议实现层面的完整依据可供后续深入研读。赞分享音视频【免费下载链接】shairport-syncAirPlay and AirPlay 2 audio player项目地址https://gitcode.com/gh_mirrors/sh/shairport-sync点击查看免费下载相关推荐shairport-sync 的 pair_ap 配对库AirPlay 2 HomeKit 配对与 Apple TV 设备验证协议解析shairport sync 的 pair_ap 配对库AirPlay 2 HomeKit 配对与 Apple TV 设备验证协议解析 导读 AirPlay音视频如何快速掌握AirPlay 2元数据加密Shairport Sync中TLV格式完整解析指南如何快速掌握AirPlay 2元数据加密Shairport Sync中TLV格式完整解析指南 Shairport Sync是一款开源的AirPlay音频接收器音视频如何快速部署Shairport Sync非Apple设备的终极AirPlay音频流解决方案如何快速部署Shairport Sync非Apple设备的终极AirPlay音频流解决方案 还在为无法将iPhone或Mac上的音乐无线传输到Linux设备而音视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考