Ani 项目中的媒体源自动选择机制优化

在 Ani 项目中，媒体源自动选择功能是影响用户体验的关键组件之一。最近开发团队发现并修复了一个关于 BT 源和在线源选择优先级的问题，这为我们提供了一个深入了解媒体选择机制的良好案例。

问题背景

在视频播放场景中，Ani 应用需要从多种媒体源（包括 BT 种子和在线流媒体）中选择最合适的播放源。系统设计了一个自动选择机制，它会根据用户偏好、网络条件等因素智能选择最优媒体源。

技术实现分析

Ani 的媒体选择系统核心由几个关键组件构成：

1. 媒体偏好设置存储：通过 EpisodePreferencesRepository 持久化用户对特定剧集的媒体源偏好
2. 选择策略控制器：MediaSelectorAutoSelectUseCase 负责执行自动选择逻辑
3. 源可用性检查：GetWebMediaSourceInstanceFlowUseCase 提供当前可用的在线媒体源列表

问题本质

原始实现中存在一个逻辑缺陷：当用户曾经选择过 BT 源后，系统在后续自动选择时仍可能优先选择在线源，这与用户预期行为不符。这主要是因为自动选择逻辑没有充分考虑用户的历史偏好设置。

解决方案架构

修复方案引入了几个关键改进：

1. 新增偏好查询接口：创建了 GetMediaPreferenceFlowUseCase 专门负责获取用户媒体偏好
2. 增强选择逻辑：在自动选择前先检查用户是否设置了特定偏好
3. 源类型验证：确保用户偏好的源类型在当前环境下可用

核心修改体现在 MediaSelectorAutoSelectUseCaseImpl 中新增的偏好检查逻辑：

val subjectId = session.request.first().subjectId.toInt()
val mediaPreference = getMediaPreferenceFlowUseCase(subjectId).first()
val webSourceIds = getWebMediaSourceInstanceFlowUseCase().first()
val preferredMediaSourceId = mediaPreference.mediaSourceId

if (preferredMediaSourceId != null && preferredMediaSourceId !in webSourceIds) {
    logger.info { "preferredMediaSourceId not in webSourceIds" }
    return@launch
}

技术决策考量

这个修复体现了几个重要的设计原则：

1. 用户意图优先：明确将用户显式选择置于自动选择逻辑之上
2. 上下文感知：在选择前验证偏好源的实际可用性
3. 关注点分离：通过新增 UseCase 保持代码职责单一

系统架构影响

这一改动虽然看似简单，但对系统架构产生了积极影响：

1. 明确了媒体偏好数据的获取路径
2. 强化了自动选择策略的可预测性
3. 为未来可能增加的源类型选择逻辑预留了扩展点

总结

Ani 项目通过这次修改，完善了媒体源选择的智能程度，更好地尊重了用户的选择偏好。这种基于用户显式偏好来优化自动决策的机制，在很多类似的智能推荐系统中都有广泛应用价值。