第3章：动态内容描述 —— 使用 MutableState 更新描述，结合 LiveData / Flow

3.1 原理：Compose 状态驱动的无障碍属性更新

Compose 的无障碍属性（如 contentDescription、stateDescription）本质是 SemanticsPropertyReceiver 的可组合属性。当组件因状态变化触发重组时，Semantics 树对应节点会被重新构建，无障碍服务即可读到最新的描述。

核心机制：

• Snapshot 系统：MutableState 写入会标记当前 Composition 为“脏”，Compose 在下一帧执行重组。
• 重组粒度：仅读取该 State 的 Composable 函数会重组，其内部设置的 contentDescription 会重新应用。
• 异步数据流：LiveData / Flow 通过 .collectAsState() 转换为 Compose 可观察的 State，同样驱动重组。

3.2 实现流程

1. 定义状态：使用 mutableStateOf 或 remember { mutableStateOf(...) }。
2. 绑定描述：在组件的 .semantics {} 块中读取状态变量。
3. 状态变更：通过用户交互、网络回调、定时器等修改状态。
4. 自动刷新：Compose 重组并更新 Semantics 树，无障碍服务监听变化。

3.3 代码实现：可切换开关的动态描述

以下示例展示一个自定义开关，其无障碍描述随激活状态实时变化。

@Composable
fun DynamicAccessibleToggle(
    isChecked: Boolean,
    onCheckedChange: (Boolean) -> Unit
) {
    // 将外部状态转为内部 MutableState（或直接使用外部 State 也可）
    val checkedState = remember { mutableStateOf(isChecked) }

    // 根据当前值动态生成描述
    val description by remember {
        derivedStateOf {
            if (checkedState.value) "开关：已开启" else "开关：已关闭"
        }
    }

    Switch(
        checked = checkedState.value,
        onCheckedChange = { newValue ->
            checkedState.value = newValue
            onCheckedChange(newValue)
        },
        modifier = Modifier.semantics {
            contentDescription = description
            // 可额外设置 stateDescription 补充状态含义
            stateDescription = if (checkedState.value) "开启" else "关闭"
        }
    )
}

3.4 结合 LiveData / Flow：从 ViewModel 推送描述

在实际项目中，无障碍描述往往依赖异步数据（如网络加载结果、传感器数据）。推荐使用 LiveData 或 Flow，并通过 collectAsState() 注入 Compose 层。

// ViewModel 层
class MyViewModel : ViewModel() {
    private val _statusDescription = MutableLiveData("正在加载...")
    val statusDescription: LiveData = _statusDescription

    fun loadData() {
        viewModelScope.launch {
            _statusDescription.value = "加载中"
            delay(2000)
            _statusDescription.value = "数据已就绪，共 3 条记录"
        }
    }
}

// Composable 层
@Composable
fun StatusDisplay(viewModel: MyViewModel) {
    val description by viewModel.statusDescription.observeAsState("初始")

    Text(
        text = "状态区域",
        modifier = Modifier
            .semantics {
                contentDescription = description
            }
            .clickable { viewModel.loadData() }
    )
}

使用 Flow 类似：

// ViewModel
val statusFlow: StateFlow<String> = MutableStateFlow("等待")

// Composable
val description by viewModel.statusFlow.collectAsState()
Text(
    text = "Flow 状态",
    modifier = Modifier.semantics { contentDescription = description }
)

3.5 SVG：状态驱动无障碍描述更新流程

3.6 调试与验证

• Layout Inspector：在 Android Studio 中捕获视图树，查看 Semantics 节点下的 contentDescription 是否随状态变化。
• 无障碍测试套件：启用 TalkBack 或 Switch Access，实际操作组件确认朗读内容正确。
• 日志输出：在 .semantics {} 中临时添加 .testTagsAsResourceId = true 结合 Log.d 输出当前描述。

3.7 常见错误

3.8 性能与稳定性优化

• 使用 derivedStateOf 减少计算：只在依赖状态变化时重新计算描述字符串。
• 避免在 Semantics 块中执行复杂逻辑：semantics {} 块可能在每帧被调用，应保持轻量。
• 合理控制 State 作用域：将状态提升到最低公共父组件，避免重组扩散。
• Flow 使用 .stateIn 共享：在 ViewModel 中将普通 Flow 转为 StateFlow 以消除重复收集。

// 优化示例：使用 stateIn 共享 Flow
val uiState: StateFlow<UiState> = someFlow
    .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), UiState.Loading)

通过以上方法，你已掌握了如何在 Compose 中使用 MutableState 及 LiveData/Flow 动态更新无障碍描述。下一环节将深入 Semantics 属性树的精细控制。