本指南提供適用於 Android TV 無障礙功能的最佳做法,並提供原生和非原生應用程式的相關建議。
無障礙功能對我的 TV 應用程式為何重要?
在看電視的人口中,視力受損者並不常見。世界衛生組織 (WHO) 報告指出,全球預估有 22 億人患有視障。根據 2018 年美國國家健康訪問問卷調查,美國有 3,200 萬名 18 歲以上的美國人遭遇大量視力受損的現象。歐洲的預估值指向 3,000 萬名失明和部分視障人士。
最重要的是,視障使用者同樣能觀看媒體內容,就如同他們完全視著他們一樣。Comcast 委託 2017 年進行的問卷調查顯示,有 96% 的失明或低視能使用者經常會看電視,且每天觀看電視的時間超過 81%。但有 65% 的受訪者也回報 在查詢電視節目時會遇到問題在 2020 年,英國的問卷調查中,80% 的身心障礙者表示,在隨選影片串流服務方面遇到無障礙功能的問題。
雖然輔助技術可以協助低視能使用者,但對於 TV 應用程式內容探索歷程而言,輔助無障礙功能至關重要。舉例來說,請特別留意並提供導航指引、妥善加上標籤元素,並確保 TV 應用程式可與 TalkBack 等無障礙功能正常運作。這些步驟可以大幅改善視障使用者的體驗。
改善無障礙體驗的第一步,就是打響知名度。本指南可協助您和您的團隊找出 TV 應用程式的無障礙功能問題。
Android 無障礙資源
如要進一步瞭解 Android 無障礙工具,請參閱無障礙開發資源。
文字縮放
Android TV 應用程式應支援不同的像素密度,遵循使用者對文字縮放的偏好。
請特別留意下列事項:
- 使用
wrap_content
做為 UI 元件中的尺寸。 - 確保版面配置會重新排列元件,因為元件大小會因文字比例而改變。
- 無論文字縮放比例,都必須確保元件仍能容納於螢幕上。
- 如果元件無法彈性調整,請勿使用 sp 文字大小單位。
查看
FONT_SCALE
值以便在自訂檢視畫面中進行調整:// Checking font scale with Context val scale = resources.configuration.fontScale Log.d(TAG, "Text scale is: " + scale)
可以使用下列指令來變更文字比例:
adb shell settings put system font_scale 1.2f
在 Android 12 以上版本中,使用者可以在裝置設定中變更文字縮放比例。
鍵盤配置
在 Android 13 (API 級別 33) 以上版本中,您可以使用 getKeyCodeForKeyLocation()
查詢按鍵碼來找出預期的按鍵位置。如果使用者已重新對應部分按鍵位置,或者使用的鍵盤沒有一般版面配置,就可能必須進行這項設定。
口述影像
在 Android 13 (API 級別 33) 以上版本中,使用者可以透過新的全系統無障礙功能偏好設定,在所有應用程式中啟用口述影像。Android TV 應用程式可以使用 isAudioDescriptionRequested()
查詢,確認使用者的偏好設定。
Kotlin
private lateinit var accessibilityManager: AccessibilityManager // In onCreate(): accessibilityManager = getSystemService(AccessibilityManager::class.java) // Where your media player is initialized if (am.isAudioDescriptionRequested) { // User has requested to enable audio descriptions }
Java
private AccessibilityManager accessibilityManager; // In onCreate(): accessibilityManager = getSystemService(AccessibilityManager.class); // Where your media player is initialized if(accessibilityManager.isAudioDescriptionRequested()) { // User has requested to enable audio descriptions }
Android TV 應用程式可在 AccessibilityManager
中新增事件監聽器,監控使用者的偏好設定變更情形:
Kotlin
private val listener = AccessibilityManager.AudioDescriptionRequestedChangeListener { enabled -> // Preference changed; reflect its state in your media player } override fun onStart() { super.onStart() accessibilityManager.addAudioDescriptionRequestedChangeListener(mainExecutor, listener) } override fun onStop() { super.onStop() accessibilityManager.removeAudioDescriptionRequestedChangeListener(listener) }
Java
private AccessibilityManager.AudioDescriptionRequestedChangeListener listener = enabled -> { // Preference changed; reflect its state in your media player }; @Override protected void onStart() { super.onStart(); accessibilityManager.addAudioDescriptionRequestedChangeListener(getMainExecutor(), listener); } @Override protected void onStop() { super.onStop(); accessibilityManager.removeAudioDescriptionRequestedChangeListener(listener); }