在 Unity 游戏中添加辅助功能

在 Unity 游戏中添加辅助功能

了解如何使用我们的开源辅助功能插件，使用户能够在 Apple 平台上更轻松地访问你的 Unity 游戏。跟着我们一起，在示例 Unity 游戏项目中添加对旁白和切换控制等辅助技术的支持。我们将向你介绍如何通过“动态类型”自动扩展文本，以及支持降低透明度或提高对比度等界面调整功能。

资源
相关视频

WWDC22
- 即插即用：向你的 Unity 游戏项目添加 Apple 框架
下载

♪ ♪
Eric Liang: 大家好我是 Eric 我很高兴可以为大家分享如何为您的 Unity 游戏添加辅助功能
辅助功能是为了让每个人都可以使用我们的产品今天我们为 Unity 开发者们提供的 Apple Accessibility 插件标志着我们向着无障碍游戏又前进了一大步为了让游戏支持辅助功能我们主要专注于三个 Apple 技术
旁白是一个帮助失明或低视力用户的屏幕阅读器它可以朗读屏幕上的内容用户也可以用自定义手势来与控件交互
切换控制让运动控制能力较弱的用户使用外部切换控制器来与设备交互还有动态字体让用户可以根据自身的阅读能力来设置字体大小
首先克隆代码库运用代码库根目录下的构建脚本来构建所有 Apple 插件接着这样会生成一个 Build 文件夹可以将其整合到您的 Unity 项目中最后用 Unity Package Manager 将 Apple Accessibility 插件添加到您的项目中您还可以查看代码库中的文档以及观看介绍所有 Apple 的 Unity 插件的视频课程 “Plug-in and play: Add Apple frameworks to your Unity game projects” 以获取更多细节现在您已经准备好了插件我将会从以下三个方面为大家讲解第一个是辅助功能元素这让您可以在游戏中增加辅助技术的支持如旁白或切换控制接下来是动态字体我们创建了这个易于使用的工具帮助您根据用户偏好设置来缩放字体还有 UI 适应性设置这些实用工具可以帮助您读取其它的用户偏好设置我们先来看下辅助功能元素
我创建了一个简易的卡牌游戏来帮助解释这个概念您可以看到您要点击 “Flip”按钮来随机抽取两张卡牌然而旁白不会朗读屏幕上的文本而外部切换控制器也不会点击按钮因为现在屏幕上只有像素我们要帮助系统理解哪些是可以进行交互的辅助功能元素定义了辅助技术可以交互的部分
文本卡牌和屏幕上的按钮都应该是辅助功能元素我们可以用标签来描述每个元素旁白会朗读标签这样用户能理解屏幕上的内容
如果游戏支持多语言我们也应该对标签进行本地化
现在旁白可以描述屏幕上的内容了但是它还不知道屏幕上还有一个可点击的按钮我们可以使用另一个属性称为“Traits” 来告知系统该元素的类型我们在这里添加 “Button”的特性现在旁白会朗读 “翻转按钮” 然后外部切换控制器可以控制该按钮
我们也可以添加在文本元素上添加“Static Text”特性 “Static Text”特性通常是赋予标签和文本区域的这样旁白可以提供更好的文本交互体验
除了“Button”和“Static Text”外还有很多特性是您可以探索的
那卡牌应该用什么特性呢我们不需要给每个辅助功能元素都运用特性卡牌就不需要任何特性然而卡牌上还有一个部分是旁白没有识别的那就是卡面值这里我们可以使用另一个属性称为“Value”
我们为每张卡牌添加了一个“Value”后旁白现在可以朗读 “卡牌 1 梅花 3” “卡牌 2 梅花 A” 就是这样现在您已经理解了基本原理我们打开 Unity 来看下可以如何将其添加到我们的项目中
现在我进入了游戏的 Unity 编辑器环境下我已经为这个项目中添加了 Apple Accessibility 插件
首先我们有常规的场景对象如相机定向光和 UI 画布在画布下面有两个文本元素和一个按钮然后我们有两个卡牌游戏对象
每个都由两个网格组件组成卡牌的每一面都渲染了对应的正反面纹理我们从定义辅助功能元素开始吧这需要插件中的 Accessibility Node 组件
选中层级结构中应该设置辅助功能的所有对象
添加 Accessibility Node 组件让它们成为辅助功能元素
接下来添加标签选择卡牌对象到右边的 “Accessibility Node”组件找到“Label”字段
确保 label 字段的复选框已选中以创建自定义标签
然后输入“Card 1”
对于 Card 2 也做同样的操作
文本和按钮也需要标签但如果我们用的是 Unity UI 的标准控件则不需要为它们提供一个显式的辅助功能标签插件已经默认实现了
接下来我们要为按钮添加一个特性
选择 Flip 按钮将“Traits”从“None” 修改为“Button”
选择两个文本元素
将“Traits”修改为“Static Text”
好了最后我们要为卡面值设置对应辅助功能数值由于卡牌是随机抽取的我需要添加脚本来动态设置卡面值
选择两张卡牌添加一个 AccessibleCard 的新脚本
首先在我另一个 C# 文件中所有卡牌正面都已经有了一个枚举称为 Playing Card 在我新的 AccessibleCard 这个 Mono Behaviour 脚本中设置了一个关于卡牌类型的变量和一个关于卡面上下朝向的布尔值
现在我们为这些卡牌添加 accessibilityValue 首先获取附属于这个 gameObject 的 accessibilityNode 组件
接下来将 accessibilityValue 代理设置为动态返回卡面值的函数
在函数中如果卡面朝下会在 accessibilityValue 中返回“covered” 如果卡面朝上我们会枚举所有卡面返回每张卡牌的描述如“黑桃 A” 就是这样现在我们来构建项目看下其实际运行情况这就是我们的游戏我们打开旁白
【自动语音: 旁白】开启 Eric 的游戏卡牌 2 面朝下【Eric】我可以向右滑动来移动到下一个元素【自动语音】卡牌 1 面朝下
Eric 的卡牌游戏
翻牌
Flip 按钮【Eric】您看现在所有五个对象都可以用旁白来访问太赞了当旁白开启时对这个要点击的按钮进行双击【自动语音】翻牌【Eric】我们再来看下卡牌
【自动语音】卡牌 1 梅花 2
卡牌 2 梅花 A 【Eric】旁白现在可以正确朗读更新后的卡面值这样很酷我们现在可以为数百万的旁白用户制作无障碍游戏了他们一定会很喜欢的还有使用外部切换控制器的用户也会玩我们的游戏这就是辅助功能元素接下来我们来看下动态字体
由于文本太小看不清对很多人来说玩游戏可能并不容易在 iOS 和 tvOS 中每个人可以根据自身阅读能力在设置中调整合适的字体大小
通过 Accessibility 插件您也可以读取该设置确保游戏的文本能按预期字体大小来显示
我们根据游戏示例来看下动态字体是如何使用的
创建一个 DynamicTextSize.cs 的 Mono Behaviour脚本在开始函数中首先将默认文本大小存储为变量然后在 OnEnable 函数中使用 AccessibilitySettings.onPreferredTextSizesChanged 来订阅 settingsChanged 事件这样用户在改变字体设置时我们可以马上更改 UI
接下来在 settingsChanged 函数中首先读取 PreferredContentSizeMultiplier 然后乘以您的原始字体大小然后分配回 Text 元素在 Unity 编辑器中选择有 Text 元素的所有游戏对象添加我们刚刚创建的 DynamicTextSize 组件
现在我们的游戏都设置好动态字体支持了我们看实际的运行效果前我先给大家演示下一个快速测试游戏中动态字体的方法打开设置找到控制中心
向下滚动直到看见字体大小将其添加到控制中心
现在我们通过打开控制中心改变字体大小选项就能快速调整字体大小了
很好我改变字体大小时游戏也会实时改变字体大小
控制中心中显示的字体百分比值正是我们从乘数读取的您也可以将这个设置应用到非文本对象中例如在字体大小增加时我可以将卡牌正面素材替换为 Large Print
首先我创建一个 DynamicCardFaces 脚本然后和之前一样订阅 TextSizeChanged 事件
这次不是读取乘数而是读取一个字体大小类别的枚举它被映射到控制中心滑块的刻度上有人选择大号字体的时候我就可以替换素材
我只要在常规材质和大号印刷体材质之间选择即可现在如果我们选择了非常大的字体
用户可能会看到大号印刷体的卡牌对于低视力的用户来说这种卡牌正面的易读性很强
最后我跟大家分享下您可以用这个插件访问 UI 适应性设置
第一个设置是 Reduce Transparency 开启这个设置后背景变成不透明而不是模糊或透明效果文本在这些效果下难以识别时该设置可以提高易读性调用 AccessibilitySettings. IsReduceTransparencyEnabled 来查看这个偏好设置
接下来是 Increase Contrast 设置深灰色的开关会更显眼在整个设备中也会更易于识别
您可以使用 AccessibilitySettings.IsIncreaseContrastEnabled 来查看这一设置启用后即可增加 UI 对比度
接下来是 Reduce Motion 设置有些人对手势很敏感正如我们在这个翻牌动画中一样
Reduce Motion 启用时我们应该移除该动画
我们看下实现的代码
在我们的 CardController 脚本中有这个 Flip 函数首先我们看下用户的 Reduce Motion 设置是否开启如果没有开启我们应通过 Coroutine 调用动画来翻牌否则就只是设置单纯旋转而不带动画就这样现在对手势比较敏感的用户也能享受我们的游戏了回顾一下首先通过克隆这个讲座资源关联的 GitHub 数据库来开启 Apple 辅助功能插件
添加辅助功能元素这样用户可以在游戏中使用旁白和切换控制
用动态字体来调整字体大小
检查 UI 适应性设置这样每个人都能对游戏有绝佳的体验
感谢大家的参与我们很期待能看到您的游戏有完美的无障碍体验

