AzuraCast 中实现 YouTube 直播流显示播放列表名称的技术方案

在 AzuraCast 流媒体服务器中，用户经常需要将电台内容通过 YouTube 进行直播。一个常见需求是在直播画面上显示当前播放的播放列表名称，而非歌曲元数据。本文将详细介绍如何通过 Liquidsoap 脚本实现这一功能。

技术背景

AzuraCast 使用 Liquidsoap 作为其流媒体处理引擎，提供了强大的音频处理和流媒体传输能力。对于 YouTube 直播，通常需要将音频流与视频画面结合，并在画面上叠加文字信息。

核心实现方案

基础配置

首先需要准备以下基本配置：

• 视频循环文件路径
• 字体文件路径
• YouTube 直播密钥
• 电台基础目录

API 集成

通过 AzuraCast 的 API 获取播放列表信息是关键步骤。需要：

1. 创建 API 密钥
2. 设置 API 请求端点
3. 实现 API 请求函数

播放列表名称获取

使用 Liquidsoap 的元数据处理功能，通过 playlist_id 获取播放列表名称：

def update_playlist(m)
    pl = m["playlist_id"]
    if pl != "" then
      url = "playlist/" ^ pl
      let json.parse ({name} : {name: string}) = azuracast_api_get(url)
      show_text := "Playlist: " ^ name
    else
      show_text := "Playlist: -"
    end
end

文字叠加技术

方法一：直接文字叠加

使用 video.add_text 操作符直接在视频流上叠加文字：

videostream = video.add_text(color=0xFFFFFF, font=font_file, 
                           x=340, y=990, size=50, show_text, videostream)

方法二：通过文本文件

对于需要特殊文字处理（如 RTL 语言）的情况，可以先将文字写入文件，再通过 FFmpeg 处理：

def add_nowplaying_text(s) =
  def mkfilter(graph)
    video_track = ffmpeg.filter.drawtext(fontfile=font_file,
                                       textfile=nowplaying_playlist,
                                       reload=5, graph, video_track)
  end
  ffmpeg.filter.create(mkfilter)
end

常见问题解决

1. 文字方向问题：对于 RTL 语言，直接使用 video.add_text 可能出现文字反向显示。解决方案是使用 FFmpeg 的 drawtext 滤镜或等待 video.add_text.ffmpeg 功能可用。

2. 文件权限问题：确保 Liquidsoap 有权限写入临时文本文件，并正确设置文件所有者。

3. 数据更新延迟：通过多次调用更新函数确保数据及时刷新：

radio.on_track(fun(_) -> thread.run(update_playlist, fast=false))
radio.on_track(fun(_) -> thread.run(update_playlist, delay=10., fast=false))

最佳实践建议

1. 对于简单需求，优先使用 video.add_text 直接叠加文字
2. 对于复杂文字处理需求，采用文本文件中转方案
3. 确保 API 请求有适当的错误处理和超时设置
4. 定期检查 Liquidsoap 日志，监控文字更新状态
5. 考虑使用系统字体以确保兼容性

通过以上方案，用户可以在 AzuraCast 的 YouTube 直播流中稳定显示播放列表名称，满足各种语言和显示需求。