OwnTone服务器API扩展：实现音乐文件同步与播放统计功能

概述

OwnTone作为一款开源的媒体服务器软件，近期对其API进行了重要扩展，新增了音乐文件下载、播放统计更新等功能，为开发者构建音乐同步应用提供了更完善的支持。这些改进特别适合需要实现类似iTunes无线同步功能的移动应用开发场景。

文件下载功能实现

OwnTone提供了两种HTTP协议方式获取音乐文件资源：

1. DAAP协议方式： 开发者可以通过向/databases/1/items/[TRACK_ID].dat端点发送请求来获取指定ID的音乐文件。例如使用curl命令：

curl --header "Accept-Codecs: mpeg" http://服务器地址:3689/databases/1/items/8.dat -o 音乐文件.mp3

2. RSP协议方式： 作为替代方案，也可以使用RSP协议的/rsp/stream/[TRACK_ID]端点：

curl --header "Accept-Codecs: mpeg" http://服务器地址:3689/rsp/stream/8 -o 音乐文件.mp3

重要特性：

• 支持通过Accept-Codecs请求头指定可接受的编码格式（如mpeg、alac、flac、wav等）
• 默认情况下文件下载会触发播放统计更新（播放次数+1，最后播放时间更新）
• 新增no_register_playback=1参数可禁用统计更新，适合同步场景

播放统计管理API

OwnTone新增了完善的播放统计管理接口：

1. 跳过次数统计： 新增了对跳过次数(skip_count)的更新支持，填补了此前只有播放次数(play_count)和评分(rating)可更新的空白。

2. 时间戳设置： 现在不仅可以更新播放/跳过次数，还能通过以下参数设置相关时间戳：

• time_played：设置最后播放时间
• time_skipped：设置最后跳过时间

注意事项：

• 时间戳参数不能设置为0值
• 这些功能特别适合离线场景下的数据同步

专辑封面获取

虽然音乐文件可能内嵌了封面图，但OwnTone提供了更便捷的获取方式：

• 通过API返回的artwork_url字段可直接获取专辑封面
• 该接口同时支持服务器存储的封面和文件内嵌封面

应用场景建议

这些API扩展特别适合以下开发场景：

1. 音乐同步应用： 构建类似iTunes的无线同步功能，定期将OwnTone服务器上的播放列表同步到移动设备。

2. 全功能音乐播放器： 开发能够与OwnTone服务器双向同步的播放器应用，包括：

• 音乐文件同步
• 播放统计同步（播放次数、跳过次数）
• 评分同步
• ID3标签编辑

3. 离线使用支持： 利用新增的时间戳设置功能，可实现离线播放时的数据缓存，待重新连接服务器后再同步统计信息。

实现建议

对于开发者而言，建议：

1. 文件下载优先使用RSP协议方式，因其语义更明确
2. 同步场景务必添加no_register_playback=1参数
3. 对于时间戳管理，客户端应维护本地缓存，定期批量同步
4. 封面获取可结合缓存机制提升性能

这些API扩展使OwnTone在个人音乐管理方面更加完善，为开发者构建全功能的音乐同步和播放应用提供了坚实基础。