public enum PlayingCard
{
    AceOfSpade,
    AceOfClubs,
    AceOfDiamonds
}

7:53 - AccessibleCard class

using Apple.Accessibility;
public class AccessibleCard : MonoBehaviour 
{
    public PlayingCard cardType;
    public bool isCovered;
    void Start()
    {
        var accessibilityNode = GetComponent<AccessibilityNode>();
        accessibilityNode.accessibilityValueDelegate = () => {
            if (isCovered) {
              return "covered";
            }
            if (cardType == PlayingCard.AceOfSpades) {
              return "Ace of Spades";
            }
        }
    }
}

10:35 - DynamicCardFaces

public class DynamicCardFaces : MonoBehaviour
{
    public Material RegularMaterial;
    public Material LargeMaterial;
    void OnEnable()
    {
        AccessibilitySettings.onPreferredTextSizesChanged += _settingsChanged;
    }

    void _settingsChanged() 
    {
        var shouldUseLarge = AccessibilitySettings.PreferredContentSizeCategory >= 
            ContentSizeCategory.AccessibilityMedium;
        GetComponent<Renderer>().material = shouldUseLarge ? RegularMaterial :
            LargeMaterial;
    }
}

10:36 - Dynamic Type

using UnityEngine.UI;
public class DynamicTextSize : MonoBehaviour
{
    int originalSize;
    void Start()
    {
        originalSize = GetComponent<Text>().textSize;
    }

    void OnEnable()
    {
        AccessibilitySettings.onPreferredTextSizesChanged += _settingsChanged;     }

    void _settingsChanged() 
    {
        GetComponent<Text>().textSize = (int)(originalSize *
            AccessibilitySettings.PreferredContentSizeMultiplier);
    }
}

14:54 - Reduce motion

using Apple.Accessibility;
public class CardController : MonoBehaviour
{
    public void Flip() 
    {
        var reduceMotionOn = !AccessibilitySettings.IsReduceMotionEnabled;
        if (!reduceMotionOn)
        {
            StartCoroutine(Animate());
        }
        else 
        {
            transform.rotation = Quaternion.identify;
        }
    }
    IEnumerator Animate()
    {
    } 
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。

提交你查询的内容时出现错误。请检查互联网连接，然后再试一次。

资源

相关视频

WWDC22