Android无障碍开发：实现按钮获焦与点击后朗读不同文本

焦点获取时朗读按钮内容 #

Android系统的TalkBack服务默认会在按钮获得焦点时，自动朗读按钮的文本内容（或contentDescription属性值，若已设置）。针对你的需求：

• 若按钮显示文本为“OK”，无需额外代码，TalkBack在焦点获取时会自动朗读“OK”；
• 若需要自定义焦点朗读内容，可在布局或代码中设置按钮的contentDescription：
  布局中：

  <Button
      android:id="@+id/okButton"
      android:text="OK"
      android:contentDescription="OK" />
  

  代码中（Kotlin）：

  okButton.contentDescription = "OK"
  

点击按钮后朗读指定文本 #

可以通过系统无障碍API实现点击后的自定义播报，推荐两种方式：

方式一：兼容多数Android版本（API 16+）

使用AccessibilityManager发送播报事件，遵循系统无障碍设置：

val okButton = findViewById<Button>(R.id.okButton)
okButton.setOnClickListener {
    val accessibilityManager = getSystemService(Context.ACCESSIBILITY_SERVICE) as AccessibilityManager
    if (accessibilityManager.isEnabled) {
        val announcementEvent = AccessibilityEvent.obtain(AccessibilityEvent.TYPE_ANNOUNCEMENT)
        announcementEvent.text = listOf("正在跳转至其他页面")
        accessibilityManager.sendAccessibilityEvent(announcementEvent)
        // 此处添加你的跳转逻辑
    }
}

方式二：Android 12+推荐方案

使用AnnouncementManager（专门用于无障碍播报的API）：

val okButton = findViewById<Button>(R.id.okButton)
okButton.setOnClickListener {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        val announcementManager = getSystemService(AnnouncementManager::class.java)
        announcementManager?.announce("正在跳转至其他页面", null)
        // 此处添加你的跳转逻辑
    }
}

注意事项 #

• 确保设备已开启TalkBack服务（设置 -> 无障碍 -> 屏幕阅读器 -> TalkBack）；
• 使用系统API播报会自动适配用户的无障碍偏好（如语速、音量），比自行集成TextToSpeech更符合无障碍规范；
• 若为自定义控件，需重写onInitializeAccessibilityNodeInfo方法，正确设置焦点时的朗读内容，保证TalkBack能识别。

内容的提问来源于stack exchange，提问作者spaceshipsoverglasgow