Animation Garden 项目中 BT 源自动选择问题的技术解析

问题背景

在 Animation Garden 项目的媒体选择器功能中，存在一个关于 BT 源自动选择的行为问题。当用户上次选择了 BT 源后，系统仍然会自动选择在线源，这与部分用户的预期行为不符。

技术分析

这个问题实际上涉及到媒体选择器的自动选择逻辑和用户偏好设置的交互。核心在于如何正确处理用户的历史选择偏好与自动选择机制之间的关系。

解决方案设计

项目维护者提出了一个修复方案，主要包含以下几个关键点：

1. 新增获取媒体偏好设置的数据流用例：创建了 GetMediaPreferenceFlowUseCase 接口及其实现类，用于获取用户对特定主题的媒体偏好设置。

2. 修改自动选择逻辑：在 MediaSelectorAutoSelectUseCaseImpl 中，增加了对用户偏好媒体源的检查逻辑。当检测到用户有明确的媒体源偏好时，会优先考虑该偏好设置。

3. 依赖注入配置：在 Koin 依赖注入配置中添加了新用例的绑定。

实现细节

修复方案的核心修改集中在自动选择逻辑上：

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 { "[MediaSelectorAutoSelect] preferredMediaSourceId '$preferredMediaSourceId' not in webSourceIds $webSourceIds" }
    return@launch
}

这段代码首先获取当前主题的用户偏好设置，然后检查用户偏好的媒体源是否在可用的网络源列表中。如果不匹配，则直接返回，不执行自动选择。

技术考量

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

1. 尊重用户选择：优先考虑用户明确设置的偏好，而不是盲目执行自动选择算法。

2. 数据流设计：使用 Kotlin Flow 来处理偏好设置的动态变化，保证UI能够响应设置的变化。

3. 模块化设计：通过新增 UseCase 来封装获取偏好设置的逻辑，保持代码的可维护性。

总结

这个修复方案通过增强媒体选择器的偏好感知能力，解决了 BT 源自动选择的问题。它不仅修复了当前的问题，还为未来可能的偏好设置扩展提供了良好的基础架构。这种基于用户偏好和上下文感知的设计思路，值得在其他类似功能中借鉴。