> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Handheld Compatibility 准则与测试用例 > 遵循 Handheld Compatibility 计划五条准则的通过/失败测试步骤,涵盖默认值、图标提示、文本输入、HDR 与电源管理。 由 XBOX 设计的 Handheld Compatibility 计划,是对来自 XBOX 商店的游戏玩家的一项承诺。让游戏在掌机上出色运行,需要相比在 PC 桌面环境中运行时多考虑一些因素。开发者应考虑满足以下五条准则,以确保他们的游戏能够针对掌机上的游玩做到最佳配置。 满足全部准则的游戏会被标记为 Handheld Optimized。其他游戏可能被标记为: * Mostly Compatible:你的游戏可运行,但可能需要一些手动调整 * Unsupported:你的游戏未满足部分或全部掌机准则 * Unknown:尚未测试 ## 准则 1:默认值就能用 掌机设备上的默认设置必须允许完整访问游戏内容,玩家无需修改任何游戏内的显示、性能或输入设置,便可仅使用手柄在掌机上顺畅运行游戏。 **玩家期望**\ 游戏安装到掌机设备后必须开箱即用。玩家不应该需要去找某个菜单、调整一些游戏内设置才能让游戏进入掌机模式。仅使用手柄,他们就能浏览游戏的所有元素。 **测试步骤** 1. 启动游戏。 2. 使用内置手柄浏览并玩通游戏的所有区域,包括但不限于: * 游戏启动器(如支持) * 所有游戏模式 * 所有菜单、子菜单与功能 * 可下载内容 3. 确认无需修改游戏内的显示、性能或输入设置就可以进行游戏,并且仅使用手柄就可以完整浏览游戏。 **期望结果**\ 无需修改游戏内的显示、性能或输入设置就可以进行游戏。游戏的所有区域都完全支持内置手柄,包括游戏启动器(如支持)、所有游戏模式、菜单以及可下载内容。 ## 准则 2:图标与提示 游戏中的图标与游戏内警告应针对该设备准确无误,不得误导玩家。除非鼠标和键盘是当前的输入方式,否则必须隐藏其图标。游戏不应向用户展示不准确的信息,警告说该游戏设备不受支持。 **玩家期望**\ 诸如图标之类的屏幕提示帮助玩家理解如何浏览与进行游戏。不出现任何暗示掌机原生不支持的输入方式的指示,以免造成困惑。 **测试步骤** 1. 启动游戏。 2. 浏览游戏的所有区域,包括但不限于: * 游戏启动器(如支持) * 所有游戏模式 * 所有菜单、子菜单与功能 * 可下载内容 3. 找出显示手柄图标的所有位置。 **期望结果**\ 屏幕提示清晰、易懂,并准确地代表游戏所需的输入方式。 ## 准则 3:文本输入 当需要文本输入时,游戏必须自动提供屏幕键盘或对手柄友好的自定义文本输入方式。 **玩家期望**\ 仅使用手柄进行输入时自然顺畅,毫无摩擦。 **测试步骤** 1. 启动游戏。 2. 浏览游戏的所有区域,包括但不限于: * 游戏启动器(如支持) * 所有游戏模式 * 所有菜单、子菜单与功能 * 可下载内容 3. 找出所有需要文本输入的位置。 **期望结果**\ 在任何需要文本输入的地方,游戏都会提供屏幕键盘或对手柄友好的自定义文本输入方式。 ## 准则 4:UI 可读性 游戏中的关键文本以及可供用户操作的符号,必须在 12 英寸距离外仍可读。不同尺寸的屏幕有不同的要求: * 如果屏幕分辨率为 1280x720(720p),最小字号高度不应低于 9 像素。建议游戏使用至少 12 像素高度的字号。 * 如果屏幕分辨率为 1920x1080(1080p),最小字号高度不应低于 14 像素。建议游戏使用至少 18 像素高度的字号。 **玩家期望**\ 在以游戏距离握持时,关键的游戏内文本与可操作符号在小屏幕上均可读。 **必备的游戏内 UI 元素**\ 以下游戏内元素是可读性优化的必备项,会影响掌机兼容性评级: * 所有菜单选项与说明 * HUD(平视显示)指示 * 游戏内帮助与屏幕教程文本 * 物品与物品栏标签 * 任务与目标描述 * 对话与字幕文本 * 设置与配置菜单 **可选的游戏内 UI 元素**\ 以下游戏内元素建议进行可读性优化,但视为可选项,不会影响掌机兼容性评级: * 风味文本以及可选的背景故事条目 * 概览列表文本,前提是存在可读性更佳的详细下钻视图 * 处于未聚焦、未选中状态但可获得焦点后拥有更高可读性的 UI 文本 * 制作人员名单与致谢 * 非关键的工具提示 * 补充现有 UI 元素的文本(例如生命条文本、雷达信号说明等) * 装饰性 UI 元素 * 非交互场景中的背景文本 * 出现在物体贴图上的装饰性文本(例如路牌、物品品牌、海报、广告牌等) * 游戏内聊天(适用于多人游戏) **测量文本大小**\ 测量字号的一种方法是使用 Microsoft Paint。截取你想测量的文本图片,并将其导入 Microsoft Paint。 下图展示了被测量的内容: Measuring Font Size **测试步骤** 1. 启动作品。 2. 浏览游戏的所有区域,包括但不限于: * 游戏启动器(如支持) * 所有游戏模式 * 所有菜单、子菜单与功能 * 可下载内容 3. 在游戏中的多个位置截取截图。 4. 将截图导入 Microsoft Paint 应用,并测量最小字号。 5. 确认文本在 12 英寸距离外可读。 6. 如果默认屏幕分辨率为 1280x720(720p),确认最小字号高度不低于 9 像素。 7. 如果默认屏幕分辨率为 1980x1080(1080p),确认最小字号高度不低于 14 像素。 **期望结果**\ 关键的游戏内文本在 12 英寸距离外可读,且在 1280x720 分辨率下最小字号高度不低于 9 像素,在 1920x1080 分辨率下不低于 14 像素。 ## 准则 5:受支持的显示 游戏必须以全屏模式启动,并以掌机所支持的分辨率运行。建议游戏以掌机的原生分辨率运行。 **玩家期望**\ 游戏充分利用屏幕空间提供优秀的体验。游戏不出现严重的黑边(letterbox),也不会以扭曲游玩效果的宽高比进行渲染。 **测试步骤** 1. 确定掌机设备支持的所有分辨率。 2. 启动作品。 3. 浏览游戏的所有区域,包括但不限于: * 游戏启动器(如支持) * 所有游戏模式 * 所有菜单、子菜单与功能 * 可下载内容 4. 确认游戏以全屏模式启动,并以掌机所支持的分辨率运行。 **期望结果**\ 游戏必须以全屏模式启动,并以掌机所支持的分辨率运行。 ## 其他注意事项 有关详细的技术指导,请参见[掌机开发者指南](/build/gdk-and-engines/handheld/handheld-guidance)。 ## Related topics - [PC 和移动游戏的 XBOX 要求测试用例](/zh-CN/publishing/certification/pc-policy-tests.md) - [Handheld Compatibility 计划准则](/zh-CN/build/gdk-and-engines/handheld/handheld-guidance.md) - [PC 最常见的失败测试用例](/zh-CN/publishing/certification/pc-top-failing.md) - [Beta 与 XBOX Game Preview 游戏的认证](/zh-CN/publishing/certification/cert-beta-game-preview.md) - [认证分步指南](/zh-CN/publishing/game-publishing/concepts/certification/certification-guide.md)