进行电视安全区调试

避免 UI 元素过于靠近电视屏幕边缘

Windows
MacOS
Linux

在开发虚幻引擎4(UE4)项目时须注意,UI元素和文本不能过于靠近屏幕边缘,以免这些元素出现扭曲失真。为避免出现类似情况,引擎中加入了电视安全区调试工具。该文档说明如何在 UE4 项目中使用此工具。

什么是电视安全区

电视安全区或安全域是电视生产中用于描述电视画面区域的术语,确保绝大多数电视观众能够清楚地看到播放内容。总而言之,电视节目最重要的内容将被放置在该区域内,确保在各种电视机上播放时不会出现失真。

您可以在维基百科页面中查阅有关电视安全区和安全域的更多内容:电视安全区 .

标题安全区(Title Safe Zone)和动作安全区(Action Safe Zone)的区别

UE4 有两种不同类型的电视安全区:标题安全区(Title Safe Zone)和动作安全区(Action Safe Zone)。

  • T标题安全区 - 标题安全区可确保UI或文本在查看时不会出现截断或失真。

  • T动作安全区 - 动作安全区可确保角色或敌人移动时身体部分不会出屏。

动作安全区之外的区域在以过扫描显示时可能被裁掉,而动作安全区和标题安全区之间的区域可能被裁掉一部分。部分动作(如其他角色或敌人)发生在该区域中是可以接受的。在许多平台上,动作安全区和标题安全区的尺寸一致。

电视安全区命令

以下部分将介绍电视安全区的命令,以及在虚幻引擎 4(UE4)项目中启用并使用电视安全区调试的两种不同方式。

可在 UE4 控制台中直接输入以下电视安全区命令。

命令名

数值

描述

r.DebugSafeZone.Mode

0

显示所有覆层。

r.DebugSafeZone.Mode

1

启用标题安全区。

r.DebugSafeZone.Mode

2

启用动作安全区。

r.DebugSafeZone.OverlayAlpha

0 到 1

控制调试可视覆层的透明度(默认为 0.3)

r.DebugSafeZone.TitleRatio

0 到 1

控制 FDisplayMetrics 中返回的标题安全区边缘(默认为 0.9)。

r.DebugActionZone.ActionRatio

0 到 1

控制 FDisplayMetrics 中返回的动作安全区边缘(默认为 0.9)。

也可将电视安全区命令放置在项目 [SystemSettings] 部分下的 DefaultEngine.ini 文件中。

SZ_Default_Engine_INI.png

启用标题安全区调试预览

为正确显示安全区的比例,您 必须窗口全屏全屏 状态下运行项目。如果不这么做,安全区将无法正确显示,或显示尺寸小于预期。

以下部分将说明如何在调试预览模式下启用安全区。

  1. 前往 主工具栏Play 部分,点击旁边的白色小箭头变更播放模式选项。

    SZ_Play_Mode.png

  2. 打开 Play Modes 菜单后,选择 New Editor Window (PIE) 选项,让游戏在新的独立窗口中运行。

    SZ_NEW_PIE.png

  3. 按下 Play 按钮在游戏自身的窗口中运行,然后将窗口放大为全屏。

    SZ_Fullscreen_Window.png

  4. 接着,按下波浪符(~)键打开虚幻控制台,输入`r.DebugSafeZone.Mode 1`,然后按下 **Enter** 键应用。

    SZ_Enter_Command.png

  5. 现在,您应该能看到整个播放窗口周边出现了略微透明的红色边界(如下图所示)。

    点击查看全图。

调整安全区和动作区的大小

在虚幻控制台中输入以下命令,调整安全区或动作区的大小。

命令名

数值

描述

r.DebugSafeZone.TitleRatio

范围 0 到 1

控制 FDisplayMetrics 中返回的安全区边缘(默认为 0.9)。

r.DebugActionZone.ActionRatio

范围 0 到 1

控制 FDisplayMetrics 中返回的动作区边缘(默认为 0.9)。

无法同时启用安全区和动作区。如要查看另一个区,必须先禁用当前正在查看的区,然后再启用需要查看的区。

下图中,命令 r.DebugActionZone.ActionRatio 将动作区的大小从 0.99 缩小到 0.1。

拖动滑条可显示调整安全区大小的效果。

调整安全区和动作区覆层的透明度

在虚幻控制台中输入以下命令,增加/减少安全区和动作区的不透明度。

命令名

数值

描述

r.DebugSafeZone.OverlayAlpha

0 到 1

控制安全区和动作区覆层的不透明度(默认为 0.3)。

在下图中可了解到 r.DebugSafeZone.OverlayAlpha 数值从 1.0 设为 0.1 后安全区和动作区覆层不透明度的变化。

拖动滑条可显示调整 Alpha 覆层不透明度的效果。

电视安全区疑难排解

以下部分介绍需要注意的一些信息,确保正确使用电视安全区。

  • 现在安全区根据全屏尺寸进行定义(API 并非针对非主机平台设计),不会直接返回比例在窗口模式中使用。此项在未来的版本中可能会进行修改,但当下需要在 窗口全屏全屏 下运行才能获得正确比例。

  • 当前 UI 还无法在运行时处理此修改,因此在运行中通过控制台变更标题比例/动作比例时需要切换游戏模式方可显示变化(如:从前端到游戏中,或相反,或再次"open FrontEndScene")。

  • 在 PS4 上使用此工具时只需要第一个命令 r.DebugSafeZone.Mode 1,因为可在 PS4 操作系统菜单中选择系统设置决定安全区数值。

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback